用途：在 Azure AI Foundry 服务端创建并同步基于提示词的智能体，使其可被调用、评估和管理。它不生成本地智能体代码或容器镜像，后者需使用 microsoft-foundry 技能的 create 子技能。
前提：需有已部署模型的 Foundry 项目、已认证的 Azure CLI（az），以及项目上的 Azure AI User 或更高角色。需收集项目终结点、订阅 ID、模型部署名称。
清单：JSON 数组，每项含 useCaseId（kebab-case，用于生成 {prefix}-{useCaseId} 名称）、description、baseInstruction（系统提示词）。常见路径 infra/foundry-agents.json、foundry-agents.json、.foundry/agents.json。
用法：运行 PowerShell 同步脚本，参数包括 SubscriptionId、ProjectEndpoint、ManifestPath、ModelName（默认 gpt-5-4）、AgentNamePrefix、ApiVersion（默认 2025-11-15-preview）。脚本用 az account get-access-token --resource https://ai.azure.com/ 获取令牌，对每个定义 POST 到 {projectEndpoint}/agents/{agentName}?api-version=2025-11-15-preview。也可用 bash 脚本配合托管标识，或通过 Bicep 的 deploymentScripts 在部署时自动同步，并以 deployFoundryAgents 参数控制开关。
验证：GET {projectEndpoint}/agents?api-version=2025-11-15-preview 列出智能体。REST 还支持获取与删除单个智能体。
限制：需正确角色与终结点；401 多为令牌过期或受众错误，403 为缺少角色，404 为终结点错误，模型未部署会报模型不存在。