Visão geral do SDK do Microsoft Agent 365

O Microsoft Agent 365 SDK conecta um agente que você já possui e já executa ao Microsoft Agent 365. Use isso para acesso em nível de código a funcionalidades como identidade de agente, ferramentas governadas do Work IQ ou notificações.

Onde o SDK se encaixa

O Agente 365 reúne agentes de diferentes fontes em um único plano de controle onde as organizações podem descobri-los, governá-los e protegê-los em larga escala. O caminho de integração depende de onde e como você constrói o agente:

Origem do agente Caminho de integração
Plataformas e agentes da Microsoft, e agentes de terceiros suportados Use a integração nativa do Agent 365 da plataforma. Esses agentes podem aparecer no inventário do Agente 365 sem precisar adicionar o SDK do Agente 365.
Agentes construídos com um SDK ou framework, como SDK de Agentes do Microsoft 365, OpenAI Agents SDK, Microsoft Agent Framework, LangChain, CrewAI ou LlamaIndex Adicione o SDK do Agent 365 ao seu código de agente para capacidades integradas pelo desenvolvedor, como ferramentas do Work IQ ou notificações.
Plataformas de agentes conectados, como Vertex AI ou AWS Bedrock Configure a sincronização do repositório para cada plataforma para importar seus agentes para o inventário do Agente 365.

Os três caminhos conectam os agentes ao Agent 365 e suas integrações com Microsoft Entra, Microsoft Defender, Microsoft Purview e Microsoft Intune. Integração nativa e sincronização de registros não necessariamente oferecem as mesmas capacidades em nível de código que o SDK do Agente 365. Integrações de plataforma evoluem, então confirme as orientações atuais da plataforma antes de alterar uma integração. Veja Escolha a opção de integração.

Como as capacidades do Agente 365 se encaixam

A integração para desenvolvedores do Agent 365 oferece quatro recursos. O SDK do Agente 365 fornece identidade, ferramentas e notificações. O Microsoft OpenTelemetry oferece observabilidade:

Capability Description
Identity Use uma identidade de agente respaldada pelo Microsoft Entra para autenticação segura e acesso controlado a ferramentas e dados. Agentes que precisam de sua própria conta de usuário e caixa de correio estão disponíveis apenas para clientes que participam do programa de visualização Frontier.
Observabilidade Use a distribuição separada Microsoft OpenTelemetry Distro para emitir telemetria que produza interações auditadas e rastreáveis, eventos de inferência e uso de ferramentas.
Ferramentas Invoque servidores governados do Work IQ Model Context Protocol (MCP) para acessar cargas de trabalho do Microsoft 365, como Mail, Calendar, Word, SharePoint e Teams, sob controle administrativo.
Notificações Receba e responda a mensagens do Teams, Outlook, comentários do Word e e-mails, como um participante humano em aplicativos do Microsoft 365. Essa funcionalidade requer a conta de usuário de um agente e está disponível apenas para locatários que participam do programa de prévia Frontier.

Importante

Não use o SDK de observabilidade obsoleto do Agent 365 para novas integrações de observabilidade. Use a distribuição Microsoft OpenTelemetry. Continue usando os pacotes do SDK do Agent 365 para identidade, ferramentas e notificações.

Escolha as capacidades que correspondem às necessidades do seu agente em vez de adotar toda a superfície do SDK. Identidade, ferramentas e notificações usam um blueprint de identidade de agente como sua base no Entra. Notificações também exigem uma conta de usuário agente. O Microsoft OpenTelemetry pode usar tanto o blueprint de identidade do agente quanto um registro padrão de aplicativo Microsoft Entra.

O SDK é entregue em pacotes específicos de linguagem para Python, JavaScript e .NET. Instale o(s) pacotes(s) para as capacidades selecionadas, depois configure a identidade, permissões e integração em tempo de execução correspondentes. Para os pacotes disponíveis, veja pacotes do SDK do Agent 365. Instale o Microsoft OpenTelemetry separadamente para novas integrações de observabilidade.

Comparar o Microsoft Agent 365 SDK e o SDK de Agentes do Microsoft 365

Microsoft Agent 365 SDK e SDK de Agentes do Microsoft 365 são produtos diferentes.

Microsoft Agent 365 SDK (este SDK) SDK de Agentes do Microsoft 365
Não cria agentes de build.
Estende um agente que já existe para adicionar identidade, ferramentas e notificações. Use o Microsoft OpenTelemetry para adicionar observabilidade.		 Uma estrutura para construir agentes conversacionais.
Gerencia a entrega de mensagens em canais como Teams e Microsoft Copilot, além de gerenciar o estado da conversa.

Esses SDKs trabalham juntos. Você pode construir um agente com o SDK de Agentes do Microsoft 365, usar o SDK do Agent 365 para identidade, ferramentas e notificações, e usar o Microsoft OpenTelemetry para observabilidade.

O que é e o que não é

Você continua a ser dono das três camadas que fazem o agente funcionar:

Camada Description
Modelo O modelo de linguagem ou o motor de raciocínio que seu agente chama. O SDK não chama nem seleciona modelos.
Framework ou runtime LangChain, Microsoft Agent Framework, Kernel semântico, o SDK OpenAI Agents, o Claude Agent SDK ou código personalizado. O SDK não constrói agentes, não planeja ou orquestra etapas, nem executa ferramentas.
Host Onde quer que o agente atue hoje, como Azure, AWS, Google Cloud ou on-premises. O SDK não hospeda nem implanta seu agente.

O SDK do Microsoft Agent 365 roda junto com essas camadas. Ele não compila, hospeda, implanta, orquestra ou executa o agente.

Note

O SDK do Microsoft Agent 365 registra servidores MCP governados para que seu agente possa alcançar cargas de trabalho do Microsoft 365, mas seu runtime ainda executa as chamadas de ferramenta.

O fluxo de onboarding

A integração segue quatro etapas:

Stage Description
1. Registrar Crie o blueprint de identidade do agente e a identidade do agente na Microsoft Entra.
2. Estender Adicione as capacidades que seu agente precisa. Use o SDK Agent 365 para ferramentas ou notificações do Work IQ, e use o Microsoft OpenTelemetry para observabilidade.
3. Validar Rode o agente como antes e confirme sua identidade, telemetria, acesso à ferramenta e tratamento das mensagens.
4. Operação Use os controles do Agente 365 para governar e auditar o agente conectado.

Você pode completar essas etapas manualmente ou usar Agent 365 Skills de um assistente de programação suportado. Skills orientam a configuração, fazem as alterações necessárias e validam o resultado.

Como uma solicitação flui

Uma única interação pode usar as quatro capacidades. Quando alguém @mentions seu agente em um comentário do Word:

  1. Notificações enviam a menção para o seu agente.
  2. Identidade e autenticação determinam se o agente atua como ele mesmo, em nome de um usuário logado ou por meio de uma conta de usuário agente. O modo selecionado, permissões, consentimento e sujeito do token definem quais dados e ações estão disponíveis.
  3. O uso de ferramentas dá ao agente acesso governado aos dados do Microsoft 365 de que ele precisa.
  4. A observabilidade registra a invocação, as chamadas de ferramentas e a inferência do modelo.

Seu agente então responde na conversa de comentários.

Pacotes SDK do Agente 365

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

Importante

Os pacotes de observabilidade nas tabelas a seguir estão obsoletos. Não os use para novas integrações. Use o Microsoft OpenTelemetry Distro ou revise a documentação obsoleta do Agent 365 Observability SDK antes de migrar uma integração existente.

Você pode encontrar os pacotes Agent 365 SDK para Python no Python Package Index (PYPI).

Package Description
Microsoft-Agents-A365-Notifications Extensões de notificação e mensagens para aplicações de agentes de IA. Fornece utilitários para lidar com notificações do agente, eventos de ciclo de vida e roteamento em diferentes canais e subcanais em aplicativos Microsoft 365.
microsoft-agents-a365-observability-core Obsoleto: Componentes legados de telemetria, rastreamento e monitoramento para agentes de IA construídos sobre OpenTelemetry. Fornece spans estruturados para invocação de agentes, execução de ferramentas e inferência de modelos de linguagem de grande escala (LLMs) com propagação de contexto e exportadores moduláveis. Use o Microsoft OpenTelemetry Distro em vez disso.
Microsoft-Agents-A365-Observability-Extensions-Agent-Framework Descontinuado: Extensões legadas de observabilidade para o Microsoft Agent Framework. Oferece integração de rastreamento com OpenTelemetry especificamente para aplicações baseadas em Agent Framework. Use a distribuição OpenTelemetry da Microsoft em vez disso.
Microsoft-Agents-A365-Observability-Extensions-OpenAI Obsoleto: Extensões legadas de observabilidade para o SDK OpenAI Agents. Oferece integração do rastreamento OpenTelemetry para aplicações baseadas em agentes OpenAI, com instrumentação automática para fluxos de trabalho de agentes e invocações de ferramentas. Use a distribuição OpenTelemetry da Microsoft em vez disso.
microsoft-agents-a365-observability-extensions-langchain Obsoleto: Extensões legadas de observabilidade para o framework LangChain. Oferece integração de rastreamento OpenTelemetry para aplicações de IA baseadas em LangChain, com instrumentação automática para cadeias, agentes e ferramentas. Use o Microsoft OpenTelemetry Distro em vez disso.
microsoft-agents-a365-observability-extensions-semantic-kernel Obsoleto: Extensões legadas de observabilidade para framework Kernel semântico. Fornece integração de rastreio do OpenTelemetry para aplicativos baseados em Kernel semântico com instrumentação automatizada para funções do kernel, plug-ins e planejadores. Use a distribuição OpenTelemetry da Microsoft em vez disso.
Microsoft-Agents-A365-runtime Utilitários centrais de runtime e gerenciamento de ambiente para aplicações de agentes de IA. Fornece descoberta da API essencial do Power Platform, configuração do ambiente e definição do escopo de autenticação.
Microsoft-Agents-A365-Tooling Funcionalidade central de ferramentas para gerenciamento de servidores de ferramentas MCP (Model Context Protocol) em aplicações construídas com o Microsoft Agent 365 SDK. Fornece a base para descobrir, registrar e gerenciar servidores de ferramentas em diferentes frameworks de IA.
Microsoft-Agents-A365-Tooling-Extensions-AgentFramework Ferramentas e serviços específicos do Agent Framework para desenvolvimento de agentes de IA. Fornece o serviço de registro de ferramentas MCP (Model Context Protocol) para adicionar dinamicamente servidores MCP aos agentes do Agent Framework.
Microsoft-Agents-A365-Tooling-Extensions-OpenAI Ferramentas e serviços específicos do SDK de agentes OpenAI para desenvolvimento de agentes de IA. Fornece o serviço de registro de ferramentas MCP (Model Context Protocol) para adicionar dinamicamente servidores MCP a agentes baseados em SDK dos Agentes OpenAI.
microsoft-agents-a365-tooling-extensions-semantickernel Kernel semântico ferramentas e serviços específicos para o desenvolvimento de agente de IA. Fornece o serviço de registro da ferramenta MCP (Model Context Protocol) para adicionar dinamicamente servidores MCP a agentes baseados em Kernel semântico.
Microsoft-agents-a365-tooling-extensions-azureaifoundry Fábrica de IA do Azure ferramentas e serviços específicos para o desenvolvimento de agente de IA. Fornece o serviço de registro da ferramenta MCP (Model Context Protocol) para adicionar dinamicamente servidores MCP a agentes Fábrica de IA do Azure.

Conteúdo relacionado

  • Última atualização em