Utilizar o modo de programador no Microsoft 365 Copilot para testar e depurar agentes

O teste é uma parte importante do processo de desenvolvimento de agentes declarativos para Microsoft 365 Copilot. Pode utilizar o modo de programador no Copilot Studio para testar o seu agente e verificar se e como o orquestrador do Copilot seleciona as suas fontes de conhecimento para utilizar em resposta a pedidos fornecidos.

Utilizar o modo de programador no Copilot

Para ativar o modo de programador no Copilot, escreva -developer on. Para desativar o modo de desenvolvedor, digite -developer off.

Captura de ecrã de Microsoft 365 Copilot sessão em que o utilizador escreveu

Enquanto o modo de programador estiver ativado, uma card com informações de depuração é disponibilizada sempre que o orquestrador efetuar pesquisas especificamente nos conhecimentos (dados), capacidades ou capacidades (ações ou plug-ins) da empresa para responder a um pedido. O card de informações de depuração inclui os seguintes campos:

  • Metadados do agente: identificadores para o agente e conversa.
  • Recursos: uma lista de recursos configurados para o agente.
  • Ações: uma lista de ações configuradas para o agente
    • Funções correspondentes: status de funções correspondentes na pesquisa de índice de aplicações em tempo de execução
    • Funções selecionadas para execução: status de funções selecionadas para invocação com base no raciocínio do orquestrador
  • Execução: uma lista de recursos e ações executadas para o prompt
    • Capacidades executadas: estatísticas de status e resposta para capacidades executadas.
    • Ações executadas: Execução de solicitações e respostas status para ações.

Secção de metadados do agente

Captura de ecrã de Microsoft 365 Copilot sessão em que o Copilot devolveu uma card com informações de depuração a mostrar os 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 o ID do título e o ID do manifesto.
  • Versão do agente – O número da versão do agente atualmente em uso.
  • ID da conversação - Identifica a sessão de chat ou conversação ativa.
  • ID do Pedido - Identifica o pedido específico na conversação.

Observação

O prefixo no ID do agente indica como o agente é distribuído:

  • U_ indica um agente com escopo de usuário (sideload).
  • T_ indica um agente do âmbito do inquilino (publicado no catálogo da loja inquilino ou da organização).
  • P_ indica um agente disponível publicamente.

Para obter orientações de publicação relacionadas, consulte:

Capacidades do agente

Captura de ecrã de Microsoft 365 Copilot sessão em que o Copilot devolveu uma card com informações de depuração que mostram as capacidades do agente configurado

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

Importante

Se a seção Capacidades do Agente indicar que o WebSearch está habilitado, isso significa apenas que o agente ativou o recurso. Não reflete a definição da política de nuvem que os Allow web search in Copilot administradores podem utilizar para desativar a pesquisa na Web na respetiva organização. Para obter mais informações, consulte Gerenciar cenários de Microsoft 365 Copilot no Centro de administração do Microsoft 365.

Ações do agente

Captura de ecrã de Microsoft 365 Copilot sessão em que o Copilot devolveu uma card com informações de depuração que mostram as ações do agente configurado

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 seus status de correspondência e seleção.

Cartão sem ações ativado

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

Cartão sem funções correspondentes

Se não forem devolvidas funções correspondentes para o pedido em questão, isto provavelmente indica que o pedido não menção explicitamente o nome da ação.

Detalhes da execução

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

Detalhes de execução de capacidades

Captura de ecrã de Microsoft 365 Copilot sessão em que o Copilot devolveu uma card com informações de depuração que mostram as capacidades executadas

Os detalhes de execução da capacidade mostram a capacidade executada e a sua status. Cada capacidade pode ter detalhes de execução diferentes, como o texto de pesquisa utilizado, a resposta da capacidade e/ou o número de resultados devolvidos.

Detalhes da execução da ação

Captura de ecrã de Microsoft 365 Copilot sessão em que o Copilot devolveu uma card com informações de depuração a mostrar as ações executadas

Os detalhes de execução da ação incluem a função e o respetivo status, juntamente com a latência, as informações do pedido (ponto final do pedido, método HTTP, cabeçalhos do pedido) e a resposta.

Cartão com Sem funções selecionadas para execução

Se nenhuma função de ação corresponder à intenção de pesquisa do prompt, 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 fornecido.

Se o Copilot tiver correspondido anteriormente e executado as suas funções com êxito, isto pode ser uma indicação de limitação.

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

Para plug-ins de extensão sem mensagem, se houver falha ou nenhum detalhe de execução de função, isso indica uma falha durante a tentativa do agente de atribuir parâmetros à função selecionada do plug-in. Se a falha for consistente, é mais provável que seja devido a uma ação pouco clara ou descrições de parâmetros, URLs de host inválidos ou outros problemas com sua definição de API Open.

Para plug-ins de extensão de mensagens, a melhor prática é otimizar para respostas com menos de nove segundos. Para obter mais informações, consulte os requisitos técnicos dos plug-ins de extensão de mensagens.

Atualmente, o limite de tempo limite para a execução do Copilot de uma API de plug-in está definido em 10 segundos.

Resolver problemas de falhas

Seguem-se falhas comuns que poderá encontrar ao depurar o seu agente e as possíveis causas para as falhas.

Sem card de depuração

Se o orquestrador não necessitar dos seus dados ou capacidades do Microsoft 365 para responder a um pedido, não serã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.

Comunicar um problema

Comunique quaisquer comentários ou problemas com o seu agente utilizando os botões polegar para cima ou polegar para baixo. Inclua a etiqueta #extensibility no seu relatório.

Captura de ecrã das opções de Microsoft 365 Copilot polegar para cima ou polegar para baixo

Introduza uma mensagem, incluindo a etiqueta #extensibility, na caixa de texto.

Captura de ecrã de Microsoft 365 Copilot feedback na caixa de texto