Microsoft/bcquality
1
0
Fork 0
mirror of https://github.com/microsoft/BCQuality.git synced 2026-10-06 07:06:54 +01:00
Code Issues Projects Releases Packages Wiki Activity Actions 4
bcquality/community/knowledge/agents/show-can-create-agent-does-not-block-code-create.md
Stefano Demiliani 2d0913568e feat(community/agents): add AL agent quality guidance 
- add 20 agent knowledge rules with good and bad AL samples
- clarify setup dialog shape, temporary persistence, permissions, profiles, instructions, capability registration, and interface wiring
- add the community-owned AL agents review skill
- make review fixture discovery layer-aware with custom, community, and Microsoft precedence
- document layer-aware evaluation behavior
2026-08-23 22:10:10 +02:00

1.3 KiB
Raw Blame History

bc-version domain keywords technologies countries application-area
28..
agents
showcancreateagent
agent-discovery
agent-create
administrator
agent-configuration-rights
al
w1
all

ShowCanCreateAgent only hides UI create, not programmatic create

Description

IAgentFactory.ShowCanCreateAgent controls whether the type appears in the in-client create UI. Returning false does not stop Agent.Create from AL. From 28.1, non-admins can discover extension agents unless this method (and agent configuration rights) restrict them. Models treat a false return as a hard create lock.

Best Practice

Use ShowCanCreateAgent to decide discovery. If only agent administrators should see the type, return Agent System Permissions.CurrentUserHasCanManageAllAgentsPermission. Enforce extra policy inside your own create API. Never assume UI hiding blocks code.

See sample: show-can-create-agent-does-not-block-code-create.good.al.

Anti Pattern

Returning exit(false) from ShowCanCreateAgent and then documenting that instances cannot be created, while page actions or other apps still call Agent.Create. Detection signal: ShowCanCreateAgent always false with no matching guard on programmatic create.

See sample: show-can-create-agent-does-not-block-code-create.bad.al.