Loading
IA generativa de Agentforce y Einstein
Panel de rastreo en Agentforce Builder

Panel de rastreo en Agentforce Builder

El panel Rastreo es el depurador de razonamiento integrado en la experiencia Vista previa y Prueba en vivo en Agentforce Builder. Muestra cómo tomó decisiones su agente, incluyendo subagentes seleccionados, qué acciones desencadenaron, cuándo se produjeron transiciones de temas y cómo cambiaron los valores de variables.

Ediciones necesarias

Disponible en: Lightning Experience
Disponible en: Enterprise Edition, Performance Edition, Unlimited Edition y Developer Edition. Las licencias complementarias requeridas varían según el tipo de agente.

Después de enviar un mensaje de prueba, el Resumen de interacciones muestra cada evento en el proceso de toma de decisiones del agente como una cronología visual. Dependiendo del caso de prueba, los eventos incluyen:

Evento Descripción
Entrada: [mensaje] El mensaje que inició este turno
Razonamiento: [nombre de agente] El razonamiento del agente pasa describiendo lo que decidió hacer a continuación y por qué
Acción: [etiqueta de función] Una acción de agente desencadenada por el agente (flujo, Apex, etc.)
Transición a subagente: [agente de destino] El agente transfirió la conversación a un subagente dentro del mismo agente
Transición a agente: [nombre del desarrollador] El agente transfirió la conversación a un agente relacionado separado
Evaluación de salida: [categoría] Evaluación de la respuesta del agente antes de devolverla al usuario
Evaluación de herramienta MCP: [nombre de agente] Una herramienta MCP llama al agente evaluado

Seleccione cualquier evento en el Resumen de interacciones para abrir su vista de detalles en la ficha Rastreo. La ficha Rastreo muestra un desglose de cada milisegundo de ese evento, con barras de tiempo para cada suboperación. Profundice en un intervalo individual para ver sus datos de salida completos y exactamente lo que el agente recibió y devolvió en ese punto.

La subficha Variables muestra el estado de cada variable en cada punto de decisión de la sesión. Cada evento muestra el valor antes de ejecutarse y el valor después de completar el evento. Por ejemplo, un cambio booleano de Falso a Verdadero después de pasar una comprobación de condición. Utilice la subficha Variables para:

  • Verificar que los datos correctos alcanzaron una acción de agente o plantilla de solicitud
  • Confirme que la variable correcta se actualizó tras completar la acción
  • Identificar en qué parte de la sesión una variable recibió un valor inesperado

Establezca valores iniciales o sustituya en Variables de contexto antes de iniciar su prueba, luego utilice variables durante la sesión para realizar un seguimiento de cómo evolucionan esos valores.

En cualquier paso de Razonamiento, la ficha Rastreo muestra la solicitud exacta enviada al LLM. Utilice esta información para comprender:

  • Qué contexto tenía el agente cuando seleccionó un subagente o decidió desencadenar una acción de agente
  • Si la solicitud contenía los valores de variable y las instrucciones que esperaba
  • Por qué el razonamiento del agente llevó a un resultado inesperado

Mientras revisa un rastreo, formule preguntas al Asistente de Agentforce integrado acerca de lo que está viendo. Por ejemplo, "Explicar la solicitud generada en este paso de razonamiento" o "¿Cómo puedo solucionar el caso del agente?"

Revise cualquier solución sugerida cuidadosamente antes de aplicarla. Las sugerencias a veces hacen referencia a acciones o flujos de agentes que no existen en su organización, por lo que verifique antes de realizar cambios.

Estos son algunos de los problemas de depuración más comunes y los pasos para resolverlos.

Evento Resolución
Una acción de agente no se desencadenó Abra el paso Razonamiento inmediatamente antes de la acción esperada. Revise la solicitud generada para ver si el agente tenía el contexto necesario para llamar a la acción. A continuación compruebe si un FunctionStep (Acción) aparece después del paso Razonamiento. Si no es así, el agente decidió no desencadenar la acción basándose en su contexto disponible.
Se produjo una transición de subagente inesperada Busque el Paso de transición en el Resumen de interacción. Amplíe el paso Razonamiento antes de él para ver qué contexto llevó al agente a la transición. Confirme si la configuración del Enrutador de agente coincide con la intención que expresó su mensaje de prueba.
Salida no coincide con las expectativas Compruebe el OutputEvaluationStep al final de la secuencia. A continuación trabaje hacia atrás a través de los pasos Razonamiento y la subficha Variables para identificar dónde la decisión del agente divergió de lo que esperaba.
 
Cargando
Salesforce Help | Article