mcpField
D
declarative-agents

declarative-agents

github.com/githubAgent 工作流40.5k8.7k 次安装今天更新
代码仓库

关于 declarative-agents

用于开发 Microsoft 365 Copilot 声明式 Agent 的技能，涵盖创建、企业级设计和验证。支持 TypeSpec 与 JSON Schema v1.5 工作流，并涉及 Microsoft 365 Agents Toolkit 和 Agents Playground。

主要功能

  1. 01指导创建基础 Agent
  2. 02支持企业级 Agent 设计
  3. 03验证 JSON Schema v1.5 合规性
  4. 04将 JSON 定义转换为 TypeSpec
  5. 05支持在 Agents Playground 测试
  6. 06集成 Microsoft 365 Agents Toolkit

适用场景

  1. 01制作声明式 Agent 原型
  2. 02设计用于部署的企业级 Agent
  3. 03验证或迁移现有 Agent

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/github/awesome-copilot --skill declarative-agents

安装后在 Claude Code 中输入/declarative-agents确认已加载。

详细介绍

Microsoft 365 声明式 Agent 开发工具包

我将帮助你使用最新的 v1.5 架构创建和开发 Microsoft 365 Copilot 声明式 Agent，并提供全面的 TypeSpec 和 Microsoft 365 Agents Toolkit 集成。可从三种专业工作流中选择：

工作流 1：基础 Agent 创建

非常适合：新开发者、简单 Agent、快速原型

我将指导你完成：

  1. Agent 规划：定义用途、目标用户和核心能力
  2. 能力选择：从 11 种可用能力中进行选择（WebSearch、OneDriveAndSharePoint、GraphConnectors 等）
  3. 基础架构创建：生成符合规范且约束正确的 JSON 清单
  4. TypeSpec 替代方案：创建可编译为 JSON 的现代类型安全定义
  5. 测试设置：配置 Agents Playground 以进行本地测试
  6. 工具包集成：利用 Microsoft 365 Agents Toolkit 增强开发

工作流 2：高级企业 Agent 设计

非常适合：复杂企业场景、生产部署、高级功能

我将帮助你设计架构：

  1. 企业需求分析：多租户考量、合规性、安全性
  2. 高级能力配置：复杂能力组合与交互
  3. 行为覆盖实现：自定义响应模式和专用行为
  4. 本地化策略：多语言支持与适当的资源管理
  5. 对话开场白：用于用户互动的战略性对话入口点
  6. 生产：环境管理、版本控制和生命周期规划
  7. 监控与分析：实施跟踪和性能优化

工作流 3：验证与优化

非常适合：现有 Agent、故障排除、性能优化

我将执行：

  1. 架构合规性验证：全面检查是否符合 v1.5 规范
  2. 字符限制优化：名称（100）、描述（1000）、指令（8000）
  3. 能力审计：验证能力配置和使用是否正确
  4. TypeSpec 迁移：将现有 JSON 转换为现代 TypeSpec 定义
  5. 测试协议：使用 Agents Playground 进行全面验证
  6. 性能分析：识别瓶颈和优化机会
  7. 最佳实践审查：与 Microsoft 指南和建议保持一致

所有工作流的核心功能

Microsoft 365 Agents Toolkit 集成
  • VS Code 扩展：与 teamsdevapp.ms-teams-vscode-extension 完全集成
  • TypeSpec 开发：现代类型安全 Agent 定义
  • 本地调试：Agents Playground 集成以进行测试
  • 环境管理：开发、预发布、生产配置
  • 生命周期管理：创建、测试、部署、监控
TypeSpec 示例
// Modern declarative agent definition
model MyAgent {
  name: string;
  description: string;
  instructions: string;
  capabilities: AgentCapability[];
  conversation_starters?: ConversationStarter[];
}
JSON Schema v1.5 验证
  • 完全符合最新 Microsoft 规范
  • 字符限制强制执行（名称：100，描述：1000，指令：8000）
  • 数组约束验证（conversation_starters：最多 4 个，capabilities：最多 5 个）
  • 必填字段验证和类型检查
可用能力（最多选择 5 个）
  1. WebSearch：互联网搜索功能
  2. OneDriveAndSharePoint：文件和内容访问
  3. GraphConnectors：企业数据集成
  4. MicrosoftGraph：Microsoft 365 服务集成
  5. TeamsAndOutlook：通信平台访问
  6. PowerPlatform：Power Apps 和 Power Automate 集成
  7. BusinessDataProcessing：企业数据分析
  8. WordAndExcel：文档和电子表格操作
  9. CopilotForMicrosoft365：高级 Copilot 功能
  10. EnterpriseApplications：第三方系统集成
  11. CustomConnectors：自定义 API 和服务集成
环境变量支持
{
  "name": "${AGENT_NAME}",
  "description": "${AGENT_DESCRIPTION}",
  "instructions": "${AGENT_INSTRUCTIONS}"
}

你想从哪个工作流开始？ 分享你的需求，我将为你的 Microsoft 365 Copilot 声明式 Agent 开发提供专业指导，并全程支持 TypeSpec 和 Microsoft 365 Agents Toolkit。

评论

支持 Markdown