Usar o modo de desenvolvedor no Microsoft 365 Copilot para testar e depurar agentes

O teste é uma parte importante do processo de desenvolvimento de agentes declarativos para o Microsoft 365 Copilot. Você pode usar o modo de desenvolvedor no Copilot Studio para testar seu agente e verificar se e como o orquestrador do Copilot seleciona suas fontes de conhecimento para usar em resposta a determinados prompts.

Usar o modo de desenvolvedor no Copilot

Para habilitar o modo de desenvolvedor no Copilot, digite -developer on. Para desabilitar o modo de desenvolvedor, digite -developer off.

Enquanto o modo de desenvolvedor estiver habilitado, um card com informações de depuração retornará sempre que o orquestrador pesquisar especificamente em seu conhecimento corporativo (dados), recursos ou habilidades (ações ou plug-ins) em seu agente para responder a um prompt. O cartão de informações de depuração inclui os seguintes campos:

• Metadados do agente: identificadores para o agente e a conversa.
• Recursos: uma lista de recursos configurados para o agente.
• 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
• Execução: uma lista de recursos e ações executados para o prompt
  • Recursos executados: estatísticas de status e resposta para recursos executados.
  • Ações executadas: status de execução de solicitação e resposta para ações.

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:

• 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.
• ID da conversa - Identifica a sessão de chat ou conversa ativa.
• ID da solicitação - Identifica o prompt específico dentro da conversa.

Recursos do agente

A seção Recursos do agente exibe os recursos configurados para o agente, definindo o escopo de suas fontes de conhecimento acessíveis.

Ações do agente

As ações do agente exibem o ID da ação e o número da versão, as funções configuradas para a ação, juntamente com seu status de correspondência e seleção.

Cartão sem ações habilitadas

Se nenhuma ação foi habilitada, a seção de ações indica que não há ações habilitadas.

Cartão sem funções correspondentes

Se nenhuma função correspondente foi retornada para o prompt fornecido, isso provavelmente indica que o prompt não mencionou explicitamente o nome da ação.

Detalhes da execução

As seções de detalhes executados mostram se e quais dos recursos ou ações configurados foram executados para o prompt e os detalhes e o status da execução.

Detalhes de execução da funcionalidade

Os detalhes de execução da funcionalidade exibem a funcionalidade executada e seu status. Cada funcionalidade pode ter detalhes de execução diferentes, como o texto de pesquisa usado, a resposta da funcionalidade e/ou o número de resultados retornados.

Detalhes da execução da açã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.

Cartão sem funções selecionadas 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. Isso provavelmente ocorre porque a descrição do comando no manifesto não está semanticamente relacionada à intenção de pesquisa do prompt fornecido.

Se o Copilot correspondeu anteriormente e executou suas funções com êxito, isso pode ser uma indicação de limitação.

Cartão com vazio ou com falha Sem detalhes de execução de função

Para plug-ins de extensão que não são de mensagem, se houver falha ou nenhum detalhe de execução de função, isso indicará 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.

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.

Nenhum card de depuração

Se o orchestrator não exigir que seus dados ou habilidades do Microsoft 365 respondam a um prompt, nenhum card de informações de depuração será retornado.

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

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 marca #extensibility em seu relatório.

Insira uma mensagem, incluindo a marca #extensibility, na caixa de texto.

Conteúdo relacionado

• Criar agentes com o Copilot Studio
• Criar agentes com o Visual Studio Code
• Testar e depurar agentes no Microsoft 365 Agents Toolkit