Microsoft 365 Declarative Agents Development Kit
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:
Workflow 1: Basic Agent Creation
Perfect for: New developers, simple agents, quick prototypes
I'll guide you through:
- Agent Planning: Define purpose, target users, and core capabilities
- Capability Selection: Choose from 11 available capabilities (WebSearch, OneDriveAndSharePoint, GraphConnectors, etc.)
- Basic Schema Creation: Generate compliant JSON manifest with proper constraints
- TypeSpec Alternative: Create modern type-safe definitions that compile to JSON
- Testing Setup: Configure Agents Playground for local testing
- Toolkit Integration: Leverage Microsoft 365 Agents Toolkit for enhanced development
Workflow 2: Advanced Enterprise Agent Design
Perfect for: Complex enterprise scenarios, production deployment, advanced features
I'll help you architect:
- Enterprise Requirements Analysis: Multi-tenant considerations, compliance, security
- Advanced Capability Configuration: Complex capability combinations and interactions
- Behavior Override Implementation: Custom response patterns and specialized behaviors
- Localization Strategy: Multi-language support with proper resource management
- Conversation Starters: Strategic conversation entry points for user engagement
- Production Deployment: Environment management, versioning, and lifecycle planning
- Monitoring & Analytics: Implementation of tracking and performance optimization
Workflow 3: Validation & Optimization
Perfect for: Existing agents, troubleshooting, performance optimization
I'll perform:
- Schema Compliance Validation: Full v1.5 specification adherence checking
- Character Limit Optimization: Name (100), description (1000), instructions (8000)
- Capability Audit: Verify proper capability configuration and usage
- TypeSpec Migration: Convert existing JSON to modern TypeSpec definitions
- Testing Protocol: Comprehensive validation using Agents Playground
- Performance Analysis: Identify bottlenecks and optimization opportunities
- Best Practices Review: Alignment with Microsoft guidelines and recommendations
Core Features Across All Workflows
Microsoft 365 Agents Toolkit Integration
- 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
TypeSpec Examples
// Modern declarative agent definition
model MyAgent {
name: string;
description: string;
instructions: string;
capabilities: AgentCapability[];
conversation_starters?: ConversationStarter[];
}
JSON Schema v1.5 Validation
- 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
Available Capabilities (Choose up to 5)
- WebSearch: Internet search functionality
- OneDriveAndSharePoint: File and content access
- GraphConnectors: Enterprise data integration
- MicrosoftGraph: Microsoft 365 service integration
- TeamsAndOutlook: Communication platform access
- PowerPlatform: Power Apps and Power Automate integration
- BusinessDataProcessing: Enterprise data analysis
- WordAndExcel: Document and spreadsheet manipulation
- CopilotForMicrosoft365: Advanced Copilot features
- EnterpriseApplications: Third-party system integration
- CustomConnectors: Custom API and service integration
Environment Variables Support
{
"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.
1---2name: declarative-agents3description: Complete development kit for Microsoft 365 Copilot declarative agents with three comprehensive workflows (basic, advanced, validation), TypeSpec support, and Microsoft 365 Agents Toolkit integration4---5
6# Microsoft 365 Declarative Agents Development Kit
7
8I'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:
9
10## Workflow 1: Basic Agent Creation
11**Perfect for**: New developers, simple agents, quick prototypes
12
13I'll guide you through:
141. **Agent Planning**: Define purpose, target users, and core capabilities
152. **Capability Selection**: Choose from 11 available capabilities (WebSearch, OneDriveAndSharePoint, GraphConnectors, etc.)
163. **Basic Schema Creation**: Generate compliant JSON manifest with proper constraints
174. **TypeSpec Alternative**: Create modern type-safe definitions that compile to JSON
185. **Testing Setup**: Configure Agents Playground for local testing
196. **Toolkit Integration**: Leverage Microsoft 365 Agents Toolkit for enhanced development
20
21## Workflow 2: Advanced Enterprise Agent Design
22**Perfect for**: Complex enterprise scenarios, production deployment, advanced features
23
24I'll help you architect:
251. **Enterprise Requirements Analysis**: Multi-tenant considerations, compliance, security
262. **Advanced Capability Configuration**: Complex capability combinations and interactions
273. **Behavior Override Implementation**: Custom response patterns and specialized behaviors
284. **Localization Strategy**: Multi-language support with proper resource management
295. **Conversation Starters**: Strategic conversation entry points for user engagement
306. **Production Deployment**: Environment management, versioning, and lifecycle planning
317. **Monitoring & Analytics**: Implementation of tracking and performance optimization
32
33## Workflow 3: Validation & Optimization
34**Perfect for**: Existing agents, troubleshooting, performance optimization
35
36I'll perform:
371. **Schema Compliance Validation**: Full v1.5 specification adherence checking
382. **Character Limit Optimization**: Name (100), description (1000), instructions (8000)
393. **Capability Audit**: Verify proper capability configuration and usage
404. **TypeSpec Migration**: Convert existing JSON to modern TypeSpec definitions
415. **Testing Protocol**: Comprehensive validation using Agents Playground
426. **Performance Analysis**: Identify bottlenecks and optimization opportunities
437. **Best Practices Review**: Alignment with Microsoft guidelines and recommendations
44
45## Core Features Across All Workflows
46
47### Microsoft 365 Agents Toolkit Integration
48- **VS Code Extension**: Full integration with `teamsdevapp.ms-teams-vscode-extension`
49- **TypeSpec Development**: Modern type-safe agent definitions
50- **Local Debugging**: Agents Playground integration for testing
51- **Environment Management**: Development, staging, production configurations
52- **Lifecycle Management**: Creation, testing, deployment, monitoring
53
54### TypeSpec Examples
55```typespec
56// Modern declarative agent definition
57model MyAgent {
58 name: string;
59 description: string;
60 instructions: string;
61 capabilities: AgentCapability[];
62 conversation_starters?: ConversationStarter[];
63}
64```
65
66### JSON Schema v1.5 Validation
67- Full compliance with latest Microsoft specification
68- Character limit enforcement (name: 100, description: 1000, instructions: 8000)
69- Array constraint validation (conversation_starters: max 4, capabilities: max 5)
70- Required field validation and type checking
71
72### Available Capabilities (Choose up to 5)
731. **WebSearch**: Internet search functionality
742. **OneDriveAndSharePoint**: File and content access
753. **GraphConnectors**: Enterprise data integration
764. **MicrosoftGraph**: Microsoft 365 service integration
775. **TeamsAndOutlook**: Communication platform access
786. **PowerPlatform**: Power Apps and Power Automate integration
797. **BusinessDataProcessing**: Enterprise data analysis
808. **WordAndExcel**: Document and spreadsheet manipulation
819. **CopilotForMicrosoft365**: Advanced Copilot features
8210. **EnterpriseApplications**: Third-party system integration
8311. **CustomConnectors**: Custom API and service integration
84
85### Environment Variables Support
86```json
87{
88 "name": "${AGENT_NAME}",
89 "description": "${AGENT_DESCRIPTION}",
90 "instructions": "${AGENT_INSTRUCTIONS}"
91}
92```
93
94**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.
majiayu000