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 Microsoft 365 Copilot. Pode utilizar o modo de programador no Copilot Studio para testar o agente e verificar se e como o orquestrador copilot seleciona as suas origens de conhecimento para utilização em resposta a determinados pedidos.
Utilizar o modo de programador no Copilot
Para ativar o modo de programador no 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), capacidades ou competências (ações ou plug-ins) no seu agente para responder a um pedido. O cartão de informações de depuração inclui os seguintes campos:
- Metadados do agente: identificadores para o agente e conversação.
- Capacidades: uma lista de capacidades configuradas para o agente.
-
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
-
Execução: uma lista de capacidades e ações executadas para a linha de comandos
- Capacidades executadas: status e estatísticas de resposta para capacidades executadas.
- Ações executadas: status de execução de pedidos e respostas para ações.
Secção metadados do agente
Os metadados do agente fornecem detalhes chave 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 de 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 – identifica a conversa ou sessão de chat ativa.
- ID do Pedido – identifica o pedido específico na conversação.
Capacidades do agente
A secção Capacidades do Agente apresenta as capacidades configuradas para o agente, definindo o âmbito das respetivas origens de conhecimento acessíveis.
Importante
Se a secção Capacidades do Agente indicar que a Pesquisa Web está ativada, isto significa apenas que o agente ativou a capacidade. Não reflete a definição de política da cloud que os Allow web search in Copilot administradores podem utilizar para desativar a pesquisa na Web da organização. Para obter mais informações, veja Manage Microsoft 365 Copilot scenarios in the Centro de administração do Microsoft 365 (Gerir cenários de Microsoft 365 Copilot no Centro de administração do Microsoft 365).
Ações do agente
As ações do agente apresentam o ID da ação e o número da versão, as funções configuradas para a ação, juntamente com os respetivos status de correspondência e seleção.
Cartão sem ações Não ativadas
Se não tiverem sido ativadas ações, a secção de ações indica que não existem ações ativadas.
Cartão com funções Sem Correspondência
Se não forem devolvidas funções correspondentes para o pedido indicado, isto provavelmente indica que o pedido não menção explicitamente o nome da ação.
Detalhes da execução
As secções de detalhes executadas mostram se e quais das capacidades ou ações configuradas foram executadas para o pedido e os detalhes de execução e status.
Detalhes da execução da capacidade
Os detalhes de execução da capacidade apresentam a capacidade executada e o respetivo 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
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.
Cartão sem funções selecionadas 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. 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 Copilot tiver correspondido anteriormente e executado as suas funções 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, 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.
Resolver problemas de falhas
Seguem-se falhas comuns que poderá encontrar quando depura o agente 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.
Comunicar um problema
Comunique comentários ou problemas com o agente com o botão polegar para cima ou polegar para baixo. Inclua a etiqueta #extensibility no seu relatório.
Introduza uma mensagem, incluindo a etiqueta #extensibility, na caixa de texto.
