Microsoft Agent 365 SDK e CLI

Novo no Agente 365?

Se você estiver apenas começando, escolha o caminho que melhor se ajusta a você:

Quero...	Comece por aqui
Comece a funcionar rapidamente com a assistência de IA	ai-guided setup — Um agente de codificação de IA (GitHub Copilot, Claude Code ou OpenAI Codex) orienta você pela instalação, configuração, implantação e publicação de um único arquivo de instrução.
Siga um exemplo prático passo a passo	Quickstarts — escolha um exemplo em seu idioma (Node.js, Python ou .NET) e crie um agente de trabalho.
Entender o fluxo de trabalho completo antes de mergulhar	Introdução ao desenvolvimento do Agent 365 – tipos de agente, fases, configuração e publicação em um guia.
Entender qual tipo de agente criar	Tipos de agentes – explica os tipos de agente e seus modelos de identidade.
Habilitar Google Vertex AI ou Amazon Bedrock agents	O registro desses agentes não requer nenhum trabalho de desenvolvimento– os agentes são retirados automaticamente por meio das APIs do Google e da Amazon. Nenhuma integração do SDK, nenhum blueprint e nenhuma alteração de código são necessárias. Depois de registrado, você pode usar o SDK do Agent 365 para adicionar observabilidade, acesso à ferramenta Work IQ e outros recursos de forma incremental. Consulte Registro de agentes do Google Vertex AI e da Amazon Bedrock para começar.

SDK do Agente 365

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

Dica

Procurando agentes pré-configurados? 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.
• Funcione dentro de um sistema de blueprint aprovado por TI, garantindo que cada instância de agente herde políticas de conformidade, governança e segurança.

Saiba mais sobre o SDK do Agente 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 blueprints de agente, 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.

Importante

Para apreciar completamente como o SDK e a CLI do Agent 365 funcionam juntos, examine o fluxo de trabalho descrito em Introdução ao desenvolvimento do Agent 365

Projeto do agente Agente 365

Antes de trabalhar com instâncias de agentes do Agente 365, é útil entender o que queremos dizer com o esquema de um agente do Agente 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 Agente 365 difere de estruturas de agente, como o Microsoft Agent Framework ou Microsoft Copilot Studio, pois 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 em Entra, acesso governado à ferramenta Work IQ, observabilidade baseada em OpenTelemetry (OTel), notificações por meio do protocolo de atividade e governança orientada por ID do agente.

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	Função	Fornecido por
Capacidades Empresariais	Identidade, notificações, observabilidade, ferramentas	SDK do Agente 365
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

Introdução ao desenvolvimento do Agent 365