Compartilhar via


Microsoft Agent 365 SDK e CLI

Importante

Você precisa fazer parte do programa de prévia Frontier para obter acesso antecipado ao Microsoft Agent 365. A Frontier conecta você diretamente às mais recentes inovações de IA da Microsoft. Prévias da Frontier estão sujeitas aos termos de pré-visualização existentes dos seus contratos com clientes. Como esses recursos ainda estão em desenvolvimento, sua disponibilidade e capacidades podem mudar ao longo do tempo.

SDK do Agente 365

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

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 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 a notificações do Teams, Outlook, comentários do Word e e-mails — 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.
  • Invoke servidores do Model Context Protocol (MCP) governados para acessar cargas de trabalho do Microsoft 365 (por exemplo, Mail, Calendário, SharePoint, Teams) sob controle administrativo.
  • 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

O Agent 365 CLI é a espinha dorsal de linha de comando para o Agent 365 durante todo o ciclo de desenvolvimento do agente – automatizando configuração, identidade, configuração, integração com MCP, publicação e implantação do Azure para agentes prontos para empresas.

Com a CLI do Agente 365, os desenvolvedores podem:

  • Crie projetos de agentes e todos os recursos de suporte necessários para eles.
  • Gerencie servidores MCP prontos para uso e personalizados, permissões e ferramentas para agentes.
  • Implante o código do agente no Azure.
  • Publique os pacotes de aplicação do agente no Microsoft Admin Center.
  • Limpe blueprints de agentes, identidades e outros recursos do Azure criados pela linha de comando.

Saiba mais sobre a CLI do Agente 365

Ciclo de vida do Desenvolvimento do Agente 365

O Agent 365 trabalha com agentes construídos em qualquer SDK ou plataforma de agentes. Isso inclui plataformas low-code como Copilot Studio e Azure AI Foundry. 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 de agente hospedado em qualquer endpoint, seja Azure, Amazon Web Services (AWS), Google Cloud Platform (GCP) ou qualquer outro provedor de nuvem.

Importante

Para compreender plenamente como o SDK do Agente 365 e a CLI funcionam juntos, revise o fluxo de trabalho descrito no Ciclo de Vida do Desenvolvimento do Agente 365

Projeto do agente Agente 365

Antes de trabalhar com instâncias de agentes Agente 365, é útil entender o que queremos dizer com o projeto de um agente Agente 365. Isso vem do Microsoft Entra agent blueprint e é uma definição pré-configurada e aprovada por TI de um tipo de agente, essencialmente o "modelo" corporativo a partir do qual agentes compatíveis podem ser criados. Ele define as capacidades do agente, acessos necessários às ferramentas MCP, restrições de segurança e conformidade, requisitos de auditoria, 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 tenant, os usuários podem solicitar aos administradores novas instâncias de agente criadas a partir do 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 e-mail, calendário, Teams, acesso ao SharePoint e quaisquer outras cargas de trabalho do Microsoft 365 que o agente utilize. 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, pois 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 a ferramentas MCP governadas, observabilidade baseada em OpenTelemetry, notificações pelo protocolo Activity e governança orientada por ID de agente.

Embora seja muito semelhante no nome, ele não substitui o Microsoft 365 Agents SDK nem as funcionalidades que ele oferece 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.

O diagrama mostra como agentes existentes podem ser habilitados pelo Agente 365

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 Prompts, fluxos de trabalho, raciocínio Sua implementação no código
LLM Orchestrator Runtime Invocação de modelos e orquestração de ferramentas SDK/Framework do Agente de sua escolha

Próximas etapas

Saiba mais sobre o Ciclo de Vida do Desenvolvimento do Agente 365