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 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.
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
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
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
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
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
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.
Introduza uma mensagem, incluindo a etiqueta #extensibility, na caixa de texto.