Painel de rastreamento no Agentforce Builder

Disponível em: Lightning Experience

Disponível em: Edições Enterprise, Performance, Unlimited e Developer. As licenças complementares necessárias variam de acordo com o tipo de agente.

Depois de enviar uma mensagem de teste, o Resumo da interação mostra cada evento no processo de tomada de decisão do agente como uma linha do tempo visual. Dependendo do caso de teste, os eventos incluem:

Compromisso	Descrição
Entrada: [mensagem]	A mensagem que iniciou esse turno
Motivo: [nome do agente]	A passagem de raciocínio do agente descrevendo o que ele decidiu fazer em seguida e por quê
Ação: [Rótulo da função]	Uma ação do agente que o agente acionou (fluxo, Apex etc.)
Transição para subagente: [agente de destino]	O agente encaminhou a conversa para um subagente no mesmo agente
Transição para agente: [nome do desenvolvedor]	O agente transferiu a conversa para um agente relacionado separado
Avaliação da saída: [categoria]	Avaliação da resposta do agente antes de ela ser devolvida ao usuário
Avaliação da ferramenta MCP: [nome do agente]	Uma ferramenta de MCP chama o agente avaliado

Selecione qualquer evento no Resumo da interação para abrir sua exibição de detalhes na guia Rastrear. A guia Rastrear mostra um detalhamento de cada milissegundo desse evento, com barras de tempo para cada suboperação. Faça drill down em uma duração individual para ver seus dados de saída completos e exatamente o que o agente recebeu e retornou nesse ponto.

A subguia Variáveis mostra o estado de cada variável em cada ponto de decisão na sessão. Cada evento mostra o valor antes da execução e o valor após a conclusão do evento. Por exemplo, uma alteração booleana de Falso para Verdadeiro após uma verificação de condição ser aprovada. Use a subguia Variáveis para:

• Verifique se os dados corretos alcançaram uma ação do agente ou modelo de prompt
• Confirme se a variável correta foi atualizada após a conclusão da ação
• Identifique onde na sessão uma variável recebeu um valor inesperado

Defina valores iniciais ou de substituição em Variáveis de contexto antes de iniciar o teste e use variáveis durante a sessão para rastrear como esses valores evoluem.

Em qualquer etapa de Reasoning, a guia Rastrear mostra a solicitação exata enviada ao LLM. Use estas informações para entender:

• Que contexto o agente tinha quando selecionou um subagente ou decidiu acionar uma ação do agente
• Se o aviso continha os valores de variável e as instruções que você esperava
• Por que o raciocínio do agente levou a um resultado inesperado

Ao analisar um rastreamento, faça perguntas ao Assistente do Agentforce integrado sobre o que você está vendo. Por exemplo, "Explique o aviso gerado nesta etapa de raciocínio" ou "Como posso corrigir o agente para lidar com esse caso?"

Revise todas as correções sugeridas cuidadosamente antes de aplicá-las. As sugestões às vezes fazem referência a ações do agente ou fluxos que não existem em sua organização, portanto, verifique antes de fazer alterações.

Aqui estão alguns dos problemas de depuração mais comuns e etapas para resolvê-los.

Compromisso	Resolução
Uma ação do agente não foi acionada	Abra a etapa de Motivo imediatamente antes da ação esperada. Revise o aviso gerado para ver se o agente tinha o contexto necessário para chamar a ação. Em seguida, verifique se um FunctionStep (Action) aparece após a etapa de Motivo. Caso contrário, o agente decidiu não acionar a ação com base no contexto disponível.
Uma transição inesperada de subagente ocorreu	Localize o TransitionStep no Resumo da interação. Expanda a etapa de Mocionamento antes dela para ver qual contexto levou o agente à transição. Confirme se a configuração do Roteador do agente corresponde à intenção expressa pela sua mensagem de teste.
A saída não correspondeu às expectativas	Marque o OutputEvaluationStep no fim da sequência. Em seguida, trabalhe para trás nas etapas de Mocionamento e na subguia Variáveis para identificar onde a decisão do agente divergia do que você esperava.