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.
O teste é uma parte importante do processo de desenvolvimento de agentes declarativos para o Microsoft 365 Copilot Chat. Você pode usar o modo de desenvolvedor ao testar seu agente para verificar se e como o orquestrador do Copilot seleciona suas fontes de conhecimento para uso em resposta a determinados prompts.
Além disso, você pode usar o recurso Visualizar seu aplicativo (F5) no Microsoft 365 Agents Toolkit para testar seus agentes em um ambiente de desenvolvimento local. Esse recurso fornece uma maneira interativa de validar o comportamento e solucionar problemas diretamente da interface de desenvolvimento.
Usar o modo de desenvolvedor no Copilot Chat e no Agents Toolkit
Você pode testar seu agente no Agents Toolkit no Visual Studio Code selecionando Visualizar seu aplicativo (F5) no painel Agents Toolkit. Isso inicia seu agente em uma experiência de Copilot Chat baseada em navegador, permitindo que você valide rapidamente como ele se comporta em resposta a prompts.
Depois de selecionar seu agente no Microsoft 365 Copilot Chat, habilite o modo de desenvolvedor digitando -developer on. Para desabilitar o modo de desenvolvedor, digite -developer off.
Enquanto o modo de desenvolvedor está habilitado, um card com informações de depuração retorna sempre que o orquestrador pesquisa seu conhecimento corporativo (dados), recursos ou habilidades (ações ou plug-ins) em seu agente. No Kit de ferramentas do agente, essas informações de depuração aparecem no painel Depurar e incluem os seguintes campos:
- Metadados do agente: identificadores para o agente e a conversa
- Recursos: uma lista de recursos configurados para o agente, juntamente com seu status de execução e estatísticas de resposta (se executados)
-
Ações: Uma lista de ações configuradas para o agente
- Funções correspondentes: o status das funções correspondeu na pesquisa de índice do aplicativo de runtime
- Funções selecionadas para execução: status das funções selecionadas para invocação com base no raciocínio do orquestrador
Seção de metadados do agente
Os metadados do agente fornecem detalhes importantes sobre o agente e a sessão de depuração atual, incluindo:
- Resumo - Uma visão geral de alto nível das fontes de conhecimento configuradas e suas estatísticas de uso
- ID do agente - Um identificador exclusivo para o agente, que inclui a ID do título e a ID do manifesto
- Versão do agente – O número da versão do agente atualmente em uso
- Conversation ID - Identificador para a sessão de chat ativa ou conversa
- ID da solicitação - Identificador para o prompt específico dentro da conversa
Recursos do agente
A seção de recursos do agente exibe os recursos configurados para o agente, definindo o escopo de suas fontes de conhecimento acessíveis. Os detalhes a seguir são fornecidos para cada funcionalidade usada pelo prompt.
- status de execução – indica se a funcionalidade foi usada durante a orquestração
- Arquivo de log de diagnóstico – um arquivo de .txt para download contendo resultados de execução detalhados, incluindo mensagens de sucesso ou falha, que podem ajudar na solução de problemas e validação
Ações do agente
A seção Ações do agente fornece informações detalhadas sobre como as ações do agente (funções ou plug-ins) são processadas durante a orquestração. Essas informações são divididas em três áreas principais: metadados de ação, correspondência e seleção de função e detalhes de execução.
Metadados de ação
Esta seção exibe informações gerais sobre as ações registradas para seu agente. Essas informações incluem a ID da Ação (o identificador exclusivo da ação) e o número da versão (a versão da definição de ação em uso).
Seleção e correspondência de função
Esta parte mostra como o orquestrador interpretou o prompt do usuário e se alguma função foi considerada relevante para a execução:
Funções correspondentes – funções que correspondem semanticamente ao prompt do usuário durante a pesquisa de índice do aplicativo em tempo de execução. Se nenhuma função correspondente foi retornada para o prompt fornecido, é provável que o prompt não tenha mencionado explicitamente o nome da ação.
Funções selecionadas para execução – funções escolhidas para invocação com base no raciocínio e na relevância do orquestrador para o prompt. Se nenhuma ação foi habilitada, a seção de ações indica que não há ações habilitadas.
Detalhes da execução
Os detalhes de execução da ação incluem a função e seu status, juntamente com a latência, as informações da solicitação (ponto de extremidade da solicitação, método HTTP, cabeçalhos da solicitação) e a resposta.
Solucionar problemas de falhas
A seguir estão falhas comuns que você pode encontrar ao depurar seu agente e possíveis causas para as falhas.
Nenhuma informação de depuração
Depois de iniciar seu agente, marque se a conexão com o navegador está marcada como bem-sucedida no painel de depuração. Se não estiver, tente executar F5 novamente no Visual Studio Code para iniciar uma nova sessão.
Se a conexão for bem-sucedida, mas você não vir informações de depuração, pode ser porque o orquestrador não exige que seus dados ou habilidades do Microsoft 365 respondam. Nenhum card de informações de depuração é retornado nesse caso.
As informações de depuração também não são retornadas em casos de limitação de capacidade, em que você normalmente vê uma mensagem de erro para tentar novamente mais tarde.
Informações de depuração sem nenhuma função selecionada para execução
Se nenhuma função de ação corresponder à intenção de pesquisa do prompt, o card informações de depuração relatará Nenhuma função selecionada para execução. A causa é provável que a descrição do comando no manifesto não esteja semanticamente relacionada à intenção de pesquisa do prompt fornecido.
Se o Copilot correspondeu anteriormente e executou suas funções com êxito, as solicitações podem ser limitadas.
Informações de depuração com vazio ou com falha Sem detalhes de execução de função
Para plug-ins de API, se houver detalhes de execução de função com falha ou nenhum detalhe, isso indica uma falha durante a tentativa do agente de atribuir parâmetros à função selecionada do plug-in. Se a falha for consistente, provavelmente será devido a descrições de ação ou parâmetro pouco claras, URLs de host inválidos ou outros problemas com sua definição de API aberta.
Para plug-ins de extensão de mensagem, a prática recomendada é otimizar para respostas em menos de nove segundos. Para obter mais informações, examine os requisitos técnicos para plug-ins de extensão de mensagem.
Atualmente, o limite de tempo limite para a execução do Copilot de uma API de plug-in é definido em 10 segundos.
Como relatar um problema
Relate qualquer feedback ou problema com seu agente usando o botão de polegar para cima ou para baixo. Inclua a #extensibility marca no seu relatório.
