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

# Registros de herramientas

> Monitoree las ejecuciones de herramientas y los eventos de canales del agente de IA en tiempo real

## Descripción general

Los Registros de herramientas proporcionan visibilidad completa de lo que hace su agente de IA durante las conversaciones — cada llamada a herramienta, búsqueda RAG y evento de canal externo se registra con datos de entrada/salida, tiempo de ejecución y estado.

Abra los Registros de herramientas haciendo clic en el botón **Registros de herramientas** en la esquina superior derecha del modal del editor de agentes.

<Frame>
  <img className="block dark:hidden" src="https://mintcdn.com/revolai/FgC1DOR7_ZtbW3Sz/images/tool-logs-light.png?fit=max&auto=format&n=FgC1DOR7_ZtbW3Sz&q=85&s=f83770722049e8784700235b4f87dd9e" alt="Modal de registros de herramientas" width="2869" height="1546" data-path="images/tool-logs-light.png" />

  <img className="hidden dark:block" src="https://mintcdn.com/revolai/FgC1DOR7_ZtbW3Sz/images/tool-logs-dark.png?fit=max&auto=format&n=FgC1DOR7_ZtbW3Sz&q=85&s=a030944ca3bf8075e18289489ecc59eb" alt="Modal de registros de herramientas" width="2869" height="1555" data-path="images/tool-logs-dark.png" />
</Frame>

## Dos pestañas

El modal tiene dos pestañas:

### Registros de herramientas

Registra cada ejecución de herramienta durante las conversaciones de IA. Cada entrada muestra:

| Campo                        | Descripción                                                                                                             |
| ---------------------------- | ----------------------------------------------------------------------------------------------------------------------- |
| **Nombre de la herramienta** | La función que fue llamada (p. ej. `rag_search`, `get_products`, `get_company_info`)                                    |
| **Nombre del nodo**          | Qué nodo del flujo de trabajo activó esta herramienta                                                                   |
| **Tipo de nodo**             | Categoría del nodo — Orquestador, Agente de productos, Agente de medios, Agente de empresa, Formateador o Personalizado |
| **Estado**                   | `success`, `error` o `no_results`                                                                                       |
| **Tiempo de ejecución**      | Duración en milisegundos                                                                                                |
| **Fecha**                    | Cuándo se ejecutó la herramienta                                                                                        |

Haga clic en cualquier entrada del registro para expandirla y ver la **Entrada** completa (parámetros de la solicitud en JSON) y la **Salida** (datos de respuesta en JSON). Si el estado es `error`, el mensaje de error se muestra en la parte superior de la sección expandida.

<Tip>
  Los registros de herramientas se agrupan por **rondas**. Una ronda representa una iteración de llamadas a funciones del LLM — la IA puede llamar múltiples herramientas en una sola ronda antes de generar una respuesta. Los separadores de rondas le ayudan a comprender la secuencia de llamadas a herramientas dentro de un turno de conversación.
</Tip>

### Registros de canales

Registra eventos de canales de comunicación externos — webhooks, llamadas telefónicas, mensajes de mensajería. Cada entrada muestra:

| Campo             | Descripción                                                  |
| ----------------- | ------------------------------------------------------------ |
| **Tipo de canal** | Widget, Teléfono, Telegram, WhatsApp, Instagram, etc.        |
| **Dirección**     | `inbound` (recibido) o `outbound` (enviado)                  |
| **ID externo**    | Identificador del llamante o remitente del proveedor externo |
| **Estado**        | `success` o `error`                                          |
| **Fecha**         | Cuándo ocurrió el evento                                     |

Haga clic para expandir y ver la **Carga de la solicitud** completa (datos crudos del webhook) y la **Respuesta** (lo que se envió de vuelta).

## Qué se registra

Los registros de herramientas se crean automáticamente cuando el agente:

* **Busca en la base de conocimiento** — `rag_search` con la consulta y el número de resultados encontrados
* **Llama a una herramienta de función** — cualquier herramienta configurada en el conjunto de herramientas del agente (p. ej. `get_products`, `get_documents`, `get_photos`, `get_videos`, `get_company_info`)
* **Ejecuta herramientas de integración** — Google Ads, Facebook Ads y otras herramientas de servicios conectados

Los registros de canales se crean cuando:

* **Llega un webhook entrante** — llamada telefónica, mensaje de mensajería o cualquier evento de canal externo
* **Se envía un mensaje saliente** — la respuesta del agente entregada a través de un canal

## Limpieza de registros

Use el botón **Limpiar registros** (icono de papelera) en la parte superior del modal para eliminar todos los registros del agente actual. Esta acción es irreversible.

<Note>
  Los registros se almacenan en una tabla de base de datos particionada para mayor rendimiento. Los agentes de alto volumen pueden acumular miles de entradas — use Limpiar registros periódicamente para mantener la interfaz ágil.
</Note>