Este artigo responde a perguntas comuns sobre o Agent 365 SDK: o que ele faz e o que não faz, quando você precisa, quais capacidades estão disponíveis, como funciona a identidade e como validar uma integração.
Escopo e posicionamento
Posso construir um agente com o SDK do Agent 365?
Não. O SDK não é um framework de construção de agentes. Construa seu agente com o framework escolhido e depois use o SDK do Agent 365 para trazê-lo para o Agent 365. Veja Quando usar o SDK do Agente 365.
O SDK faz chamadas de modelos de linguagem ou orquestra etapas?
Não. Seu agente continua fazendo suas próprias chamadas ao modelo, e a orquestração permanece no seu framework ou runtime. Veja o SDK do Agente 365 e o ecossistema do agente.
O SDK hospeda ou implanta meu agente?
Não. Seu agente atua onde quer que ele esteja hoje. Veja: Como o SDK do Agent 365 é diferente?
O SDK executa as chamadas de ferramenta do meu agente?
Não. O SDK registra servidores governados do Protocolo de Contexto de Modelo (MCP); a execução permanece no seu ambiente de execução. Veja o SDK do Agente 365 e o ecossistema do agente.
O SDK substitui meu framework de agentes?
Não. Mantenha seu modelo, framework ou runtime, e o host. O SDK roda junto com eles e adiciona identidade, observabilidade, ferramentas e notificações. Para a fronteira camada por camada, veja a visão geral do SDK do Agente 365.
Como o SDK do Agent 365 difere do SDK de Agentes do Microsoft 365?
O SDK de Agentes do Microsoft 365 constrói agentes conversacionais, lidando com a conectividade do canal e o estado da conversa. O SDK do Agente 365 estende um agente que você já construiu. Os dois trabalham juntos. Veja a visão geral do SDK do Agente 365.
Quais linguagens o SDK suporta?
Python, JavaScript e .NET. Veja os pacotes SDK do Agente 365.
Escolha de um mecanismo de integração
Preciso do SDK?
Nem sempre. Se integração embutida ou sincronização de registro já fornecem as capacidades que seu agente precisa, talvez você não precise do SDK. Veja Escolha a opção de integração.
Quando a integração embutida é suficiente?
Quando a plataforma já oferece os recursos do Agent 365 necessários para o seu cenário. Copilot Studio e Fábrica de IA do Azure podem se encaixar nessa categoria, mas o suporte depende de como o agente é construído, autenticado e hospedado. Possuir ou implantar código não exige o SDK, por si só. Veja Comparar mecanismos de integração do Agente 365.
Qual é a diferença entre sincronização de registro e integração com SDK?
A sincronização de registros traz agentes de plataformas conectadas, como Google Vertex AI e Amazon Bedrock, para o Agent 365 por meio da configuração em nível de plataforma. A integração com SDK é para agentes que você constrói com um SDK ou framework de agentes, e isso te dá controle em nível de código. Veja Comparar mecanismos de integração do Agente 365.
Meu agente funciona fora do Azure. Ainda posso usar o SDK?
Sim. O SDK não muda onde seu agente opera. Ele trabalha com agentes hospedados no Azure, AWS, Google Cloud ou on-premises. Veja o ciclo de vida de desenvolvimento do Agent 365.
Capabilities
Preciso adotar as quatro capacidades?
Não, mas eles têm pré-requisitos. Um modelo de identidade do agente serve de base para os recursos de identidade, ferramentas e notificações, e as notificações também exigem uma conta de usuário do agente, disponível apenas para locatários que participam do programa de versão prévia do Frontier. Observabilidade também funciona com um registro padrão de aplicativo Microsoft Entra. Além disso, adicione capacidades em qualquer ordem. Veja Verificar notificações.
Com qual capacidade devo começar?
Identidade. O registro é o que torna o agente visível no Agente 365, então comece por aí. Adicione observabilidade em seguida, quando precisar de visibilidade operacional. Veja Registrar o agente e o Instrumento para observabilidade.
Para onde vai minha telemetria?
Os spans de agente aparecem no Microsoft Defender, no Microsoft Purview e no centro de administração do Microsoft 365.
Duas coisas podem fazer a telemetria parecer que desapareceu, mesmo que a ingestão retorne HTTP 200.
Se nenhum usuário do tenant tiver uma licença Microsoft 365 E7 ou Microsoft Agent 365 atribuída, toda a solicitação é cancelada.
Se a execução não tiver um span válido invoke_agent na raiz, os spans ainda poderão ser consultados na caça avançada do Defender, mas não aparecerão em nenhuma das três interfaces.
Veja Onde aparecem os dados de observabilidade do Agente 365 e Limites e condições de queda.
O que é o QI de Trabalho?
Work IQ é o conjunto de servidores MCP governados que expõem cargas de trabalho do Microsoft 365, como Mail, Calendário, Word, SharePoint e Teams, ao seu agente sob controle administrativo. O Work IQ MCP está em prévia e exige uma licença Microsoft 365 Copilot. Veja Verificar ferramentas.
Quais fontes de notificação são suportadas?
Teams, Outlook, comentários no Word e e-mail. As notificações exigem uma conta de usuário de agente, disponível apenas para locatários que participam do programa de versão prévia do Frontier. Veja Tipos de notificações e Verificar notificações.
Identity
Meu agente precisa de identidade própria?
Toda integração com o Agent 365 precisa de um modelo de identidade, mas isso nem sempre significa dar ao agente sua própria conta de usuário. O agente pode usar S2S para atuar como sua identidade de agente, OBO para atuar em nome de um usuário conectado ou Agentic-User para atuar por meio de sua própria conta de usuário do Microsoft Entra. Escolha o modo que corresponde ao trabalho do agente, permissões e recursos necessários do Microsoft 365. Veja Identidade do Agente.
Qual é a diferença entre um modelo de identidade de agente e uma identidade de agente?
O blueprint é o modelo reutilizável que contém as credenciais e permissões declaradas para um tipo de agente. A identidade de um agente é a conta com a qual um agente individual se autentica. Um único blueprint pode criar muitas identidades de agentes. Veja objetos de identidade e S2S, identidade de agente derivada do Blueprint.
Onde estão guardadas as credenciais do meu agente?
No projeto, não na identidade do agente. Como um blueprint comprometido afeta todos os agentes criados a partir dele, trate a quantidade de blueprints como uma decisão de delimitação de segurança. Veja Identidade do Agente.
Quantos projetos devo criar?
Quantas forem necessárias para manter separadas as fronteiras entre credenciais e permissões. Agrupe apenas as identidades de agente que possam compartilhar com segurança as credenciais e as permissões herdadas do blueprint. Veja A base da identidade e S2S, identidade de agente derivada do Blueprint.
Qual modelo de permissão devo usar?
Permissões de aplicativo para comunicação entre serviços, em que o agente atua com suas próprias permissões. Permissões delegadas para operações em nome de terceiros, em que o agente atua com as permissões e o contexto de um usuário conectado. Veja Identidade do Agente.
Meu agente precisa de uma licença do Microsoft 365?
Somente se ele tiver a conta de usuário de um agente e precisar de serviços como Teams, Exchange ou SharePoint. Agentes com sua própria conta de usuário estão disponíveis apenas para locatários no programa de versão preliminar do Frontier. O licenciamento no nível do tenant ainda se aplica a outros recursos: a telemetria é descartada, a menos que pelo menos um usuário no tenant tenha uma licença Microsoft 365 E7 ou Microsoft Agent 365 atribuída, e o Work IQ MCP exige uma licença do Microsoft 365 Copilot. Veja a conta de usuário do Agente, Verificar identidade, Verificar observabilidade e Verificar as ferramentas.
Por que a caixa de correio do meu agente ainda não está disponível?
O provisionamento de recursos pode atrasar a cessão de licenças. Consulte a lista de verificação de validação do SDK do Agente 365 para os tempos esperados.
O que é um patrocinador?
O representante comercial responsável pelo propósito e pelo ciclo de vida do agente. Pelo menos um patrocinador é necessário para cada identidade de agente e blueprint de identidade de agente. Equipes de segurança usam o patrocinador para alcançar um humano responsável durante um incidente. Veja Patrocinadores e Verifique identidade.
Configuração e Habilidades
O que são as Habilidades do Agente 365?
Uma forma de ter um assistente de programação, como o GitHub Copilot CLI, para realizar as etapas de integração para você. Veja Habilidades do Agente 365.
O que substituiu o fluxo de trabalho de configuração do instructions.md?
O Agent 365 Skills substituiu esse fluxo de trabalho. Use Habilidades, em vez disso.
Se o seu assistente de codificação disponibilizar a capacidade interna Validar & Diagnosticar, você poderá pedir que ele valide a integração do Agent 365; ela também é chamada internamente de a365-code-validator.
A disponibilidade depende do assistente e do pacote de habilidades instalado. Veja Habilidades do Agente 365.
Preciso usar Habilidades?
Não. Você pode realizar cada etapa manualmente. Habilidades se adequam a configurações padrão e onboarding repetível; Configuração manual é adequada para ambientes não padronizados e solução de problemas. Veja Quando usar Habilidades.
É seguro usar uma habilidade mais de uma vez?
Sim. As habilidades são aditivas e idempotentes, então etapas concluídas são puladas em vez de duplicadas. Veja Segurança e repetibilidade.
Uma habilidade pareceu pular um passo. Isso é um problema?
Geralmente não. As habilidades ignoram o trabalho que já está configurado. Execute a habilidade específica novamente e declare o resultado explicitamente se quiser confirmar. Veja Segurança e repetibilidade.
Posso testar antes de implantar na nuvem?
No caminho do colega de equipe de IA, sim.
A habilidade test-local executa seu agente ao lado do Agents Playground, um ambiente local de testes, para testes de fumaça.
O Agents Playground se conecta pelo endpoint de mensagens do agente, então não se aplica aos agentes padrão.
Veja Habilidades Disponíveis do Agente 365 e Agente de Teste no Agents Playground.
Validation
Como posso confirmar se a integração funcionou?
Meu agente se comporta de forma diferente após a integração. O que deu errado?
O SDK estende seu agente em vez de substituir qualquer parte dele. Investigue qualquer mudança de comportamento antes de implantar: código gerado, conflitos de dependência, configuração e compatibilidade com SDK são todas causas possíveis. Comece com Verificar o comportamento existente.