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?
No. 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?
No. Seu agente continua fazendo suas próprias chamadas de 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?
No. 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?
No. Os registradores SDK governavam servidores do Protocolo de Contexto Modelo (MCP); A execução fica no seu tempo de execução. Veja o SDK do Agente 365 e o ecossistema do agente.
O SDK substitui meu framework de agentes?
No. 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 o caminho da plataforma já fornece as capacidades do Agente 365 exigidas pelo 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 do Agente 365 Desenvolvimento do Agente.
Capabilities
Preciso adotar as quatro capacidades?
Não, mas eles têm pré-requisitos. Um blueprint de identidade do agente sustenta as capacidades de identidade, ferramentas e notificações, e as notificações também exigem a conta de usuário do agente, disponível apenas para locatários que participam do programa de pré-visualização 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.
Qual capacidade devo usar?
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 Agentes aparecem no Microsoft Defender, 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 sequência não tiver um vão válido invoke_agent em sua raiz, os vãos ainda podem ser consultados no Defender advanced hunt, mas não aparecem em nenhuma das três superfícies.
Veja onde seus dados aparecem 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 a conta de usuário de um agente, que está disponível apenas para inquilinos que participam do programa de visualização 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 agir em nome de um usuário logado, ou Agentic-User para agir por meio de sua própria conta Microsoft Entra usuário. 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 blueprint 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 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 o número de blueprints como uma decisão de limite de segurança. Veja Identidade do Agente.
Quantos projetos devo criar?
Quantas for preciso manter os limites de credencial e permissão separados. Identificar apenas agentes em grupo que possam compartilhar com segurança as credenciais e permissões herdadas do blueprint. Veja A fundação de identidade e S2S, Identidade de agente derivada do Blueprint.
Qual modelo de permissão devo usar?
Permissões de aplicação para trabalho de serviço-a-serviço, onde o agente age com suas próprias permissões. Permissões delegadas para trabalhos em nome do trabalho, onde o agente age com as permissões e o contexto do usuário logado. 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 conta de usuário própria estão disponíveis apenas para inquilinos no programa de visualização Frontier. O licenciamento em nível de locatário ainda se aplica a outras capacidades: a telemetria é cancelada a menos que pelo menos um usuário do tenant tenha uma licença Microsoft 365 E7 ou Microsoft Agent 365 atribuída, e o Work IQ MCP exige uma licença 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 instructions.md?
O Agent 365 Skills substituiu esse fluxo de trabalho. Use Habilidades, em vez disso.
Se seu assistente de codificação expor a capacidade interna de Validar & Diagnosticar, você pode pedir para validar a integração com o Agente 365; também é referido internamente como a365-code-validator.
A disponibilidade depende do assistente e do pacote de habilidades instalado. Veja Habilidades do Agente 365.
Preciso usar Habilidades?
No. 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. Habilidades pulam trabalhos que já estão configurados. 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 dos companheiros de equipe da IA, sim.
A test-local habilidade roda seu agente junto com o Agents Playground, um arnês de teste local, 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 As sete habilidades e o agente de teste no Agents Playground.
Validation
Como posso confirmar se a integração funcionou?
Trabalhe pela lista de validação do SDK do Agente 365.
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.