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

# Herramientas

> Las acciones que puede ejecutar un agente Lumina: API, fin de chat, traspaso, integración y calendario

Una herramienta es una **acción que el agente puede ejecutar durante el chat**. Son una
**biblioteca de la cuenta**: se crean una vez en **Chat → SMS → Herramientas** (la página
**Herramientas de Chat**, botón **Agregar Herramienta**) y se adjuntan a los agentes que las
necesiten.

<Frame caption="La biblioteca de herramientas de SMS de la cuenta">
  <img src="https://mintcdn.com/dialtu-0be120d3/-eTE2eZzALOQmbBW/images/es/agentes-de-sms/herramientas-lista.png?fit=max&auto=format&n=-eTE2eZzALOQmbBW&q=85&s=4a00744ebd02082c4cb17dcd4f2cb7a6" alt="Página Herramientas de Chat con check_order_status, end_chat, transfer_to_human, notify_ops_team y forward_order_details, con sus distintivos de tipo y sus descripciones" width="2000" height="1070" data-path="images/es/agentes-de-sms/herramientas-lista.png" />
</Frame>

El botón **Herramientas** de la barra superior del agente abre la biblioteca: busca, filtra por
**Todos los Tipos**, **API**, **Fin de chat** o **Enviar SMS**, marca las que este agente deba
tener y confirma. El contador de abajo lleva la cuenta de la selección.

<Frame caption="Marca las que necesite este agente">
  <img src="https://mintcdn.com/dialtu-0be120d3/-eTE2eZzALOQmbBW/images/es/agentes-de-sms/herramientas-modal.png?fit=max&auto=format&n=-eTE2eZzALOQmbBW&q=85&s=671b1de392f33ace9d92df6546c29872" alt="Ventana Herramientas con dos herramientas de Enviar SMS, una de traspaso, una de fin de chat y una de API GET con sus distintivos de tipo, las cinco marcadas y el contador de 5 herramientas seleccionadas al pie" width="896" height="722" data-path="images/es/agentes-de-sms/herramientas-modal.png" />
</Frame>

<Note>
  La ventana lista todas las herramientas de SMS de la cuenta, sin filtro por motor.
</Note>

<Note>
  Al guardar el agente se envía la lista completa de herramientas adjuntas. Si abres la ventana
  y desmarcas una sin querer, se desadjunta al guardar.
</Note>

## Tipos disponibles en Lumina

| Tipo            | Qué hace                                                                                                      |
| --------------- | ------------------------------------------------------------------------------------------------------------- |
| **API**         | Llama a una API HTTP externa. Los `{{token}}` de la petición se vuelven entradas                              |
| **Fin de chat** | Cierra la conversación                                                                                        |
| **Traspaso**    | Pasa el chat a una persona                                                                                    |
| **Enviar SMS**  | Escribe al cliente o a un tercero. Ver [La herramienta Enviar SMS](/es/agentes-de-sms/herramienta-enviar-sms) |
| **Integración** | Consulta y gestiona un sistema conectado — AgendaPro, conectado por el equipo de Dialtu                       |
| **Calendario**  | Consulta disponibilidad y agenda. Solo en cuentas donde Dialtu haya habilitado el calendario                  |

<Note>
  Aquí no hay plantillas de WhatsApp ni catálogo. **Transferencia**, **fin de llamada** y
  **cambio de agente** son de voz; el equivalente en chat de una transferencia es el
  **Traspaso**.
</Note>

## El constructor

Tres columnas, como el editor del agente:

* La columna **Configurar** a la izquierda — las tarjetas de **Tipo de herramienta**, un
  **Alias** (se muestra en analíticas e informes en lugar del nombre técnico de la herramienta)
  y una sección específica del tipo.
* El **panel central** con el contenido de la herramienta.
* **Resumen** a la derecha — la lista de lo que falta, un repaso (incluido **Canal: SMS**) y un
  consejo.

En una herramienta de **API**, la descripción es el disparador. **Fin de chat** y **Traspaso**
tienen su propio campo **Prompt disparador**.

<Warning>
  **La IA decide cuándo usar una herramienta leyendo su disparador.** No describas qué hace la
  herramienta; describe **cuándo debe usarse**, y cuándo no.
</Warning>

<Frame caption="Una herramienta de traspaso: prompt disparador, grupo de asignación y resumen">
  <img src="https://mintcdn.com/dialtu-0be120d3/-eTE2eZzALOQmbBW/images/es/agentes-de-sms/constructor-traspaso.png?fit=max&auto=format&n=-eTE2eZzALOQmbBW&q=85&s=1937b32bb5f08407fb97eb509fb077dc" alt="Constructor de herramientas con la herramienta de traspaso seleccionada en la columna Configurar, un Prompt disparador en el centro, un grupo de asignación de dos usuarios por turno rotatorio y el panel Resumen a la derecha" width="2000" height="1070" data-path="images/es/agentes-de-sms/constructor-traspaso.png" />
</Frame>

## Fin de chat

El **Prompt disparador** dice cuándo debe terminar la conversación. Lo que lee el cliente, por
orden de preferencia:

1. La despedida del propio modelo.
2. El **Mensaje de Cierre Automático** del agente, si lo definiste.
3. Una despedida generada.
4. El texto de respaldo, en inglés: *"Thanks for getting in touch! If you need anything else,
   just text us back."*

La sesión pasa a **Resuelta**.

<Tip>
  Mantén el disparador estrecho — terminar demasiado pronto corta al cliente a mitad de idea.
  *"El cliente confirma que está resuelto"* funciona mejor que *"la conversación parece
  terminada"*.
</Tip>

## Traspaso

El **Prompt disparador** dice cuándo traspasar. El cliente ve la frase de traspaso del modelo, o
una generada.

Qué pasa por detrás:

* El asignado se elige por **turno rotatorio** del grupo de asignación de la herramienta. Los
  usuarios inactivos se saltan; un grupo vacío deja la conversación sin asignar.
* Se escribe una nota de sistema en el hilo.
* La sesión pasa a **Gestiona una persona** y en Conversaciones la fila se marca como
  **Transferida**.
* Se redacta un resumen interno con IA para el equipo. Nunca se envía al cliente.

<Card title="La bandeja de Conversaciones" icon="inbox" href="/es/agentes-de-sms/conversaciones">
  Dónde aterriza el hilo traspasado, y cómo responder.
</Card>

## API

Los `{{token}}` de la URL, los parámetros, las cabeceras o el cuerpo se vuelven entradas que la
IA rellena. El **tiempo límite HTTP** va de 1.000 a 600.000 ms. La franja de variables bajo el
panel muestra las entradas en **azul** y los valores extraídos de la respuesta en **verde**.

<Warning>
  Las herramientas de API **se ejecutan de verdad en el panel de prueba**. Usa datos de prueba.
</Warning>

## Integración y calendario

Hay un proveedor de integración, **AgendaPro**, y la conexión la hace el equipo de Dialtu — no
hay pantalla de autoservicio. Pídeselo a tu contacto en Dialtu antes de activar el agente.

* Los resultados de integración se resumen para el cliente en **una frase corta**, nunca una
  lista.
* Las etiquetas del calendario siguen el ajuste **Idioma** del agente.

## Campos que Lumina ignora

<Warning>
  Los campos del constructor para el **mensaje durante la ejecución**, el **mensaje antes de
  terminar** y el **mensaje durante el traspaso** son **ignorados por Lumina**. Lo que lee el
  cliente viene del modelo — o, en Fin de chat, del **Mensaje de Cierre Automático**.
</Warning>

## Límites

* Como máximo **3 llamadas a herramientas por turno**.
* Con **Usar memoria** y **Búsqueda profunda** activados, el agente recibe además una búsqueda
  integrada en conversaciones anteriores, sumada a las herramientas que adjuntes.

## Qué no existe

* **Plantillas de WhatsApp** ni **catálogo**.
* **Un filtro o aviso por motor** en la ventana Herramientas.
* **Cambiar el tipo de una herramienta** — el constructor lo indica bajo la tarjeta de tipo: el
  tipo no puede cambiarse después de crearla. Crea una herramienta nueva.

## Siguiente paso

<Card title="La herramienta Enviar SMS" icon="message-arrow-up-right" href="/es/agentes-de-sms/herramienta-enviar-sms">
  La única herramienta exclusiva de SMS.
</Card>
