SDK e CLI do Microsoft Agent 365

É novo no Agent 365?

Se está a começar, escolha o caminho que melhor se adequa a si:

Quero...	Comece aqui
Comece a utilizar rapidamente com a assistência da IA	Configuração guiada por IA — Um agente de codificação de IA (GitHub Copilot, Claude Code ou OpenAI Codex) guia-o na instalação, configuração, implementação e publicação a partir de um único ficheiro de instruções.
Acompanhe um exemplo prático, passo a passo	Inícios rápidos — selecione um exemplo na sua linguagem (Node.js, Python ou .NET) e crie um agente funcional.
Compreenda todo o fluxo de trabalho antes de começar	Inicie o desenvolvimento do Agent 365 — tipos de agentes, fases, configuração e publicação num só guia.
Saiba que tipo de agente criar	Tipos de agentes — explica os tipos de agentes e os seus modelos de identidade.
Ativar os agentes do Google Vertex AI ou do Amazon Bedrock	O registo destes agentes não requer trabalho de desenvolvimento — os agentes são obtidos automaticamente através das APIs da Google e da Amazon. Não é necessária integração com SDK, nem blueprint, nem alterações de código. Depois de registado, pode usar o SDK do Agent 365 para adicionar observabilidade, acesso à ferramenta Work IQ e outras capacidades de forma incremental. Consulte Registo de agentes Google Vertex AI e Amazon Bedrock para começar.

SDK do Agent 365

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

Sugestão

Procura agentes pré-criados? Consulte agentes parceiros do ecossistema disponíveis no Agent 365 para agentes que já estão pré-integrados no lançamento.

Os agentes têm identidades exclusivas. As pessoas invocam-nos através de gestos comuns (como @mentions) em aplicações em que os utilizadores empresariais normalmente operam (como Teams, Word, Outlook e outras). Demonstram comportamentos observáveis que criam confiança, executam ações auditáveis e fazem-no ao aceder de forma segura a ferramentas e dados.

Com o SDK do Agent 365, os agentes podem:

• Utilizar a Identidade do Agente suportada pelo Entra com os seus próprios recursos de utilizador, como a caixa de correio, para uma autenticação segura e um acesso controlado a ferramentas e dados.
• Receber e responder a notificações do Teams, Outlook, comentários do Word e e-mails—tal como um participante humano nas aplicações do Microsoft 365.
• Obter total observabilidade através do OpenTelemetry, ativando interações de agentes, eventos de inferência e utilização de ferramentas auditados e rastreáveis.
• Invocar servidores do Model Context Protocol (MCP) governados para aceder a cargas de trabalho do Microsoft 365 (por exemplo, Correio, Calendário, SharePoint, Teams) sob controlo administrativo.
• Funcionar dentro de um sistema de blueprint aprovado pela TI, garantindo que cada instância de agente herda políticas de conformidade, governação e segurança.

Obter mais informações sobre o SDK do Agent 365.

CLI do Agent 365

A CLI do Agent 365 é a espinha dorsal da linha de comandos do Agent 365 ao longo de todo o ciclo de vida do desenvolvimento de agentes – automatizando a configuração, identidade, integração com MCP, publicação e implementação no Azure para agentes prontos para empresas.

Com a CLI do Agent 365, os programadores podem:

• Criar blueprints de agentes e todos os recursos de suporte necessários.
• Gerir ferramentas Work IQ fornecidas com o programa e personalizadas, permissões e ferramentas de suporte para agentes.
• Implementar código do agente no Azure.
• Publicar pacotes de aplicações de agentes no centro de administração da Microsoft.
• Limpar os blueprints dos agentes, identidades e outros recursos do Azure criados pela CLI.

Saber mais informações sobre a CLI do Agent 365

Ciclo de vida de Desenvolvimento do Agente do Agent 365

O Agent 365 é compatível com agentes criados com qualquer SDK ou plataforma de agentes. Isto inclui plataformas low-code como o Copilot Studio e o Azure AI Foundry. Também suporta opções pro-code, como Microsoft Agent Framework, SDK de Agentes 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 alojado em qualquer ponto final, seja no Azure, Amazon Web Services (AWS), Google Cloud Platform (GCP) ou qualquer outro fornecedor de cloud.

Importante

Para compreender plenamente como o SDK e a CLI do Agent 365 funcionam em conjunto, consulte o fluxo de trabalho descrito em Introdução ao desenvolvimento do Agent 365

Blueprint de agente do Agent 365

Antes de trabalhar com instâncias de agentes do Agent 365, é útil perceber o que entendemos por blueprint de um agente do Agent 365. Isto deriva do blueprint de agente Microsoft Entra e é uma definição pré-configurada e aprovada pela TI de um tipo de agente, essencialmente o "modelo" empresarial a partir do qual agentes compatíveis podem ser criados. Define as capacidades do agente, o acesso obrigatório à ferramenta Work IQ, restrições de segurança e conformidade, requisitos de auditoria, metadados do ciclo de vida e quaisquer modelos de políticas de governação associadas, como DLP, restrições de acesso externo ou regras de registo. Quando um blueprint é ativado para uso num inquilino, os utilizadores podem solicitar aos respetivos 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 do seu blueprint, garantindo uma governação consistente no acesso ao correio, calendário, Teams, SharePoint e quaisquer outras cargas de trabalho do Microsoft 365 às quais o agente aceda. Isto impede a existência de agentes sobra/não autorizados, impõe a observabilidade e ancora cada agente num modelo seguro de identidade e permissões suportado pelo Entra.

Como é que o SDK do Agent 365 é diferente?

O SDK do Agent 365 difere de estruturas de agentes como o Microsoft Agent Framework ou o Microsoft Copilot Studio porque não cria nem aloja agentes. Em vez disso, melhora os agentes que já criou – independentemente da pilha subjacente – ao adicionar capacidades empresariais, como identidade de agente baseada no Entra, acesso regulamentado a ferramentas Work IQ, observabilidade baseada em OpenTelemetry (OTel), notificações através do protocolo de Atividade e governação orientada por ID de agente.

Embora muito semelhante no nome, não substitui o SDK de Agentes do Microsoft 365 nem a funcionalidade que este oferece para alojamento, protocolo de atividade e identidade. Pelo contrário, o SDK do Agent 365 complementa-o ao adicionar camadas de governação, conformidade e controlos de ciclo de vida sobre agentes criados com ele ou com outras plataformas.

SDK do Agent 365 e o ecossistema de agentes

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

Camada	Função	Fornecido por
Capacidades Empresariais	Identidade, notificações, observabilidade, ferramentas	SDK do Agent 365
Lógica do Agente	Pedidos, fluxos de trabalho, racionalização	A sua implementação em código
Runtime do Orquestrador LLM	Invocação de modelos e orquestração de ferramentas	SDK/Estrutura de Agente à sua escolha

Passos seguintes

Introdução ao desenvolvimento do Agent 365