skill-agent-toolkit
Build, configure, and integrate Business Central agents using the AI Development Toolkit and Agent SDK. Triggers on Agent SDK, Agent Metadata Provider, IAgentFactory, IAgentMetadata, IAgentTaskExecution, ConfigurationDialog, Agent Task Builder, Agent Session, Copilot Capability, agent instructions, or agent setup in BC context.
javiarmesto · 已有静态检查记录
安装与使用
运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。
npx skills add javiarmesto/ALDC-AL-Development-Collection --skill skill-agent-toolkit技能说明
name: skill-agent-toolkit description: Build, configure, and integrate Business Central agents using the AI Development Toolkit and Agent SDK. Triggers on Agent SDK, Agent Metadata Provider, IAgentFactory, IAgentMetadata, IAgentTaskExecution, ConfigurationDialog, Agent Task Builder, Agent Session, Copilot Capability, agent instructions, or agent setup in BC context.
BC Agent Toolkit Skill
Manual del Agent SDK: arquitectura, registro, las 3 interfaces, Setup Codeunit, ConfigurationDialog, Install/Upgrade, project structure. Para patterns de creación de tasks ver skill-agent-task-patterns. Para redactar instrucciones de agente ver skill-agent-instructions.
Reference oficial: https://learn.microsoft.com/en-us/dynamics365/business-central/dev-itpro/ai/ai-development-toolkit-overview
Two development paths
| Path | Use when | Result |
|---|---|---|
| Designer (No-Code) | Prototyping, testing | Agent via wizard with ${CLAUDE_PROJECT_DIR}/.claude/rules/profile/permissions |
| SDK (Pro-Code) | Production, extensions | Coded agent via AL interfaces, shipped in .app |
Both share the same runtime: an agent is a BC user that interacts with the UI via a logical UI API.
Project structure (Agent Template)
app/
├── .resources/Instructions/InstructionsV1.txt # Agent instructions (resource file)
├── Example/
│ ├── {Agent}CustomerCardExt.PageExt.al # Page extension (task trigger example)
│ ├── {Agent}PublicAPI.Codeunit.al # Public API (Access = Public)
│ └── {Agent}PublicAPIImpl.Codeunit.al # Implementation (Access = Internal)
├── Integration/
│ ├── {Agent}CopilotCapability.EnumExt.al
│ ├── {Agent}Install.Codeunit.al
│ └── {Agent}Upgrade.Codeunit.al
└── Setup/
├── {Agent}Setup.Codeunit.al # Centralized setup logic
├── {Agent}Setup.Page.al # ConfigurationDialog
├── {Agent}Setup.Table.al # PK = User Security ID
├── KPI/{Agent}KPI.{Table,Page}.al # CardPart for hover summary
├── Metadata/
│ ├── {Agent}Factory.Codeunit.al # IAgentFactory
│ ├── {Agent}Metadata.Codeunit.al # IAgentMetadata
│ └── {Agent}MetadataProvider.EnumExt.al
├── Permissions/{Agent}.permissionset.al # Includes D365 BASIC
├── Profile/
│ ├── {Agent}Profile.Profile.al
│ ├── {Agent}RoleCenter.Page.al
│ └── {Agent}*.PageCustomization.al
└── TaskExecution/
└── {Agent}TaskExecution.Codeunit.al # IAgentTaskExecution
Registration — 4 required objects
1. Copilot Capability EnumExt (feature switch)
enumextension 52100 "My Agent Copilot Capability" extends "Copilot Capability"
{
value(52100; "My Agent Capability") { Caption = 'My Agent'; }
}
2. Agent Metadata Provider EnumExt (links to the 3 interfaces)
enumextension 52101 "My Agent Metadata Provider" extends "Agent Metadata Provider"
{
value(52101; "My Agent")
{
Caption = 'My Agent';
Implementation = IAgentFactory = MyAgentFactory,
IAgentMetadata = MyAgentMetadata,
IAgentTaskExecution = MyAgentTaskExecution;
}
}
3. Install codeunit — Unregister + Register pattern
Always unregister before register to handle version updates cleanly. Re-install instructions for existing agent setup records.
codeunit 52101 "My Agent Install"
{
Subtype = Install;
Access = Internal;
InherentEntitlements = X;
InherentPermissions = X;
trigger OnInstallAppPerDatabase()
var
MyAgentSetup: Record "My Agent Setup";
begin
RegisterCapability();
if MyAgentSetup.FindSet() then
repeat
InstallAgentInstructions(MyAgentSetup);
until MyAgentSetup.Next() = 0;
end;
local procedure RegisterCapability()
var
CopilotCapability: Codeunit "Copilot Capability";
LearnMoreUrlTxt: Label 'https://docs.example.com', Locked = true;
begin
if CopilotCapability.IsCapabilityRegistered(Enum::"Copilot Capability"::"My Agent Capability") then
CopilotCapability.UnregisterCapability(Enum::"Copilot Capability"::"My Agent Capability");
CopilotCapability.RegisterCapability(
Enum::"Copilot Capability"::"My Agent Capability",
Enum::"Copilot Availability"::Preview,
"Copilot Billing Type"::"Microsoft Billed",
LearnMoreUrlTxt);
end;
}
4. Upgrade codeunit
Trigger OnUpgradePerDatabase — manage instruction updates per UpgradeTag.
The 3 core interfaces
IAgentFactory — creation & defaults
| Method | Purpose |
|---|---|
GetDefaultInitials(): Text[4] | Agent avatar initials |
GetFirstTimeSetupPageId(): Integer | Setup page on first creation |
ShowCanCreateAgent(): Boolean | Single-instance vs multi gate |
GetCopilotCapability(): Enum "Copilot Capability" | Feature switch reference |
GetDefaultProfile(var TempAllProfile: Record "All Profile" temporary) | Default UI profile |
GetDefaultAccessControls(var TempAccessControlBuffer: Record temporary) | Default permission template |
Delegate every method to the Setup Codeunit:
codeunit 52100 MyAgentFactory implements IAgentFactory
{
Access = Internal;
阅读完整来源 ↗