Microsoft Agent 365 SDK e CLI

Novo no Agente 365?

Primeiro, escolha sua opção de integração. Se integração embutida ou sincronização de registro fornecerem as capacidades que você precisa, você não precisa adicionar o SDK só para registrar seu agente. Para agentes do Google Vertex AI e Amazon Bedrock, veja Registrar agentes Google Vertex AI e Amazon Bedrock.

Se seu agente precisar de integração em nível de código, escolha um caminho baseado no seu ponto de partida e no resultado que deseja:

Seu ponto de partida	Comece por aqui	Primeiro resultado	Antes de começar
Você tem um agente e quer onboarding assistido por IA.	Início Rápido: conectar um agente existente ao Agent 365, usando as Habilidades do Agent 365.	Registre o agente, adicione as capacidades que escolher e valide a integração.	Revise pilhas compatíveis, assistentes de programação, acesso ao locatário, funções e requisitos de licenciamento.
Você tem um agente e quer rodar comandos CLI você mesmo.	Configure um blueprint de agente.	Crie o blueprint que define a identidade e as permissões do seu agente.	Revise os requisitos de CLI, de função do locatário e de assinatura do Azure e, depois, use a identidade do agente para escolher o modelo de identidade.
Você quer aprender com um projeto de exemplo em vez de trocar seu próprio agente.	Escolha uma amostra em Python, Node.jsou .NET.	Configure um exemplo e obtenha uma primeira resposta no Agents Playground.	Revise os pré-requisitos selecionados de início rápido ou exemplo de README, incluindo runtime, acesso ao modelo e configuração de autenticação.

Para o caminho de exemplo, o catálogo contém links para os inícios rápidos de Python + Microsoft Agent Framework, Node.js + LangChain e Node.js + Claude Agent SDK, além de um exemplo em .NET. Escolha sua linguagem no catálogo para ver os frameworks disponíveis.

Note

Uma resposta local não é prova de que as ferramentas, notificações ou telemetria reais do Microsoft 365 funcionem. Para capacidades suportadas por locatários, revise os requisitos de tenant, consentimento e licenciamento , além da configuração de autenticação para testes.

SDK do Agente 365

Use o Agent 365 SDK para estender agentes construídos usando qualquer agente SDK ou plataforma com identidade, notificações, segurança e acesso governado aos dados do Microsoft 365. Use o Microsoft OpenTelemetry para observabilidade.

Dica

Procurando agentes prontos para uso? Consulte os agentes de parceiros do ecossistema disponíveis no Agent 365 para agentes pré-integrados no lançamento.

Agentes têm identidades únicas. As pessoas as invocam usando gestos comuns (como @mentions) em aplicativos em que os usuários corporativos normalmente operam (como Teams, Word, Outlook e muito mais). Eles demonstram comportamentos observáveis que constroem confiança, tomam ações auditáveis e fazem isso por meio de acesso seguro a ferramentas e dados.

Com o SDK do Agente 365, os agentes podem:

• Use o Agent Identity apoiado pelo Entra, com seus próprios recursos de usuário, como caixa de correio, para autenticação segura e acesso controlado a ferramentas e dados.
• Receba e responda às notificações do Teams, Outlook, comentários do Word e emails, assim como um participante humano nos aplicativos do Microsoft 365.
• Obtenha total observabilidade via Open Telemetry, permitindo interações auditadas e rastreáveis com agentes, eventos de inferência e uso de ferramentas.
• Invoque servidores controlados do Protocolo de Contexto de Modelo (MCP) para acessar cargas de trabalho do Microsoft 365 (por exemplo, Email, Calendário, SharePoint, Teams) sob controle de administrador.
• Função dentro de um sistema de blueprint aprovado por TI, garantindo que cada instância do agente herde políticas de conformidade, governança e segurança.

Revise a visão geral do SDK do Agent 365.

Agente 365 CLI

Agent CLI 365 é o backbone de linha de comando do Agente 365 em todo o ciclo de vida de desenvolvimento do agente – automatizando a configuração, a identidade, a configuração, a integração do MCP, a publicação e a implantação Azure para agentes prontos para a empresa.

Com a CLI do Agente 365, os desenvolvedores podem:

• Crie projetos de agentes e todos os recursos de suporte necessários para eles.
• Gerencie ferramentas Work IQ nativas e personalizadas, permissões e recursos para agentes.
• Implantar o código do agente para Azure.
• Publique os pacotes de aplicativos de agentes no centro de administração da Microsoft.
• Limpe os modelos do agente, as identidades e outros recursos do Azure criados pela CLI.

Saiba mais sobre a CLI do Agente 365

Ciclo de Vida de Desenvolvimento do Agente 365

O Agent 365 trabalha com agentes construídos em qualquer SDK ou plataforma de agentes. Isso inclui plataformas de baixo código, como Copilot Studio e Fábrica de IA do Azure. Também suporta opções pro-code como Microsoft Agent Framework, Microsoft Agents SDK, OpenAI Agents SDK, Claude Code SDK e LangChain SDK. O Agent 365 também funciona com código do agente hospedado em qualquer endpoint, seja ele Azure, Amazon Web Services (AWS), Google Cloud Platform (GCP) ou qualquer outro provedor de nuvem.

O quickstart do agente existente cobre registro, capacidades selecionadas e validação. A implantação, a publicação e a limpeza têm guias separados. Continue com as fases que se aplicam ao seu cenário:

Phase	Guide
Valide a integração antes da implantação.	Checklist de validação do SDK do Agente 365 e teste seu agente.
Faça o deploy do código do agente.	Azure, AWS ou Google Cloud Platform.
Empacotar e publicar o agente.	Publicar o agente no centro de administração da Microsoft.
Crie e verifique uma instância de agente implantada.	Crie instâncias de agente e teste seu agente implantado.
Remova recursos que você não precisa mais.	Referência para limpeza de CLI, incluindo opções de limpeza granular e simulação.

Projeto do agente Agente 365

Antes de trabalhar com instâncias de agentes do Agent 365, é útil entender o que queremos dizer com modelo do agente do Agent 365. Isso vem do blueprint do agente Microsoft Entra e é uma definição pré-configurada por TI e aprovada de um tipo de agente, essencialmente o "modelo" empresarial do qual os agentes compatíveis podem ser criados. Isso define as capacidades do agente, o acesso necessário à ferramenta Work IQ, restrições de segurança e conformidade, requisitos de auditoria, metadados do ciclo de vida e quaisquer modelos de política de governança vinculados, como DLP, restrições de acesso externo ou normas de registro. Quando um blueprint é ativado para uso em um locatário, os usuários podem solicitar aos seus administradores novas instâncias de agentes criadas a partir do blueprint do agente no Admin Center do Microsoft 365. Cada instância de agente herda as regras de seu blueprint, garantindo uma governança consistente em relação ao email, calendário, ao Teams, ao acesso ao SharePoint e quaisquer outras cargas de trabalho do Microsoft 365 com os quais o agente lida. Isso previne agentes sombra/desonestos, impõe observabilidade e ancora cada agente em um modelo seguro de identidade e permissões respaldado pelo Entra.

Como o SDK do Agente 365 é diferente?

O SDK do Agent 365 difere de frameworks de agentes como o Microsoft Agent Framework ou o Microsoft Copilot Studio porque ele não cria nem hospeda agentes. Em vez disso, ele aprimora os agentes que você já construiu, independentemente da pilha subjacente, adicionando capacidades empresariais como identidade de agente baseada em Entra, acesso governado à ferramenta Work IQ, notificações pelo protocolo Activity e governança orientada por ID de agente. Use o Microsoft OpenTelemetry para observabilidade.

Embora seja muito semelhante no nome, ele não substitui o SDK de Agentes do Microsoft 365 e a funcionalidade que ele fornece para hospedagem, protocolo de atividade e identidade. Pelo contrário, o SDK do Agente 365 complementa isso ao sobrepor controles de governança, conformidade e ciclo de vida sobre agentes construídos com ele ou outras plataformas.

SDK do Agente 365 e o ecossistema do agente

Esta tabela resume a arquitetura de agentes em camadas, mostrando como o SDK do Agent 365 adiciona capacidades empresariais acima da lógica do seu agente e do runtime do orquestrador LLM fornecido pelo framework escolhido.

Camada	Role	Fornecido por
Funcionalidades da empresa	Identidade, notificações e ferramentas do Agent 365 SDK; observabilidade do Microsoft OpenTelemetry	SDK do Agent 365 e Microsoft OpenTelemetry
Lógica do Agente	Sugestões, fluxos de trabalho, raciocínio	Sua implementação no código
Runtime do Orquestrador LLM	Invocação de modelos e orquestração de ferramentas	SDK/Framework do agente de sua escolha

Próximas Etapas 

Conecte um agente existente ao Agente 365