Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Compare as três opções de integração com o Agent 365 e escolha o mecanismo certo com base nas capacidades que sua plataforma oferece e no que você precisa configurar em código.
Compare os mecanismos de integração do Agente 365
Use a tabela a seguir para comparar onde cada mecanismo de integração se aplica, como você o implementa e se ele requer o SDK do Agente 365.
| Mecanismo | Aplicável a | Como é aplicado | SDK necessário |
|---|---|---|---|
| Integração interna | Plataformas e agentes da Microsoft, como Agent Builder, Copilot Studio, Fábrica de IA do Azure, Copilot Cowork e Researcher. Também agentes terceirizados já integrados ao Agente 365. | Sem SDK ou integração com código personalizado. A habilitação administrativa ainda pode ser necessária. | No |
| Sincronização do registro (prévia) | Plataformas de agentes conectados, como Google Vertex AI e Amazon Bedrock. | Configurado por plataforma. Importa agentes para mostrar visibilidade e governança. | No |
| SDK do Agente 365 | Agentes que você constrói com um SDK ou framework de agentes, como o SDK de Agentes do Microsoft 365, Microsoft Agent Framework, OpenAI Agents SDK, LangChain, CrewAI ou LlamaIndex. | Desenvolvedor integrado, no código do seu agente. | Yes |
Tip
Verifique a integração e a sincronização do registro integradas primeiro. Se algum desses caminhos já oferece as capacidades do Agent 365 que você precisa, você não precisa do SDK apenas para registrar o agente. Adicione o SDK quando seu cenário precisar de capacidades em nível de código que o caminho da plataforma não oferece.
Note
Algumas plataformas suportam mais de um mecanismo. Copilot Studio e Fábrica de IA do Azure podem fornecer integração embutida com Agent 365 para alguns cenários, enquanto agentes baseados em código construídos com componentes Foundry suportados podem usar o SDK quando precisarem de capacidades não fornecidas por esse caminho da plataforma. Possuir ou implantar código sozinho não determina a escolha; Compare as capacidades e o modelo de autenticação para o cenário específico. Para agentes hospedados no Foundry, consulte a documentação do Serviço de Agente da Fábrica de IA do Azure e as orientações para configurar a coleta de dados do Agente 365 e conceder permissões de observabilidade do Agente 365.
O caminho de integração disponível para o Fábrica de IA do Azure pode depender de como o agente é construído, hospedado e registrado. Confirme a integração atual com o Foundry e a orientação de observabilidade para seu cenário antes de escolher uma abordagem. Para agentes baseados em código, comece com o início rápido do SDK do Microsoft Foundry e compare com a orientação do agente hospedado.
Quando usar o SDK do Agente 365
Use o SDK do Agente 365 quando:
- Você constrói e implanta seu agente por conta própria, em vez de hospedar em uma plataforma Microsoft integrada.
- Seu agente precisa de uma ou mais capacidades do Agent 365: identidade, observabilidade, ferramentas ou notificações. Para saber o que cada funcionalidade oferece, veja a visão geral do SDK do Agente 365.
- Seu agente precisa de controle em nível de código sobre quando e como essas capacidades são executadas.
A identidade é frequentemente o fator decisivo no caminho do SDK. A capacidade de identidade suporta três modos de execução: service-to-service (S2S), em nome de um usuário logado (OBO), e Agentic-User, no qual o agente usa sua própria conta de usuário Entra. Escolha o modo que corresponde ao trabalho que o agente realiza e ao caminho da plataforma disponível para o seu cenário. Para o modelo identidade e suas decisões de configuração, veja Identidade do agente.
A sincronização do registro e a integração integrada podem mudar conforme o suporte à plataforma evolui. Verifique novamente as orientações atuais de integração da plataforma antes de adicionar capacidades em nível de código.
Note
O SDK não é uma alternativa ao seu framework de agentes, então "construir um agente" não é um desses mecanismos. Construa o agente com seu framework primeiro, depois use um dos mecanismos anteriores para trazê-lo para o Agent 365.