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.
Os testes são uma parte importante do processo de desenvolvimento de agentes declarativos para Microsoft 365 Copilot Chat. Pode utilizar o modo de programador ao testar o agente para verificar se e como o orquestrador copilot seleciona as suas origens de conhecimento para utilização em resposta a determinados pedidos.
Além disso, pode utilizar a funcionalidade Pré-visualizar a sua aplicação (F5) no Toolkit de Agentes do Microsoft 365 para testar os agentes num ambiente de desenvolvimento local. Esta funcionalidade fornece uma forma interativa de validar o comportamento e resolver problemas diretamente a partir da interface de desenvolvimento.
Utilizar o modo de programador no Copilot Chat e no Toolkit de Agentes
Pode testar o agente a partir do Toolkit de Agentes no Visual Studio Code ao selecionar Pré-visualizar a sua aplicação (F5) no painel Toolkit de Agentes. Esta ação inicia o agente numa experiência de Copilot Chat baseada no browser, permitindo-lhe validar rapidamente o seu comportamento em resposta a pedidos.
Depois de selecionar o agente no Microsoft 365 Copilot Chat, ative o modo de programador ao escrever -developer on. Para desativar o modo de programador, escreva -developer off.
Enquanto o modo de programador está ativado, um card com informações de depuração devolve sempre que o orquestrador procura nos seus conhecimentos empresariais (dados), capacidades ou competências (ações ou plug-ins) no seu agente. No Toolkit do Agente, estas informações de depuração são apresentadas no painel Depurar e incluem os seguintes campos:
- Metadados do agente: identificadores para o agente e conversação
- Capacidades: uma lista de capacidades configuradas para o agente, juntamente com as respetivas estatísticas de status de execução e resposta (se executadas)
-
Ações: uma lista de ações configuradas para o agente
- Funções correspondidas: status de funções correspondidas na pesquisa do índice da aplicação de runtime
- Funções selecionadas para execução: status de funções selecionadas para invocação com base no raciocínio do orquestrador
Secção metadados do agente
Os metadados do agente fornecem detalhes chave sobre o agente e a sessão de depuração atual, incluindo:
- Resumo – uma descrição geral de alto nível das origens de conhecimento configuradas e das respetivas estatísticas de utilização
- ID do Agente – um identificador exclusivo para o agente, que inclui o ID do título e o ID do manifesto
- Versão do agente – o número da versão do agente atualmente em utilização
- ID de Conversação – Identificador da conversação ou sessão de chat ativa
- ID do Pedido – identificador para o pedido específico na conversação
Capacidades do agente
A secção de capacidades do agente apresenta as capacidades configuradas para o agente, definindo o âmbito das respetivas origens de conhecimento acessíveis. Os seguintes detalhes são fornecidos para cada capacidade utilizada pela linha de comandos.
- Status de execução – indica se a capacidade foi utilizada durante a orquestração
- Ficheiro de registo de diagnóstico – um ficheiro de .txt transferível que contém resultados de execução detalhados, incluindo mensagens de êxito ou de falha, que podem ajudar na resolução de problemas e validação
Ações do agente
A secçã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. Estas informações estão divididas em três áreas principais: metadados de ação, correspondência e seleção de funções e detalhes de execução.
Metadados de ação
Esta secção apresenta informações gerais sobre as ações registadas para o agente. Estas informações incluem o 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 utilização).
Correspondência e seleção de funções
Esta parte mostra como o orquestrador interpretou a linha de comandos do utilizador e se as funções foram consideradas relevantes para a execução:
Funções correspondidas – funções que correspondem semanticamente à linha de comandos do utilizador durante a pesquisa do índice da aplicação de runtime. Se não forem devolvidas funções correspondentes para o pedido indicado, é provável que o pedido não tenha menção explicitamente o nome da ação.
Funções selecionadas para execução – funções escolhidas para invocação com base no raciocínio e relevância do orquestrador para o pedido. Se não tiverem sido ativadas ações, a secção de ações indica que não existem ações ativadas.
Detalhes da execução
Os detalhes de execução da ação incluem a função e o respetivo status, juntamente com a latência, informações do pedido (ponto final do pedido, método HTTP, cabeçalhos de pedido) e a resposta.
Resolver problemas de falhas
Seguem-se falhas comuns que poderá encontrar quando depura o agente e possíveis causas para as falhas.
Sem informações de depuração
Depois de iniciar o agente, marcar que a ligação ao browser é marcada como sendo 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 ligação for bem-sucedida, mas não vir informações de depuração, poderá dever-se ao facto de o orquestrador não exigir que os seus dados ou competências do Microsoft 365 respondam. Neste caso, não são devolvidas informações de depuração card.
As informações de depuração também não são devolvidas em casos de limitação de capacidade, onde normalmente vê uma mensagem de erro para tentar novamente mais tarde.
Depurar informações com Nenhuma função selecionada para execução
Se nenhuma função de ação corresponder à intenção de pesquisa do pedido, as informações de depuração card relatórios Nenhuma função selecionada para execução. A causa é provável que a descrição do comando no manifesto não esteja semanticamente relacionada com a intenção de pesquisa do pedido especificado.
Se Copilot tiver correspondido anteriormente e executado as suas funções com êxito, os pedidos poderão ser limitados.
Depurar informações com detalhes de execução Sem Função vazios ou falhados
Para plug-ins de API, se ocorrerem falhas ou não existirem detalhes de execução da função, indica uma falha durante a tentativa do agente de atribuir parâmetros à função selecionada do plug-in. Se a falha for consistente, provavelmente deve-se a descrições de parâmetros ou ações pouco claras, URLs de anfitrião inválidos ou outros problemas com a definição da API Aberta.
Para plug-ins de extensão de mensagens, a melhor prática é otimizar para respostas em menos de nove segundos. Para obter mais informações, veja os requisitos técnicos dos plug-ins de extensão de mensagens.
Atualmente, o limite de tempo limite para a execução de Copilot de uma API de plug-in está definido em 10 segundos.
Comunicar um problema
Comunique comentários ou problemas com o agente com o botão polegar para cima ou polegar para baixo. Inclua a #extensibility etiqueta no seu relatório.
