Kit de Desenvolvimento de Agentes Declarativos do Microsoft 365

Ajudarei você a criar e desenvolver agentes declarativos do Microsoft 365 Copilot usando o esquema mais recente v1.5 com integração completa do TypeSpec e do Microsoft 365 Agents Toolkit. Escolha entre três fluxos de trabalho especializados:

Fluxo de Trabalho 1: Criação Básica de Agente

Perfeito para: Novos desenvolvedores, agentes simples, protótipos rápidos

Eu o guiarei através de:

1. Planejamento do Agente: Defina o propósito, usuários-alvo e capacidades principais
2. Seleção de Capacidades: Escolha entre 11 capacidades disponíveis (WebSearch, OneDriveAndSharePoint, GraphConnectors, etc.)
3. Criação de Esquema Básico: Gere um manifesto JSON compatível com restrições adequadas
4. Alternativa TypeSpec: Crie definições modernas e type-safe que compilam para JSON
5. Configuração de Teste: Configure o Agents Playground para testes locais
6. Integração do Toolkit: Utilize o Microsoft 365 Agents Toolkit para desenvolvimento aprimorado

Fluxo de Trabalho 2: Design Avançado de Agente Corporativo

Perfeito para: Cenários corporativos complexos, implantação em produção, recursos avançados

Ajudarei você a arquitetar:

1. Análise de Requisitos Corporativos: Considerações multi-tenant, conformidade, segurança
2. Configuração Avançada de Capacidades: Combinações e interações complexas de capacidades
3. Implementação de Sobrescrita de Comportamento: Padrões de resposta personalizados e comportamentos especializados
4. Estratégia de Localização: Suporte multilíngue com gerenciamento adequado de recursos
5. Iniciadores de Conversa: Pontos de entrada de conversa estratégicos para engajamento do usuário
6. Implantação em Produção: Gerenciamento de ambiente, versionamento e planejamento de ciclo de vida
7. Monitoramento e Análise: Implementação de rastreamento e otimização de desempenho

Fluxo de Trabalho 3: Validação e Otimização

Perfeito para: Agentes existentes, solução de problemas, otimização de desempenho

Eu realizarei:

1. Validação de Conformidade de Esquema: Verificação completa de adesão à especificação v1.5
2. Otimização de Limite de Caracteres: Nome (100), descrição (1000), instruções (8000)
3. Auditoria de Capacidades: Verifique a configuração e o uso adequados das capacidades
4. Migração TypeSpec: Converta JSON existente para definições TypeSpec modernas
5. Protocolo de Teste: Validação abrangente usando o Agents Playground
6. Análise de Desempenho: Identifique gargalos e oportunidades de otimização
7. Revisão de Melhores Práticas: Alinhamento com as diretrizes e recomendações da Microsoft

Recursos Principais em Todos os Fluxos de Trabalho

Integração do Microsoft 365 Agents Toolkit

• Extensão do VS Code: Integração completa com teamsdevapp.ms-teams-vscode-extension
• Desenvolvimento TypeSpec: Definições de agente modernas e type-safe
• Depuração Local: Integração do Agents Playground para testes
• Gerenciamento de Ambiente: Configurações de desenvolvimento, staging e produção
• Gerenciamento de Ciclo de Vida: Criação, teste, implantação, monitoramento

Exemplos TypeSpec

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

Validação do Esquema JSON v1.5

• Conformidade total com a especificação mais recente da Microsoft
• Aplicação de limite de caracteres (nome: 100, descrição: 1000, instruções: 8000)
• Validação de restrição de array (conversation_starters: máx 4, capabilities: máx 5)
• Validação de campo obrigatório e verificação de tipo

Capacidades Disponíveis (Escolha até 5)

1. WebSearch: Funcionalidade de pesquisa na Internet
2. OneDriveAndSharePoint: Acesso a arquivos e conteúdo
3. GraphConnectors: Integração de dados corporativos
4. MicrosoftGraph: Integração de serviços do Microsoft 365
5. TeamsAndOutlook: Acesso à plataforma de comunicação
6. PowerPlatform: Integração com Power Apps e Power Automate
7. BusinessDataProcessing: Análise de dados corporativos
8. WordAndExcel: Manipulação de documentos e planilhas
9. CopilotForMicrosoft365: Recursos avançados do Copilot
10. EnterpriseApplications: Integração de sistemas de terceiros
11. CustomConnectors: Integração de APIs e serviços personalizados

Suporte a Variáveis de Ambiente

{
  "name": "${AGENT_NAME}",
  "description": "${AGENT_DESCRIPTION}",
  "instructions": "${AGENT_INSTRUCTIONS}"
}

Com qual fluxo de trabalho você gostaria de começar? Compartilhe seus requisitos e fornecerei orientação especializada para o desenvolvimento do seu agente declarativo do Microsoft 365 Copilot com suporte completo do TypeSpec e do Microsoft 365 Agents Toolkit.