#137 Add community guidance and review support for Business Central agents
Business Central agent developers gain 20 community-authored guidance rules covering agent registration, permissions, profiles, instructions, session handling, and lifecycle management, with good and bad code examples for each rule.
- 65files
- 61AL files
- 0objects
Pull request · merged into main on 2026-09-02 by demiliani · 65 files (+1555 -36), 61 AL · feature · tier official · reviewed (checked by Opus)
What changed
- 20 new community guidance rules for agent SDK implementations
- Each rule includes documentation and contrasting AL code examples
- Coverage spans registration, permissions, profiles, setup persistence, instructions, session behavior, and API design
- New standalone al-agents-review action skill for automated review
- Rules address least-privilege access, secure storage, lifecycle management, and input validation
AL objects touched
community/knowledge/agents/agent-permissions-intersect-with-assigner.bad.al: added, not in the BC? snapshot yetcommunity/knowledge/agents/agent-permissions-intersect-with-assigner.good.al: added, not in the BC? snapshot yetcommunity/knowledge/agents/agent-permissions-intersect-with-assigner.md: added, not in the BC? snapshot yetcommunity/knowledge/agents/agent-profile-narrows-visible-ui.bad.al: added, not in the BC? snapshot yetcommunity/knowledge/agents/agent-profile-narrows-visible-ui.good.al: added, not in the BC? snapshot yetcommunity/knowledge/agents/agent-profile-narrows-visible-ui.md: added, not in the BC? snapshot yetcommunity/knowledge/agents/agent-setup-page-is-configuration-dialog.bad.al: added, not in the BC? snapshot yetcommunity/knowledge/agents/agent-setup-page-is-configuration-dialog.good.al: added, not in the BC? snapshot yetcommunity/knowledge/agents/agent-setup-page-is-configuration-dialog.md: added, not in the BC? snapshot yetcommunity/knowledge/agents/agent-setup-source-table-is-temporary.bad.al: added, not in the BC? snapshot yetcommunity/knowledge/agents/agent-setup-source-table-is-temporary.good.al: added, not in the BC? snapshot yetcommunity/knowledge/agents/agent-setup-source-table-is-temporary.md: added, not in the BC? snapshot yetcommunity/knowledge/agents/agent-setup-table-keyed-by-user-security-id.bad.al: added, not in the BC? snapshot yetcommunity/knowledge/agents/agent-setup-table-keyed-by-user-security-id.good.al: added, not in the BC? snapshot yetcommunity/knowledge/agents/agent-setup-table-keyed-by-user-security-id.md: added, not in the BC? snapshot yetcommunity/knowledge/agents/analyze-message-error-stops-warning-forces-review.bad.al: added, not in the BC? snapshot yetcommunity/knowledge/agents/analyze-message-error-stops-warning-forces-review.good.al: added, not in the BC? snapshot yetcommunity/knowledge/agents/analyze-message-error-stops-warning-forces-review.md: added, not in the BC? snapshot yetcommunity/knowledge/agents/bind-agent-subscribers-only-in-agent-session.bad.al: added, not in the BC? snapshot yetcommunity/knowledge/agents/bind-agent-subscribers-only-in-agent-session.good.al: added, not in the BC? snapshot yetcommunity/knowledge/agents/bind-agent-subscribers-only-in-agent-session.md: added, not in the BC? snapshot yetcommunity/knowledge/agents/cross-app-agent-calls-need-your-public-api.bad.al: added, not in the BC? snapshot yetcommunity/knowledge/agents/cross-app-agent-calls-need-your-public-api.good.al: added, not in the BC? snapshot yetcommunity/knowledge/agents/cross-app-agent-calls-need-your-public-api.md: added, not in the BC? snapshot yetcommunity/knowledge/agents/do-not-create-agents-in-install-upgrade-or-background.bad.al: added, not in the BC? snapshot yetcommunity/knowledge/agents/do-not-create-agents-in-install-upgrade-or-background.good.al: added, not in the BC? snapshot yetcommunity/knowledge/agents/do-not-create-agents-in-install-upgrade-or-background.md: added, not in the BC? snapshot yetcommunity/knowledge/agents/get-default-access-controls-least-privilege.bad.al: added, not in the BC? snapshot yetcommunity/knowledge/agents/get-default-access-controls-least-privilege.good.al: added, not in the BC? snapshot yetcommunity/knowledge/agents/get-default-access-controls-least-privilege.md: added, not in the BC? snapshot yetcommunity/knowledge/agents/get-default-profile-lives-in-the-app.bad.al: added, not in the BC? snapshot yetcommunity/knowledge/agents/get-default-profile-lives-in-the-app.good.al: added, not in the BC? snapshot yetcommunity/knowledge/agents/get-default-profile-lives-in-the-app.md: added, not in the BC? snapshot yetcommunity/knowledge/agents/instruction-structure-is-role-rules-steps.bad.al: added, not in the BC? snapshot yetcommunity/knowledge/agents/instruction-structure-is-role-rules-steps.good.al: added, not in the BC? snapshot yetcommunity/knowledge/agents/instruction-structure-is-role-rules-steps.md: added, not in the BC? snapshot yetcommunity/knowledge/agents/instructions-describe-work-not-tool-ids.bad.al: added, not in the BC? snapshot yetcommunity/knowledge/agents/instructions-describe-work-not-tool-ids.good.al: added, not in the BC? snapshot yetcommunity/knowledge/agents/instructions-describe-work-not-tool-ids.md: added, not in the BC? snapshot yetcommunity/knowledge/agents/reapply-resource-instructions-on-upgrade.bad.al: added, not in the BC? snapshot yetcommunity/knowledge/agents/reapply-resource-instructions-on-upgrade.good.al: added, not in the BC? snapshot yetcommunity/knowledge/agents/reapply-resource-instructions-on-upgrade.md: added, not in the BC? snapshot yetcommunity/knowledge/agents/register-copilot-capability-for-the-agent.bad.al: added, not in the BC? snapshot yetcommunity/knowledge/agents/register-copilot-capability-for-the-agent.good.al: added, not in the BC? snapshot yetcommunity/knowledge/agents/register-copilot-capability-for-the-agent.md: added, not in the BC? snapshot yetcommunity/knowledge/agents/set-instructions-as-secrettext.bad.al: added, not in the BC? snapshot yetcommunity/knowledge/agents/set-instructions-as-secrettext.good.al: added, not in the BC? snapshot yetcommunity/knowledge/agents/set-instructions-as-secrettext.md: added, not in the BC? snapshot yetcommunity/knowledge/agents/show-can-create-agent-does-not-block-code-create.bad.al: added, not in the BC? snapshot yetcommunity/knowledge/agents/show-can-create-agent-does-not-block-code-create.good.al: added, not in the BC? snapshot yetcommunity/knowledge/agents/show-can-create-agent-does-not-block-code-create.md: added, not in the BC? snapshot yetcommunity/knowledge/agents/skip-incoming-review-only-for-trusted-input.bad.al: added, not in the BC? snapshot yetcommunity/knowledge/agents/skip-incoming-review-only-for-trusted-input.good.al: added, not in the BC? snapshot yetcommunity/knowledge/agents/skip-incoming-review-only-for-trusted-input.md: added, not in the BC? snapshot yetcommunity/knowledge/agents/use-documented-instruction-keywords.bad.al: added, not in the BC? snapshot yetcommunity/knowledge/agents/use-documented-instruction-keywords.good.al: added, not in the BC? snapshot yetcommunity/knowledge/agents/use-documented-instruction-keywords.md: added, not in the BC? snapshot yetcommunity/knowledge/agents/wire-all-three-agent-interfaces.bad.al: added, not in the BC? snapshot yetcommunity/knowledge/agents/wire-all-three-agent-interfaces.good.al: added, not in the BC? snapshot yetcommunity/knowledge/agents/wire-all-three-agent-interfaces.md: added, not in the BC? snapshot yetcommunity/skills/review/al-agents-review.md: added, not in the BC? snapshot yet
Context
- Systems: copilot, development
- From the description: “Adds a new community knowledge domain for reviewing Business Central Agent SDK implementations.”
Source: metadata of a merged pull request in microsoft/BCQuality (bcquality): title, labels, changed paths and counts, with a summary in our words. No source text and no description beyond one short quote (D10, D61).