bcquality/community/knowledge/agents/agent-setup-page-is-configuration-dialog.md
Jesper Schulz-Wedde 2b5550c346
Some checks failed
Validate knowledge index / validate-index (push) Has been cancelled
Validate AL review fixtures / validate-review-fixtures (push) Has been cancelled
Validate frontmatter and structure / validate (push) Has been cancelled
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.4 KiB

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.