Saltar al contenido principal

Registros

Usa los registros de agentes para inspeccionar lo que ocurrió después de iniciar la ejecución de un agente. En Fetch Hive, este es el lugar principal para revisar el estado de la ejecución, el uso del modelo, la actividad de las herramientas, el costo y el tiempo de las trazas fuera del editor.

Descripción general

Los registros de los agentes se encuentran en Logs, dentro de la sección de agentes. La página se centra en una tabla de ejecuciones. Al hacer clic en una fila, Fetch Hive abre un panel de detalle de la ejecución con métricas de resumen y datos de la traza. Esta página cubre las ejecuciones registradas, no la conversación temporal de prueba en Chat. Usa Chat en el editor para iterar sobre el comportamiento, luego usa Logs para inspeccionar las ejecuciones después.

¿Cómo abro los registros del agente?

  1. Abre Agents en la barra lateral.
  2. Haz clic en Logs dentro del menú de la sección de agentes.
Fetch Hive abre la tabla de registros del agente. En esta página, la barra lateral de agentes no muestra el grupo Categories ni agrega el patrón de filtro Source que se usa en los registros de prompts y de flujos de trabajo.

¿Qué se rastrea en la tabla de registros del agente?

La tabla principal de registros muestra campos de resumen para cada ejecución, incluyendo:
  • Completed At
  • Name
  • Model
  • Tools
  • Status
  • Total Tokens
  • Total Cost
  • Duration
  • API Key
  • Collaborator
La columna Tools muestra las fuentes de herramientas involucradas en la ejecución. Según la ejecución, esto puede incluir Google Search, GPT Search, xAI Web Search, X Search, Vector Search, SERP o Image Generation. Total Tokens incluye la respuesta del agente principal, las ejecuciones de subagentes y las llamadas a herramientas de generación de imágenes que reportan tokens. En el panel de detalle de la ejecución, pasa el cursor sobre el icono de información de tokens para ver el desglose por agente principal, generación de imágenes y subagentes.

¿Cómo filtro los registros del agente?

Usa el control de rango de fechas en el encabezado para elegir un rango personalizado o un preajuste disponible. Los preajustes incluyen rangos como Last 1 Day, Last 7 Days, Last 30 Days y Last 90 Days, pero los rangos más largos pueden requerir un plan con más historial de registros. Usa Provider, Model y API keys para acotar la tabla a las ejecuciones que te interesan. Usa User metadata para filtrar por una propiedad de metadatos rastreada. Elige una clave de propiedad para encontrar ejecuciones donde exista esa clave, o agrega un valor exacto para coincidir con valores escalares como cus_123, enterprise, true o 12. Haz clic en Clear filters cuando quieras restablecer el estado de los filtros activos. Usa Columns cuando quieras ocultar o restaurar columnas de la tabla.

¿Cómo inspecciono una ejecución de agente?

  1. Haz clic en una fila de la tabla de registros.
  2. Revisa el panel de detalle de la ejecución que se abre a la derecha.
El encabezado del panel muestra el ID de solicitud cuando está disponible, o el ID de ejecución como alternativa. También muestra el estado de la ejecución, el nombre del agente y la hora de inicio. La franja de resumen debajo del encabezado muestra Provider / Model, Agent, Duration, Tokens, Credits, Cost, Tool Calls, Owner y Charge Type de la ejecución. Si el agente aún existe y no está archivado, el nombre del agente en la franja de resumen enlaza de vuelta al editor.

Trazas

Usa la cascada de trazas en el lado izquierdo del panel de detalle de la ejecución para entender cómo progresó la ejecución en el tiempo. Cuando seleccionas un span, el lado derecho se actualiza para mostrar los detalles de esa parte de la ejecución. Según el span, esto puede incluir:
  • datos de respuesta del modelo
  • detalles de la solicitud
  • metadatos del usuario
  • metadatos
  • entrada de la herramienta
  • respuesta de la herramienta
  • detalles de tokens y costo
Cuando el span seleccionado está vinculado a la finalización de una herramienta, Fetch Hive muestra los paneles específicos de la herramienta para Response e Input. Cuando está vinculado a la finalización principal del modelo, Fetch Hive muestra las secciones de respuesta y solicitud para esa finalización. Para los spans de subagentes, Fetch Hive también muestra la contribución de tokens y costo de la ejecución del agente hijo seleccionado. Los subagentes anidados se incluyen recursivamente en los totales de la ejecución y permanecen visibles en la cascada de trazas. Si un subagente falla, el span se conserva con su entrada, una respuesta segura de error, child_request_id, diagnósticos de metadatos y cualquier dato parcial de traza/costo del hijo que se haya escrito antes del fallo. Las ejecuciones tardías del hijo se reconcilian de vuelta en la traza del padre mediante child_request_id después de completarse. Para las finalizaciones de agentes Claude, la sección de solicitud puede incluir Prompt Cache, que es el TTL configurado de la caché de prompts de Anthropic asignado a la ejecución. La contabilidad real de aciertos y escrituras de la caché permanece en los campos de uso de tokens en caché. Esta es la vista principal de depuración para las ejecuciones de agentes. Comienza aquí cuando necesites entender si el agente respondió directamente, razonó primero, llamó a una herramienta o se ralentizó en un paso específico.

Notas

  • Los registros de agentes no incluyen el patrón de filtro Source que se usa en los registros de prompts y de flujos de trabajo.
  • Fetch Hive rastrea los nombres de propiedades de metadatos del usuario a lo largo del tiempo desde las invocaciones de agentes para que el filtro de metadatos pueda sugerir claves que tu espacio de trabajo realmente ha enviado. Consulta Metadatos de invocación para ejemplos de solicitudes.
  • Esta página no expone una vista separada de analíticas o exportación para agentes.
  • Usa Ejecutar con API cuando quieras invocar un agente desde tu propia aplicación, y usa Pruebas con Chat cuando quieras iterar dentro del editor.