10-02-01 — M365 Agents SDK: O que é, Quando Usar vs Copilot Studio
TL;DR
O Microsoft 365 Agents SDK (lançado em GA em 2025) é o caminho pro-code para criar agentes que publicam em Teams, Outlook, M365 Copilot e outros canais. Substitui o Bot Framework SDK para cenários de agentes. Use Copilot Studio quando precisar de low-code com aprovação rápida; use o SDK quando sua equipe .NET precisa de controle total sobre o comportamento do agente.
O que é o M365 Agents SDK
O M365 Agents SDK é uma coleção de pacotes NuGet (.NET), npm (JavaScript) e PyPI (Python) que abstraem a complexidade de:
- Comunicação com canais Microsoft (Teams, Outlook, Copilot)
- Gerenciamento de estado de conversação
- Autenticação OAuth/SSO com Azure AD
- Streaming de respostas
- Integração com Adaptive Cards
Genealogia do SDK: O M365 Agents SDK é a evolução direta do Bot Framework SDK + Teams AI Library. Se você tem bots existentes em Bot Framework v4, a migração é incremental — o SDK compartilha conceitos fundamentais mas com APIs mais limpas e focadas em agentes de IA.
Posicionamento: SDK vs Copilot Studio
quadrantChart
title SDK vs Copilot Studio
x-axis Low Control --> High Control
y-axis Low Speed --> High Speed
quadrant-1 Ideal para SDK
quadrant-2 Use Copilot Studio
quadrant-3 Não faça
quadrant-4 Avalie o custo
Copilot Studio Declarative: [0.2, 0.9]
Copilot Studio Custom: [0.4, 0.7]
M365 Agents SDK .NET: [0.85, 0.5]
Bot Framework Legacy: [0.7, 0.2]
| Critério | Copilot Studio | M365 Agents SDK |
|---|---|---|
| Perfil do builder | Maker / analista de negócios | Desenvolvedor .NET/Python/JS |
| Tempo para 1º agente | Horas | Dias |
| Controle do modelo LLM | Limitado (GPT-4o Microsoft) | Total (qualquer modelo) |
| Lógica customizada | Power Fx + HTTP Actions | Código completo |
| Custo de desenvolvimento | Baixo | Alto (horas de dev) |
| Manutenção | Fácil (visual) | Requer pipeline CI/CD |
| Canais suportados | Teams, Copilot, Web, mais | Qualquer canal via Azure |
| Multi-agente | Sim (orquestração nativa) | Sim (você implementa) |
Arquitetura do SDK
graph TD
subgraph Seu Código
A[AgentApplication] --> B[ActivityHandlers]
B --> C[Seu LLM / SK]
B --> D[Estado / Memória]
end
subgraph M365 Agents SDK
E[CloudAdapter] --> F[Azure Bot Service]
F --> G[Teams]
F --> H[M365 Copilot]
F --> I[Outlook]
F --> J[Web Chat]
end
A <--> E
Pacotes principais (.NET)
// .csproj — pacotes do M365 Agents SDK
<PackageReference Include="Microsoft.Agents.Hosting.AspNetCore" Version="1.*" />
<PackageReference Include="Microsoft.Agents.BotBuilder" Version="1.*" />
<PackageReference Include="Microsoft.Agents.Storage.Blobs" Version="1.*" />
// Opcional: integração com Semantic Kernel
<PackageReference Include="Microsoft.SemanticKernel" Version="1.*" />
Para equipes .NET: O SDK foi desenhado para integrar naturalmente com ASP.NET Core. O endpoint do agente é um controller MVC padrão. Você usa DI, middleware, logging e todo o ecossistema .NET que já conhece. Não há lock-in de framework proprietário.
Quando escolher o SDK em vez do Copilot Studio
- ✅ Agente precisa integrar com sistemas .NET legados via código direto
- ✅ Regras de negócio complexas que Power Fx não suporta
- ✅ Necessidade de fine-tuning ou modelo específico (Azure OpenAI Whisper, Vision)
- ✅ Pipeline de dados proprietário (RAG customizado com Azure AI Search)
- ✅ Requisitos de auditoria que exigem log de cada decisão do agente
- ✅ Time já tem expertise em .NET — o custo marginal é baixo
Como isso se conecta
- 10-02-02 — Desenvolvimento prático com o SDK em .NET, JS e Python
- 10-03-01 — Publicação: o SDK e o Copilot Studio usam o mesmo canal Azure Bot Service
- Módulo 9 (Semantic Kernel) — SK é o orquestrador natural para agentes buildados com o SDK