b6da405376
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: Copilot App <223556219+Copilot@users.noreply.github.com>
1.3 KiB
| bc-version | domain | keywords | technologies | countries | application-area | |||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
agents |
|
|
|
|
The default agent profile must be an AL profile in the app
Description
IAgentFactory.GetDefaultProfile assigns the Role Center and page customizations the agent UI-navigates. A profile built only in the client, or page personalization that was never exported, is absent after deploy. Agent.PopulateDefaultProfile still needs a profile ID that exists in the current module.
Best Practice
Ship a profile object (and page customizations) in the app. In GetDefaultProfile, call Agent.PopulateDefaultProfile with that profile ID and NavApp.GetCurrentModuleInfo. Include UI-exported customizations as AL.
See sample: get-default-profile-lives-in-the-app.good.al.
Anti Pattern
Setting TempAllProfile."Profile ID" to a client-only profile, or skipping GetDefaultProfile. Detection signal: factory default profile ID with no matching profile object in the app.
See sample: get-default-profile-lives-in-the-app.bad.al.
See also
agent-profile-narrows-visible-ui.md explains which UI the app-owned profile should expose.