Microsoft 365 Agents SDK: quando um agente precisa alcançar mais de um canal

Você construiu um agente que responde perguntas sobre a base de conhecimento da sua empresa. Ele funciona bem no chat do site. Depois o time de vendas pediu o mesmo agente no Microsoft Teams. O suporte queria no WhatsApp. De repente, o mesmo código precisava falar quatro línguas de mensageria diferentes, cada uma com seu formato, sua autenticação e seu protocolo.

Esse cenário é o motivo de existência do Microsoft 365 Agents SDK. A página de overview do SDK descreve três problemas que ele resolve, e o primeiro deles é exatamente este: "seu agente precisa funcionar em mais de um lugar" (fonte: learn.microsoft.com/microsoft-365/agents-sdk/agents-sdk-overview ((abre em nova aba))).

O que o SDK faz (e o que ele não faz)Link para esta seção

O Microsoft 365 Agents SDK é um framework de desenvolvimento para agentes conversacionais. Ele funciona como a camada de encanamento entre a mensagem que chega de um canal (Teams, Copilot, web chat, Slack, Facebook Messenger) e a lógica que você construiu para responder (fonte: learn.microsoft.com/microsoft-365/agents-sdk/agents-sdk-overview ((abre em nova aba))).

Quando uma mensagem chega, o SDK faz três coisas:

1. Recebe a mensagem do canal de origem e normaliza para um formato comum chamado Activity.
2. Roteia a activity para o handler adequado no seu código. Uma mensagem dispara um handler, um usuário entrando na conversa dispara outro.
3. Envia a resposta de volta pelo mesmo canal, traduzindo sua resposta para o formato que aquele canal espera.

Importante: o SDK não é um modelo de IA, nem um motor de orquestração, nem um construtor no-code. Ele não decide o que o agente fala. Isso é responsabilidade do serviço de IA ou da lógica de negócios que você conectar. O SDK é o framework que leva as mensagens até essa lógica e traz as respostas de volta, com o estado da conversa intacto, através de qualquer canal (fonte: learn.microsoft.com/microsoft-365/agents-sdk/agents-sdk-overview ((abre em nova aba))).

Canais que o SDK alcançaLink para esta seção

A documentação do SDK lista suporte a Microsoft 365 Copilot, Microsoft Teams, Copilot Studio, Web Chat, e integrações com terceiros como Facebook Messenger, Slack e Twilio (fonte: learn.microsoft.com/javascript/api/overview/agents-overview ((abre em nova aba))). A página do Microsoft 365 Agents Toolkit acrescenta SMS e email a essa lista, e menciona "mais de 10 outros canais de mensageria" (fonte: learn.microsoft.com/microsoftteams/platform/toolkit/overview-agents-toolkit ((abre em nova aba))).

Na prática, o Azure Bot Service é quem faz a ponte entre o SDK e cada canal. É o Azure Bot Service que traduz o que o canal envia e transforma em activities comuns que o SDK entende (fonte: learn.microsoft.com/microsoft-365/copilot/extensibility/bring-agents-to-copilot ((abre em nova aba))). Isso significa que, para cada canal que você quiser ativar, você precisa configurá-lo no recurso do Azure Bot Service, ligar a chave do canal, completar a configuração específica dele, como requisitos de autenticação ou manifesto para Teams e Copilot (fonte: learn.microsoft.com/microsoft-365/agents-sdk/publish-agent ((abre em nova aba))).

O que muda para quem já usava Bot FrameworkLink para esta seção

O Microsoft 365 Agents SDK é a evolução do Azure Bot Framework SDK. O Bot Framework foi criado numa época em que o centro da conversa eram tópicos, diálogos e mensagens. O centro agora é IA generativa, orquestração de ações e conhecimento espalhado pela empresa. O SDK novo traz capacidades para o desenvolvimento moderno de agentes, juntando a criação de agentes conversacionais com gerenciamento de conversa e orquestração (fonte: learn.microsoft.com/microsoft-365/agents-sdk/bf-migration-guidance ((abre em nova aba))).

Se você tem um bot existente, a migração não exige reescrever tudo. O SDK suporta C#, JavaScript e Python. Se o seu agente está em uma dessas linguagens, você adiciona o código do SDK e usa os adaptadores de canal embutidos para deployar no Copilot ou em outros canais (fonte: learn.microsoft.com/microsoft-365/copilot/extensibility/bring-agents-to-copilot ((abre em nova aba))).

A escolha do modelo de IA é suaLink para esta seção

Um dos problemas que o SDK resolve é o vendor lock-in de IA. O cenário de modelos muda rápido, e um framework que exige um provedor específico força reescrita quando a escolha muda. O SDK é agnóstico em relação à IA: ele fornece a estrutura para receber mensagens, gerenciar estado e rotear eventos, mas não faz suposições sobre o que gera a resposta. Você conecta Azure AI Foundry, Semantic Kernel, OpenAI Agents, LangChain, ou uma solução própria (fonte: learn.microsoft.com/microsoft-365/agents-sdk/agents-sdk-overview ((abre em nova aba))). A página de criação e deploy do SDK reforça que você pode inclusive combinar múltiplos agentes construídos com tecnologias diferentes e exibi-los todos pelo Microsoft 365 Copilot (fonte: learn.microsoft.com/microsoft-365/copilot/extensibility/create-deploy-agents-sdk ((abre em nova aba))).

Gerenciamento de estado sem boilerplateLink para esta seção

Conversas não são stateless. Um usuário faz uma pergunta, volta duas interações depois para complementar, ou abandona a conversa e retoma horas mais tarde. Gerenciar esse contexto (o que aconteceu, onde está armazenado, como flui entre mensagens) é tedioso e propenso a erros quando construído do zero.

O SDK oferece gerenciamento de estado e armazenamento embutido. Ele introduz o conceito de "turn" (uma unidade única de trabalho em uma conversa) e rastreia o estado entre turns sem que você precise implementar a camada de persistência (fonte: learn.microsoft.com/microsoft-365/agents-sdk/agents-sdk-overview ((abre em nova aba))). Para JavaScript, os pacotes incluem extensões de armazenamento para Azure Blob e Cosmos DB (fonte: learn.microsoft.com/javascript/api/overview/agents-overview ((abre em nova aba))).

Como começarLink para esta seção

A Microsoft recomenda o Microsoft 365 Agents Toolkit como ponto de partida. Ele fornece templates para Visual Studio e Visual Studio Code nas três linguagens suportadas. Os templates incluem um Echo Agent (mínimo, para começar do zero) e um Weather Agent (já configurado com Azure AI Foundry ou OpenAI e orquestradores como Semantic Kernel ou LangChain) (fonte: learn.microsoft.com/microsoft-365/copilot/extensibility/create-deploy-agents-sdk ((abre em nova aba))).

Para testar localmente, o toolkit inclui o Agents Playground, que simula a aparência e o comportamento do Microsoft Teams sem precisar de um tenant de desenvolvedor, serviços de tunelamento como Ngrok, ou registro de app/bot (fonte: learn.microsoft.com/microsoftteams/platform/toolkit/overview-agents-toolkit ((abre em nova aba))).

O que você precisa ter no seu ambienteLink para esta seção

Para publicar um agente, você precisa de três componentes:

1. Um registro de aplicativo no Microsoft Entra ID, que fornece o client ID e o tenant ID.
2. Um web app no Azure para hospedar o código do agente.
3. Um recurso Azure Bot Service, que conecta o agente aos canais.

O SDK usa vários tipos de autorização. A escolha depende do cliente e da funcionalidade do agente. O exemplo básico da documentação usa client secrets com variáveis de ambiente (fonte: learn.microsoft.com/microsoft-365/agents-sdk/publish-agent ((abre em nova aba))).

No seu tenant, confirme se a publicação de agentes via Microsoft 365 Agents Toolkit é suportada. A documentação observa que ela não é suportada em tenants do Microsoft 365 Government (fonte: learn.microsoft.com/microsoft-365/copilot/extensibility/m365-agents-sdk ((abre em nova aba))).

Quando o SDK é a escolha certaLink para esta seção

A página principal do SDK diz que ele é mais adequado quando você precisa de controle refinado sobre a seleção de modelo e orquestrador, quer aproveitar experiência prévia com Bot Framework, ou já trabalha com Semantic Kernel ou LangChain (fonte: learn.microsoft.com/microsoft-365/copilot/extensibility/m365-agents-sdk ((abre em nova aba))).

Na minha experiência, o sinal mais claro é quando o mesmo agente precisa aparecer em superfícies diferentes sem reescrever a lógica central. Se o seu agente vive em um único canal e não tem previsão de sair dele, o SDK pode ser mais ferramenta do que você precisa agora. Mas se você sabe que amanhã pode estar deployando no Teams, no Copilot e num chat de site, a abstração de canais que o SDK oferece poupa o trabalho que ninguém gosta de fazer: escrever a mesma integração várias vezes.