Visão geral do Microsoft Agent 365 SDK

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

Com o Agent 365 SDK, os programadores podem opcionalmente utilizar a Identidade do Agente para receber e responder a notificações de aplicações de produtividade. O SDK também permite aos agentes invocar 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 informações 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 integrarem perfeitamente nos fluxos de trabalho existentes, funcionando de forma independente quando necessário. Os agentes podem ter identidades únicas, podem ser invocados através de gestos comuns (como @mentions) em aplicações onde os utilizadores normalmente operam (como Teams, Word, Outlook, etc.), demonstrar comportamentos observáveis, construir confiança, tomar ações auditáveis e alcançar tudo através de acesso seguro a ferramentas e dados.

A Identidade do Agente permite controlo de acessos monitorizado e com gates, ao mesmo tempo que fornece ao agente o poder necessário para prosperar. Os agentes adquirem uma identidade através do processo de aquisição. Durante o ciclo de desenvolvimento, os programadores podem obter um Microsoft Entra App Blueprint com os servidores MCP necessários usando o Agent 365 CLI e criar o modelo para todas as instâncias de 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 utilizadores em contexto dentro de aplicações de produtividade como o Teams ou a comentários no Word. Os agentes também podem responder a emails enviados para a caixa de correio do agente, que são entregues num endpoint de notificações alojado pelo agente. O agente também pode participar em 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 a Open Telemetry, o SDK Agents 365 capta telemetria detalhada para a atividade de cada agente, incluindo eventos de inferência, utilização de ferramentas e notificações. Os administradores ganham total visibilidade sobre como os agentes operam e interagem com utilizadores, sistemas e dados através do Purview e do Defender.

Os Agentes podem utilizar os servidores Microsoft MCP para realizar vários cenários, como enviar emails, localizar documentos no SharePoint e responder aos comentários num documento com alterações mínimas ao código do Agente. Os administradores governam estes servidores MCP e a lista crescente de 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 é que o SDK do Agente 365 é diferente?

• O SDK do Agente 365 não é uma pilha de agentes. Não é a forma de criar ou alojar um agente e não vem com qualquer orquestrador ou gestão de fluxos de trabalho, ao contrário do Microsoft Agent Framework, Microsoft Copilot Studio ou Microsoft Foundry.
• Não substitui o Microsoft 365 Agent SDK nem as funcionalidades que oferece para alojamento, protocolo de atividade e identidade. Pelo contrário, o Agent 365 SDK utiliza pacotes para o Microsoft 365 Agent SDK para entregar notificações através do protocolo Activity e utiliza os pacotes Agent Identity para obter o token Agentic para um agente, quando aplicável.
• O Agent 365 pede aos programadores que comecem com um agente existente quando disponível a partir de um framework de agentes à sua escolha. Podem então estender o seu agente para fornecer mais funcionalidades que os tornem governáveis, observáveis e mais produtivos no mundo digital.

Compreender o plano de um agente no Agente 365

Antes de criar uma instância do seu agente, é útil perceber o que entendemos com o plano 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. 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 governação ligadas, como DLP, restrições de acesso externo ou regras de registo. Quando um blueprint é ativado, torna-se empregá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 do seu blueprint, garantindo uma governação consistente em correio, calendário, mensagens do Teams, acesso ao SharePoint e quaisquer outras cargas de trabalho do Microsoft 365 que o agente utilize. Isto previne "agentes sombra", impõe observabilidade e ancora cada agente num modelo seguro de identidade e permissões apoiado pelo Entra.

Pacotes Agent 365 Agent SDK

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

Fluxo de alto nível de um Agente Agente 365

O diagrama seguinte ilustra o fluxo de revelador para agentes

Começas com um agente que já construíste usando uma linguagem de programação e o framework de agentes à tua escolha. Pode então usar o Agent 365 SDK para expandir os agentes que já criou, adicionando as capacidades especializadas como notificações, observabilidade e ligações ao servidor de ferramentas que precisam para funcionar dentro da plataforma. Se quiseres exemplos de como os agentes existentes estão estruturados, os quickstarts guiam-te pelos agentes de exemplo incluídos no Microsoft 365 Agents Toolkit for VS Code. Veja os quickstarts disponíveis do Agent 365 para exemplos:

• Quickstart: 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: Configurar e executar o agente de exemplo do JavaScript Claude Agent SDK

Determina em que servidores Microsoft MCP depende o seu agente, configura essas ligações e integra os componentes do Agent 365 - observabilidade, notificações e ligações ao servidor de ferramentas, usando os padrões fornecidos nos exemplos do GitHub.

Depois disso, gera um blueprint do Agente 365 que defina como o seu agente é representado e integrado na plataforma. Com o plano definido, teste o seu agente no Agents Playground. Isto dá-lhe um espaço para validar notificações, testar interações MCP e inspecionar a telemetria antes de implementar qualquer lugar.

Quando tudo estiver bem, publique o seu agente a um inquilino. A partir daí, os administradores podem ativar e gerir o sistema no centro de administração do Microsoft 365.

Quando precisa do SDK do Agente 365?

Use o SDK do Agente 365 quando precisar:

• Integre com dados ou ferramentas do Microsoft 365 através de conectores MCP seguros
• Governe e audite múltiplos agentes em toda a sua organização
• Fornecer telemetria e monitorização de nível empresarial
• Ativar notificações para interações com agentes
• Implementação em ambientes regulados que exigem rastreabilidade e gestão do ciclo de vida

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

Benefícios em resumo

• Identidade e governação unificadas em todos os agentes
• Telemetria e rastreio prontos a usar
• Acesso seguro e regulado às ferramentas Microsoft 365
• Suporte para cross-orchestrator e multicloud
• Caminho simplificado de atualização para agentes existentes

Próximos passos

• Aprende sobre o blueprint do agente e a configuração da instância
• Adicione observabilidade ao seu agente
• Adicionar e gerir ferramentas