Microsoft/bcquality
1
0
Fork 0
mirror of https://github.com/microsoft/BCQuality.git synced 2026-10-05 14:46:55 +01:00
Code Issues Projects Releases Packages Wiki Activity Actions 4
bcquality/community/knowledge/agents/reapply-resource-instructions-on-upgrade.md
Jesper Schulz-Wedde 2b5550c346
Some checks failed
Validate knowledge index / validate-index (push) Has been cancelled
Details
Validate AL review fixtures / validate-review-fixtures (push) Has been cancelled
Details
Validate frontmatter and structure / validate (push) Has been cancelled
Details
Improve partner onboarding and documentation navigation (#174) 
Lead with a complete plugin quick start and add task-oriented usage, troubleshooting, customization, and contribution guides. Preserve the broader plugin framing, correct conflicting contract guidance, support Agents folder reviews, and align repository validation. Convert existing sample references to clickable links without changing knowledge rules.

Co-authored-by: Jesper Schulz-Wedde <jesper.schulzwedde@microsoft.com>
Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
2026-09-09 17:31:03 +02:00

1.2 KiB
Raw Blame History

bc-version domain keywords technologies countries application-area
27..
agents
upgrade
setinstructions
navapp-getresourceastext
existing-instances
upgrade-tag
al
w1
all

Reapply resource instructions to existing agent instances on upgrade

Description

Static instructions stored as an app resource are copied onto an instance only when you call SetInstructions. Shipping a new Instructions.txt in version 2.0 does not update agents created under 1.0. Models change the resource and assume running instances pick it up.

Best Practice

In the upgrade codeunit, find existing instances of your metadata provider and call SetInstructions again with NavApp.GetResourceAsText. Guard with an upgrade tag so the rewrite runs once per version that changes the file.

See sample: reapply-resource-instructions-on-upgrade.good.al.

Anti Pattern

Editing only the resource file, or calling SetInstructions solely from the first-time setup path. Detection signal: instruction resource in resourceFolders with no upgrade procedure that re-applies it.

See sample: reapply-resource-instructions-on-upgrade.bad.al.