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/agent-setup-page-is-configuration-dialog.md
Stefano Demiliani e98fb8ec38 Address agent review feedback
2026-08-27 16:33:40 +02:00

1.3 KiB
Raw Blame History

bc-version domain keywords technologies countries application-area
27..
agents
configurationdialog
agent-setup-part
setup-page
pagetype
system-actions
al
w1
all

Agent setup pages use ConfigurationDialog and the Agent Setup Part

Description

Instance setup is not a Card or StandardDialog. The toolkit expects PageType = ConfigurationDialog so OK and Cancel are system actions, plus the built-in Agent Setup Part for name, display name, state, and access. A Card with custom fields only drops those shared controls and the AI-use notices the part carries.

Best Practice

Declare PageType = ConfigurationDialog, host part(...; "Agent Setup Part"), and put agent-specific fields in another group. Keep system OK/Cancel. Use a temporary source record and defer persistence until Update, as described in agent-setup-source-table-is-temporary.md. Following Microsoft's agent setup samples, set Extensible = false.

See sample: agent-setup-page-is-configuration-dialog.good.al.

Anti Pattern

A Card or StandardDialog setup page with no Agent Setup Part. Detection signal: setup page ID from IAgentFactory / IAgentMetadata whose page is not ConfigurationDialog or has no Agent Setup Part.

See sample: agent-setup-page-is-configuration-dialog.bad.al.