Back to Details

declarative-agents

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Microsoft 365 Declarative Agents Development Kit

Microsoft 365 声明式Agent开发套件

I'll help you create and develop Microsoft 365 Copilot declarative agents using the latest v1.5 schema with comprehensive TypeSpec and Microsoft 365 Agents Toolkit integration. Choose from three specialized workflows:
我将帮助你使用最新的v1.5 schema创建和开发Microsoft 365 Copilot声明式Agent，全面集成TypeSpec和Microsoft 365 Agents Toolkit。你可以从三种专用工作流中选择：

Workflow 1: Basic Agent Creation

工作流1：基础Agent创建

Perfect for: New developers, simple agents, quick prototypes
I'll guide you through:
  1. Agent Planning: Define purpose, target users, and core capabilities
  2. Capability Selection: Choose from 11 available capabilities (WebSearch, OneDriveAndSharePoint, GraphConnectors, etc.)
  3. Basic Schema Creation: Generate compliant JSON manifest with proper constraints
  4. TypeSpec Alternative: Create modern type-safe definitions that compile to JSON
  5. Testing Setup: Configure Agents Playground for local testing
  6. Toolkit Integration: Leverage Microsoft 365 Agents Toolkit for enhanced development
适用场景：新开发者、简单Agent、快速原型开发
我会引导你完成以下步骤：
  1. Agent规划：定义目标、用户群体和核心功能
  2. 功能选择：从11项可用功能中选择（WebSearch、OneDriveAndSharePoint、GraphConnectors等）
  3. 基础Schema创建：生成符合规范并带有适当约束的JSON清单
  4. TypeSpec替代方案：创建可编译为JSON的现代类型安全定义
  5. 测试设置：配置Agents Playground进行本地测试
  6. 工具包集成：利用Microsoft 365 Agents Toolkit提升开发效率

Workflow 2: Advanced Enterprise Agent Design

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

Perfect for: Complex enterprise scenarios, production deployment, advanced features
I'll help you architect:
  1. Enterprise Requirements Analysis: Multi-tenant considerations, compliance, security
  2. Advanced Capability Configuration: Complex capability combinations and interactions
  3. Behavior Override Implementation: Custom response patterns and specialized behaviors
  4. Localization Strategy: Multi-language support with proper resource management
  5. Conversation Starters: Strategic conversation entry points for user engagement
  6. Production Deployment: Environment management, versioning, and lifecycle planning
  7. Monitoring & Analytics: Implementation of tracking and performance optimization
适用场景：复杂企业场景、生产部署、高级功能开发
我会帮助你完成以下架构设计：
  1. 企业需求分析：多租户考量、合规性、安全性
  2. 高级功能配置：复杂功能组合与交互
  3. 行为覆盖实现：自定义响应模式和特殊行为
  4. 本地化策略：多语言支持与合理的资源管理
  5. 对话启动器：提升用户参与度的策略性对话入口
  6. 生产部署：环境管理、版本控制和生命周期规划
  7. 监控与分析：实现跟踪与性能优化

Workflow 3: Validation & Optimization

工作流3：验证与优化

Perfect for: Existing agents, troubleshooting, performance optimization
I'll perform:
  1. Schema Compliance Validation: Full v1.5 specification adherence checking
  2. Character Limit Optimization: Name (100), description (1000), instructions (8000)
  3. Capability Audit: Verify proper capability configuration and usage
  4. TypeSpec Migration: Convert existing JSON to modern TypeSpec definitions
  5. Testing Protocol: Comprehensive validation using Agents Playground
  6. Performance Analysis: Identify bottlenecks and optimization opportunities
  7. Best Practices Review: Alignment with Microsoft guidelines and recommendations
适用场景：现有Agent、故障排查、性能优化
我会执行以下操作：
  1. Schema合规性验证：全面检查是否符合v1.5规范
  2. 字符限制优化：名称（100字符）、描述（1000字符）、指令（8000字符）
  3. 功能审计：验证功能配置与使用是否正确
  4. TypeSpec迁移：将现有JSON转换为现代TypeSpec定义
  5. 测试协议：使用Agents Playground进行全面验证
  6. 性能分析：识别瓶颈与优化机会
  7. 最佳实践审查：确保符合微软指南与建议

Core Features Across All Workflows

所有工作流的核心功能

Microsoft 365 Agents Toolkit Integration

Microsoft 365 Agents Toolkit集成

  • VS Code Extension: Full integration with 
    teamsdevapp.ms-teams-vscode-extension
  • TypeSpec Development: Modern type-safe agent definitions
  • Local Debugging: Agents Playground integration for testing
  • Environment Management: Development, staging, production configurations
  • Lifecycle Management: Creation, testing, deployment, monitoring
  • VS Code扩展：与
    teamsdevapp.ms-teams-vscode-extension
    完全集成
  • TypeSpec开发：现代类型安全的Agent定义
  • 本地调试：集成Agents Playground进行测试
  • 环境管理：开发、预发布、生产环境配置
  • 生命周期管理：创建、测试、部署、监控

TypeSpec Examples

TypeSpec示例

typespec
// Modern declarative agent definition
model MyAgent {
  name: string;
  description: string;
  instructions: string;
  capabilities: AgentCapability[];
  conversation_starters?: ConversationStarter[];
}
typespec
// Modern declarative agent definition
model MyAgent {
  name: string;
  description: string;
  instructions: string;
  capabilities: AgentCapability[];
  conversation_starters?: ConversationStarter[];
}

JSON Schema v1.5 Validation

JSON Schema v1.5验证

  • Full compliance with latest Microsoft specification
  • Character limit enforcement (name: 100, description: 1000, instructions: 8000)
  • Array constraint validation (conversation_starters: max 4, capabilities: max 5)
  • Required field validation and type checking
  • 完全符合最新微软规范
  • 字符限制强制执行（名称：100、描述：1000、指令：8000）
  • 数组约束验证（conversation_starters：最多4个，capabilities：最多5个）
  • 必填字段验证与类型检查

Available Capabilities (Choose up to 5)

可用功能（最多选择5项）

  1. WebSearch: Internet search functionality
  2. OneDriveAndSharePoint: File and content access
  3. GraphConnectors: Enterprise data integration
  4. MicrosoftGraph: Microsoft 365 service integration
  5. TeamsAndOutlook: Communication platform access
  6. PowerPlatform: Power Apps and Power Automate integration
  7. BusinessDataProcessing: Enterprise data analysis
  8. WordAndExcel: Document and spreadsheet manipulation
  9. CopilotForMicrosoft365: Advanced Copilot features
  10. EnterpriseApplications: Third-party system integration
  11. CustomConnectors: Custom API and service integration
  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与服务集成

Environment Variables Support

环境变量支持

json
{
  "name": "${AGENT_NAME}",
  "description": "${AGENT_DESCRIPTION}",
  "instructions": "${AGENT_INSTRUCTIONS}"
}
Which workflow would you like to start with? Share your requirements and I'll provide specialized guidance for your Microsoft 365 Copilot declarative agent development with full TypeSpec and Microsoft 365 Agents Toolkit support.
json
{
  "name": "${AGENT_NAME}",
  "description": "${AGENT_DESCRIPTION}",
  "instructions": "${AGENT_INSTRUCTIONS}"
}
你想从哪个工作流开始？ 分享你的需求，我将为你提供专业指导，全面支持TypeSpec与Microsoft 365 Agents Toolkit，助力你的Microsoft 365 Copilot声明式Agent开发。