Visão geral do SDK do Microsoft Agent 365

O Microsoft Agent 365 SDK conecta um agente que você já possui e executa ao Microsoft Agent 365. Use-o quando seu agente precisar de acesso em nível de código às capacidades do Agent 365, como identidade do agente, observabilidade, ferramentas governadas do Work IQ ou notificações.

Onde o SDK se encaixa

O modelo de integração mostra a fronteira entre integrações integradas, sincronização de registros e cenários integrados pelo desenvolvedor do SDK do Agente 365.

Diagrama do modelo de integração do Agente 365 mostrando onde o SDK do Agente 365 se encaixa.

Agentes em plataformas com integração embutida com Agent 365, e agentes importados via sincronização de registro, já podem aparecer no inventário Agent 365. Adicione o SDK quando o agente precisar de capacidades que o caminho da plataforma não oferece e que você precisa configurar em código, como ferramentas de observabilidade ou Work IQ. As integrações de plataforma evoluem, então confirme a orientação atual da plataforma antes de decidir que o SDK é necessário. Veja Escolha a opção de integração.

O que o SDK adiciona

O SDK oferece quatro capacidades:

Capability Description
Identidade 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 locatários que participam do programa de visualização Frontier.
Observabilidade Emita telemetria por meio do OpenTelemetry, produzindo interações auditadas e rastreáveis, eventos de inferência e uso de ferramentas.
Ferramentas O Invoke governava servidores do Work IQ Model Context Protocol (MCP) para alcançar cargas de trabalho do Microsoft 365, como Mail, Calendar, Word, SharePoint e Teams, sob controle administrativo.
Notificações Receba e responda 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.

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 do agente, enquanto a observabilidade 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 Agente 365.

Compare 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 (This SDK) SDK do Microsoft 365 Agents
Não constrói agentes.
Estende um agente que já existe para adicionar identidade, observabilidade, ferramentas e notificações.		 Uma estrutura para construir agentes conversacionais.
Gerencia a entrega de mensagens em canais como Teams e Microsoft 365 Copilot, e gerencia o estado da conversa.

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

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.
Estrutura 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 constrói, 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 integração

A integração segue quatro etapas:

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

Você pode completar essas etapas manualmente ou usar as Habilidades do Agente 365 de um assistente de programação suportado. Habilidades 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, comenta no Word:

  1. Notificações entregam a menção ao 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. Ferramentas dão ao agente acesso governado aos dados do Microsoft 365 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.

Os pacotes Agent 365 SDK para Python estão 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 Componentes 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.
Microsoft-Agents-A365-Observability-Extensions-Agent-Framework Extensões de observabilidade para o Microsoft Agent Framework. Oferece integração de rastreamento com OpenTelemetry especificamente para aplicações baseadas em Agent Framework.
Microsoft-Agents-A365-Observability-Extensions-OpenAI Extensões 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.
microsoft-agents-a365-observability-extensions-langchain Extensões 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.
microsoft-agents-a365-observability-extensions-semantic-kernel Extensões de observabilidade para o 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.
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

  • Last updated on