> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fetchhive.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Registros

> Revisa ejecuciones de agentes, filtra actividad, inspecciona trazas y depura el uso de herramientas en Fetch Hive

# 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? <a href="#open-agent-logs" id="open-agent-logs" />

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? <a href="#filter-agent-logs" id="filter-agent-logs" />

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? <a href="#inspect-agent-run" id="inspect-agent-run" />

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 <a href="#traces" id="traces" />

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.
* Las desconexiones del cliente durante un stream de agente se tratan como cancelaciones silenciosas, por lo que no aparecen como ejecuciones fallidas ni eventos de facturación salvo que el proveedor ya haya completado y confirmado el uso.
* 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](../user-tracking/invoke-metadata) para ejemplos de solicitudes.
* Esta página no expone una vista separada de analíticas o exportación para agentes.
* Usa [Ejecutar con API](./run-with-api) cuando quieras invocar un agente desde tu propia aplicación, y usa [Pruebas con Chat](./testing-with-chat) cuando quieras iterar dentro del editor.
