Visão geral do SDK Microsoft Agent 365

O Microsoft Agent 365 SDK estende seu agente de IA existente construído sobre qualquer pilha de agentes com identidade, observabilidade, ferramentas e governança de nível empresarial.

Com o Agent 365 SDK, os desenvolvedores podem opcionalmente utilizar o Agent Identity para receber e responder notificações de aplicativos de produtividade. O SDK também permite que agentes invoquem servidores do Protocolo de Contexto Modelo (MCP) governados e observáveis da Microsoft. Além disso, os agentes podem emitir telemetria para fornecer aos administradores de TI insights sobre a funcionalidade e o desempenho dos agentes.

O que é o SDK do Agente 365?

O Agent 365 SDK é um kit abrangente de desenvolvimento de software que estende os agentes para se encaixarem perfeitamente nos fluxos de trabalho existentes, enquanto ainda funciona de forma independente quando necessário. Os agentes podem ter identidades únicas, podem ser invocados usando gestos comuns (como @mentions) em aplicativos que os usuários normalmente utilizam — como Teams, Word, Outlook etc.), demonstrar comportamentos observáveis, construir confiança, tomar ações auditáveis e alcançar tudo isso por meio de acesso seguro a ferramentas e dados.

A Identidade do Agente permite controle de acesso monitorado e com gate para um administrador, ao mesmo tempo em que fornece ao agente o poder necessário para prosperar. Os agentes adquirem uma identidade por meio do processo de aquisição. Durante o ciclo de vida do desenvolvimento, os desenvolvedores podem obter um Microsoft Entra App Blueprint com os servidores MCP necessários usando a CLI do Agente 365 e criar o modelo para todas as instâncias do agente criadas a partir desse blueprint.

Com notificações, aproximamos os padrões de interação dos agentes aos de um humano. Os agentes podem responder aos usuários em contextos dentro de aplicativos de produtividade como o Teams ou em comentários no Word. Os agentes também podem responder a e-mails enviados para a caixa de correio do agente, que são entregues em um endpoint de notificação hospedado pelo agente. O agente também pode participar de operações do ciclo de vida, como Adquirir e DesAdquirir , e optar por realizar ciclos de configuração e limpeza durante esse período para uma Identidade de Agente.

Construído e integrado com o Open Telemetry, o SDK Agents 365 captura telemetria detalhada para a atividade de cada agente, incluindo eventos de inferência, uso de ferramentas e notificações. Administradores obtêm visibilidade total sobre como os agentes operam e interagem com usuários, sistemas e dados usando Purview e Defender.

Os agentes podem utilizar os servidores Microsoft MCP para realizar vários cenários, como enviar e-mails, localizar documentos no SharePoint e responder aos comentários em um documento com alterações mínimas no código do agente. Administradores governam esses servidores MCP e a lista crescente dessas ferramentas capacita o agente a prosperar no espaço da produtividade.

O Agent 365 funciona com agentes construídos no Microsoft Agent Framework, Copilot Studio, Azure AI Foundry, Semantic Kernel, OpenAI Agents SDK, Claude Code SDK e LangGraph.

Como o SDK do Agent 365 é diferente?

• O SDK do Agent 365 não é uma pilha de agentes. Não é a forma de criar ou hospedar um agente e não vem com nenhum orquestrador ou gerenciamento de fluxos de trabalho, ao contrário do Microsoft Agent Framework, Microsoft Copilot Studio ou Microsoft Foundry.
• Ele não substitui o Microsoft 365 Agent SDK nem as funcionalidades que ele oferece para hospedagem, protocolo de atividade e identidade. Pelo contrário, o SDK do Agente 365 usa pacotes para o Microsoft 365 Agent SDK para entregar notificações via o protocolo Activity e utiliza os pacotes de Identidade do Agente para obter o token Agentic para um agente quando aplicável.
• O Agent 365 pede aos desenvolvedores que comecem com um agente existente quando disponível em um framework de agentes de sua escolha. Depois, podem estender seu agente para oferecer mais funcionalidades que tornem seus agentes governáveis, observáveis e mais produtivos no mundo digital.

Compreendendo o projeto de um agente no Agente 365

Antes de criar uma instância do seu agente, é útil entender o que entendemos com o projeto de um agente Agent 365. Um blueprint é uma definição pré-configurada e aprovada por TI de um tipo de agente, essencialmente o "modelo" empresarial a partir do qual todos os agentes compatíveis são criados. Ele define as capacidades do agente, o acesso necessário à ferramenta MCP, restrições de segurança e conformidade, requisitos de auditoria, metadados do ciclo de vida e quaisquer modelos de políticas de governança vinculadas, como DLP, restrições de acesso externo ou regras de log. Quando um blueprint é ativado, ele se torna contratável, o que significa que os administradores podem instanciar novos agentes a partir dele no Microsoft 365 Admin Center. Cada instância de agente herda as regras de seu blueprint, garantindo uma governança consistente em e-mails, calendários, mensagens do Teams, acesso ao SharePoint e quaisquer outras cargas de trabalho do Microsoft 365 que o agente utilize. Isso previne "agentes sombra", impõe observabilidade e ancora cada agente em um modelo seguro de identidade e permissões respaldado pelo Entra.

Pacotes do SDK do Agente 365

Encontre os pacotes Agent SDK do Agente 365 nos gerenciadores de pacotes das linguagens suportadas.

Fluxo de alto nível de um Agente Agente 365

O diagrama a seguir ilustra o fluxo.

Você começa com um agente que já construiu usando uma linguagem de programação e o framework de agentes de sua escolha. Você pode então usar o SDK do Agent 365 para estender os agentes que já criou, adicionando as capacidades especializadas como notificações, observabilidade e conexões de servidores de ferramentas que eles precisam para rodar dentro da plataforma. Se você quiser exemplos de como os agentes existentes são estruturados, os quickstarts te guiam pelos agentes de exemplo incluídos no Microsoft 365 Agents Toolkit for VS Code. Veja os quickstarts disponíveis do Agent 365 para exemplos:

• Início rápido: Configurar e executar o agente de exemplo JavaScript LangChain
• Início rápido: Configurar e executar o agente de exemplo do framework Python Agent
• Início rápido: Configure e execute o agente de exemplo do JavaScript Claude Agent SDK

Você determina em quais servidores Microsoft MCP seu agente depende, configura essas conexões e integra os componentes do Agent 365 - observabilidade, notificações e conexões de servidor de ferramenta, usando os padrões fornecidos nos exemplos do GitHub.

Depois disso, gere um blueprint do Agente 365 que defina como seu agente é representado e conectado à plataforma. Com o projeto pronto, teste seu agente no Agents Playground. Isso te dá um espaço para validar notificações, testar interações com MCP e inspecionar a telemetria antes de implantar em qualquer lugar.

Quando tudo estiver certo, publique seu agente para um inquilino. A partir daí, os administradores podem habilitar e gerenciar isso no centro de administração do Microsoft 365.

Quando você precisa do SDK do Agente 365?

Use o SDK do Agent 365 quando precisar:

• Integre com dados ou ferramentas do Microsoft 365 via conectores MCP seguros
• Governe e audite múltiplos agentes em toda a sua organização
• Fornecer telemetria e monitoramento de nível empresarial
• Habilitar notificações para interações com agentes
• Implantar em ambientes regulados que exigem rastreabilidade e gerenciamento do ciclo de vida

Como o SDK do Agente 365 se encaixa no ecossistema do agente

Conceitos básicos

• Identidade unificada e governança entre todos os agentes
• Telemetria e rastreamento prontos para uso
• Acesso seguro e governado às ferramentas do Microsoft 365
• Suporte para cross-orchestrator e multicloud
• Caminho simplificado de atualização para agentes existentes

Próximas etapas

• Aprenda sobre o blueprint do agente e a configuração de instâncias
• Adicione observabilidade ao seu agente
• Adicionar e gerenciar ferramentas