SDK e CLI do Microsoft Agent 365

Novo no Agent 365?

Se você está começando, escolha o caminho que melhor se adapta a você:

Quero...	Comece aqui
Comece a funcionar rapidamente com assistência de IA	Configuração assistida por IA - Um agente de IA para codificação (GitHub Copilot, Claude Code ou OpenAI Codex) orienta você na instalação, configuração, implantação e publicação a partir de um único arquivo de instruções.
Siga um exemplo prático etapa por etapa	Guia rápido - escolha um exemplo na sua linguagem de programação (Node.js, Python ou .NET) e crie um agente funcional.
Entenda todo o fluxo de trabalho antes de começar	Introdução ao desenvolvimento do Agent 365 - tipos de agentes, fases, configuração e publicação em um único guia.
Entenda qual tipo de agente criar	Tipos de Agentes - explica os tipos de agentes e seus modelos de identidade.
Habilite agentes do Google Vertex AI ou da Amazon Bedrock	O registro desses agentes não requer trabalho de desenvolvimento, os agentes são obtidos automaticamente pelas APIs do Google e da Amazon. Não é necessário integrar o SDK, criar blueprint, nem alterar o código. Depois de registrado, você pode usar o SDK do Agent 365 para adicionar observabilidade, acesso à ferramenta Work IQ e outras funcionalidades gradualmente. Consulte Registrando agentes do Google Vertex AI e Amazon Bedrock para começar.

SDK do Agent 365

Use o SDK do Agent 365 para estender agentes criados usando qualquer SDK de agente ou plataforma, com identidade em nível empresarial, observabilidade, notificações, segurança e acesso governado aos dados do Microsoft 365.

Dica

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

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

Com o SDK do Agent 365, os agentes podem:

• Use a Identidade do Agente apoiada pelo Entra, com os próprios recursos de usuário, como a caixa de correio, para autenticação segura e acesso controlado a ferramentas e dados.
• Recebem e respondem a notificações do Teams, Outlook, comentários do Word e emails, assim como um participante humano em 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 governados do Protocolo de Contexto do Modelo (MCP) para acessar cargas de trabalho do Microsoft 365 (por exemplo, Mail, Calendário, SharePoint, Teams) sob controle administrativo.
• 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.

Saiba mais sobre o SDK do Agent 365.

CLI do Agent 365

CLI do Agent 365 é a ferramenta fundamental de linha de comando do Agent 365 ao longo de todo o ciclo de desenvolvimento de agentes, automatizando preparação, identidade, configuração, integração com MCP, publicação e implantação no Azure para agentes aptos para uso empresarial.

Com a CLI do Agent 365, os desenvolvedores podem:

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

Saiba mais sobre a CLI do Agent 365

Ciclo de vida de desenvolvimento de agentes do Agent 365

O Agent 365 é compatível com agentes criados em qualquer SDK ou plataforma de agentes. Isso inclui plataformas low-code como Copilot Studio e Fábrica de IA do Azure. Ele também oferece suporte a opções pro-code, tais como Microsoft Agent Framework, SDK de Agentes da Microsoft, SDK de Agentes do OpenAI, SDK do Claude Code e SDK do LangChain. O Agent 365 também funciona com código de agente hospedado em qualquer ponto de extremidade, seja Azure, Amazon Web Services (AWS), Google Cloud Platform (GCP) ou qualquer outro provedor de nuvem.

Importante

Para entender completamente como o SDK e o CLI do Agent 365 funcionam juntos, revise o fluxo de trabalho descrito em Introdução ao desenvolvimento com o Agent 365

Blueprint do agente do Agent 365

Antes de trabalhar com instâncias de agentes do Agent 365, é útil compreender o que queremos dizer com o blueprint de um agente do Agent 365. Isso deriva do Blueprint do agente do Microsoft Entra e é uma definição pré-configurada e aprovada pela TI de um tipo de agente, essencialmente o "modelo corporativo" a partir do qual agentes em conformidade podem ser criados. Ele define as capacidades do agente, o acesso necessário à ferramenta Work IQ, as restrições de segurança e conformidade, os requisitos de auditoria, os metadados do ciclo de vida e quaisquer modelos de políticas de governança vinculados, como DLP, restrições de acesso externo ou regras de registro. Quando um blueprint é ativado para uso em um locatário, os usuários podem solicitar aos administradores novas instâncias de agente criadas com base no blueprint do agente no centro de administração do Microsoft 365. Cada instância de agente herda as regras de seu blueprint, garantindo uma governança consistente entre email, calendário, Teams, acesso ao SharePoint e quaisquer outras cargas de trabalho do Microsoft 365 que o agente contata. Isso evita agentes não autorizados ou ocultos, garante observabilidade e ancora cada agente em um modelo seguro de identidade e permissões respaldado pelo Entra.

Em que o SDK do Agent 365 difere?

O Agent 365 SDK se diferencia de estruturas de agentes como o Microsoft Agent Framework ou o Microsoft Copilot Studio porque não cria nem hospeda agentes. Em vez disso, ele aprimora os agentes que você já criou, independentemente da pilha subjacente, adicionando funcionalidades empresariais, como identidade do Agente baseado no Entra, acesso governado à ferramenta Work IQ, observabilidade baseada em OpenTelemetry (OTel), notificações por meio do protocolo de atividade e governança baseada na ID do agente.

Embora o nome seja muito parecido, ele não substitui o SDK de Agentes do Microsoft 365 nem as funcionalidades que ele oferece para hospedagem, protocolo de atividade e identidade. Pelo contrário, o SDK do Agent 365 o complementa ao adicionar camadas de controles de governança, conformidade e ciclo de vida sobre agentes criados com ele ou outras plataformas.

SDK do Agent 365 e ecossistema de agentes

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 pela estrutura escolhida.

Camada	Função	Fornecido por
Capacidades Empresariais	Identidade, notificações, observabilidade, ferramentas	SDK do Agent 365
Lógica do Agente	Prompts, fluxos de trabalho, raciocínio	Sua implementação no código
Runtime do Orquestrador de LLM	Invocação de Modelos e orquestração de ferramentas	SDK/Framework do agente de sua escolha

Próximas etapas

Introdução ao desenvolvimento no Agent 365