Lista de verificação de validação do SDK do Agente 365

Use esta lista de verificação de validação do SDK do Agente 365 após integrar um agente e antes de implantá-lo. É a última etapa no caminho de integração: As Habilidades do Agente 365 ou a configuração manual aplicam a integração. Essas verificações ajudam a confirmar se cada capacidade funciona, para que você possa ser implantado com confiança.

Se seu assistente de codificação expor a capacidade interna de Validar e Diagnosticar o Agente 365, também chamada de a365-code-validator, você pode pedir para validar essa integração com o Agente 365 para um pré-voo em nível de código. Ele verifica o projeto em busca de lacunas na instrumentação, artefatos do Microsoft Entra, mensagens, acesso à ferramenta e configuração relacionada. Disponibilidade e invocação dependem do assistente e do pacote de Habilidades. Use a lista de verificação para confirmar as descobertas no ambiente que você tem como objetivo. O validador não substitui testes de ponta a ponta ou revisão de plataforma.

As seções de capacidades são independentes, então pule qualquer capacidade que você não tenha adotado. As seções de comportamento, configuração e implantação se aplicam a todas as integrações.

Siga este checklist se você:

  • Incorporei um agente e quero confirmar a integração antes de ser implantado.
  • Adicionou uma capacidade a um agente que você já integrou.
  • Herdei um agente de outra equipe e preciso estabelecer o que está configurado.

Verificar o comportamento existente

O SDK estende seu agente, então a integração não deve mudar como o agente já funciona.

  • O agente começa sem novos erros.
  • O agente responde a uma solicitação normal como fazia antes da integração.
  • Chamadas de modelo, orquestração e execução de ferramentas se comportam como antes.

Note

Se o comportamento central mudou, investigue antes de implantar. Código gerado, conflitos de dependências, configuração e compatibilidade com SDKs são todas causas possíveis. Consulte Solucionar problemas.

Verificar identidade

  • O blueprint de identidade do agente está registrado na Microsoft Entra.
  • Existe uma identidade de agente, criada a partir desse projeto. A make-a365-agent habilidade cria isso no caminho padrão do agente e make-ai-teammate no caminho dos companheiros de equipe da IA; veja Início Rápido: Conecte um agente existente ao Agente 365.
  • Pelo menos um patrocinador é designado.
  • Se o agente exigir uma conta de usuário, essa conta existe e está vinculada à identidade do agente.
  • Se o agente tiver uma conta de usuário, as licenças necessárias são atribuídas e recursos dependentes, como uma caixa de correio, são provisionados.
  • Permissões de API e escopos do Microsoft Graph são concedidos e definidos corretamente.
  • O agente autentica e age sob a identidade esperada.

Importante

Agentes com conta de usuário própria estão disponíveis apenas para locatários que participam do programa de pré-visualização da Frontier. Pule as verificações de conta de usuário se seu inquilino não estiver registrado.

Note

Depois que você atribui as licenças, o provisionamento de recursos para uma conta de usuário normalmente é concluído em 10 a 15 minutos, mas pode levar até 24 horas.

Verificar observabilidade

  • Pelo menos um usuário no tenant tem uma licença Microsoft 365 E7 ou Microsoft Agent 365 atribuída. Sem essa licença, a telemetria é descartada mesmo que a ingestão retorne HTTP 200.
  • Os pacotes de observabilidade são instalados e configurados.
  • Uma solicitação de teste gera spans para invocação de agentes, execução de ferramentas e inferência.
  • A passagem tem um vão válido invoke_agent em sua raiz. Sem uma, os vãos continuam consultáveis na caça avançada do Defender, mas não alcançam as três superfícies.
  • A telemetria aparece no Microsoft Defender, Microsoft Purview e no Centro de administração do Microsoft 365.
  • Atributos de expansão correspondem às operações que você espera.

Verificar ferramentas

Complete esta seção se o agente invocar servidores do Protocolo de Contexto Modelo (MCP).

  • Uma licença Microsoft 365 Copilot está disponível no tenant. O Work IQ MCP está em prévia e exige um.
  • O agente descobre os servidores MCP aos quais deveria ter acesso.
  • Uma invocação de ferramenta de teste é bem-sucedida de ponta a ponta.
  • O tempo de execução do agente detecta uma falha na ferramenta, retorna um erro controlado e permanece disponível.

Verifique notificações

Complete esta seção se o agente receber notificações.

  • O agente recebe notificações das fontes configuradas, como Teams, Outlook, comentários no Word ou e-mail.
  • O agente responde a uma notificação de teste conforme projetado.

Importante

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. Pule essa seção se seu inquilino não estiver inscrito.

Verificar a configuração

  • Armazene credenciais e segredos de forma segura e não os comprometa com controle de versão.
  • Separe os ambientes de desenvolvimento, teste e produção.
  • Garanta que a integração funcione no seu host alvo.

Confirmar prontidão para o desdobramento

  • Todas as verificações aplicáveis passam.
  • Execute pelo menos um teste de ponta a ponta em um ambiente não de produção.
  • Verifique a telemetria após a implantação para confirmar a saúde do agente.

Resolver verificações falhadas

Execute novamente a etapa de configuração relevante ou peça ao seu assistente de programação para completar a funcionalidade específica.

  • Verificações de identidade: veja Identidade do Agente.
  • Verificações de observabilidade, ferramentas e notificações: reexecute a habilidade de correspondência do Agent 365 Skills.

Para sintomas comuns e suas soluções, veja Solução de Problemas. Para sintomas específicos da configuração baseada em habilidades, veja a tabela de solução de problemas no Quickstart: Conecte um agente existente ao Agente 365.

Para respostas a perguntas relacionadas, veja Perguntas Frequentes do SDK do Agente 365.

Conteúdo relacionado

  • Last updated on