Depurar um agente com o modo de programador

Pode utilizar o modo de programador ao testar o agente para verificar se e como o orquestrador copilot seleciona os plug-ins para utilização em resposta a determinados pedidos.

Utilizar o modo de programador Copilot

Para ativar o modo de programador, no Microsoft 365 Copilot, escreva -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 especificamente no seu conhecimento empresarial (dados) ou competências (plug-ins) no seu agente para responder a um pedido. O cartão de informações de depuração inclui os seguintes campos:

• Plug-ins ativados: uma lista de plug-ins ativado para o agente
• Funções correspondidas: uma lista de plug-ins e funções correspondentes na pesquisa do índice da aplicação de runtime
• Funções selecionadas para execução: uma lista de funções de plug-in selecionadas para invocação com base no raciocínio do orquestrador
• Detalhes da execução da função: execução da função de pedido e resposta status

Resolução de problemas de falhas

Seguem-se falhas comuns que poderá encontrar quando depura a seleção do plug-in e possíveis causas para as falhas.

Sem card de depuração

Se o orquestrador não exigir que os seus dados ou competências do Microsoft 365 respondam a um pedido, não são devolvidas informações de depuração card.

Os cartões de depuração também não são devolvidos em casos de limitação de capacidade, onde normalmente verá uma mensagem de erro para tentar novamente mais tarde.

Cartão sem plug-ins ativado

Se não tiverem sido ativados plug-ins, a secção Plug-ins ativados indica que não existem plug-ins ativados.

Cartão com funções Sem Correspondência

Se os plug-ins relevantes estiverem ativados, mas não forem devolvidas funções correspondentes para o pedido indicado, tal provavelmente indica que o pedido não menção explicitamente o nome do plug-in.

Cartão sem funções selecionadas para execução

Se nenhum plug-in ativado corresponder à intenção de pesquisa do pedido, as informações de depuração card relatórios Nenhuma função selecionada para execução. Isto deve-se provavelmente ao facto de a descrição do comando no manifesto não estar semanticamente relacionada com a intenção de pesquisa do pedido especificado.

Se o copilot estava anteriormente a corresponder e a executar as suas funções de plug-in com êxito, isto pode ser uma indicação de limitação.

Cartão com vazio ou sem detalhes de execução de Nenhuma Função

Para plug-ins de extensão que não sejam mensagens, 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, é provável que se dedique a descrições de plug-ins ou parâmetros pouco claros, URLs de anfitrião inválidos ou outros problemas com a definição de Open API.

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 copilot de uma API de plug-in está definido em 10 segundos.

Comunicar um problema

Comunique comentários ou problemas com o plug-in com o botão polegar para cima ou polegar para baixo. Inclua a etiqueta #extensibility no seu relatório. Selecione se coloca o polegar para cima ('Gosto de algo') ou polegares para baixo ('Não gosto de algo') logo após a resposta copilot

Em seguida, introduza uma mensagem que inclui a etiqueta #extensibility na caixa