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 Agent 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 | Aplica-se 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 Agent 365. | Sem SDK ou integração com código personalizado. A habilitação administrativa ainda pode ser necessária. | No |
| Sincronização do registro de contêiner (versão prévia) | Plataformas de agentes conectados, como Google Vertex AI e Amazon Bedrock. | Configurado para cada plataforma. Importa agentes para 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 para identidade, ferramentas e notificações. Use o Microsoft OpenTelemetry para observabilidade. | Sim |
Dica
Verifique primeiro a integração nativa e a sincronização nativa do registro. 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 identidade em nível de código, ferramentas ou capacidades de notificação 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 oferecer integração embutida com Agent 365 para alguns cenários. Ter ou implantar código, por si só, 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 Agent 365 SDK 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 identidade em nível de código, suporte a ferramentas ou capacidades de notificação. Para detalhes do pacote, veja a visão geral do SDK do Agent 365.
- Seu agente precisa de controle em nível de código sobre quando e como essas capacidades são executadas.
Use o Microsoft OpenTelemetry Distro para observabilidade. Se uma integração existente usar o Agent 365 Observability SDK obsoleto, siga as orientações de migração na documentação arquivada.
A sincronização do registro e a integração interna 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.