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

# Configurar Tools

> Cómo habilitar acciones y consultas que el agente puede usar durante una conversación

# Configurar Tools

La tab `Tools` define qué acciones puede ejecutar o consultar el agente.

Una tool es una capacidad controlada. Le permite al agente hacer algo más que responder texto: consultar disponibilidad, buscar productos, disparar una automatización, transferir a humano o leer una fuente conectada.

***

## Cuándo usar Tools

| Caso                            | Va en Knowledge | Va en Tools |
| ------------------------------- | --------------- | ----------- |
| Horario general del negocio     | Sí              | No          |
| Disponibilidad exacta de agenda | No              | Sí          |
| Política de cambios             | Sí              | No          |
| Estado de un pedido             | No              | Sí          |
| Catálogo pequeño y estable      | Sí              | Opcional    |
| Inventario vivo                 | No              | Sí          |
| Transferir a humano             | No              | Sí          |
| Disparar flujo externo          | No              | Sí          |

<Info>
  Si el agente puede responder leyendo información estable, usa [Knowledge](/guides/agent-knowledge). Si necesitas una regla operativa del dashboard, usa [Automatizaciones](/concepts/automations). Si el agente necesita consultar o ejecutar algo durante su turno, usa Tools.
</Info>

***

## Tipos comunes de tools

<CardGroup cols={2}>
  <Card title="Agenda" icon="calendar-check">
    Consultar disponibilidad, reservar, reprogramar o cancelar citas.
  </Card>

  <Card title="Catálogo" icon="box-open">
    Buscar productos, servicios, variantes, precios o disponibilidad.
  </Card>

  <Card title="Triggers" icon="bolt">
    Disparar flujos externos como n8n, Zapier, CRM o workflows internos.
  </Card>

  <Card title="Handoff" icon="people-arrows">
    Transferir conversación a humano o marcar que requiere atención.
  </Card>

  <Card title="Datos" icon="database">
    Consultar pedidos, tickets, suscripciones o registros del negocio.
  </Card>

  <Card title="Re-engagement" icon="rotate-right">
    Retomar conversaciones abandonadas con reglas de negocio.
  </Card>
</CardGroup>

***

## Cómo habilitar una tool

<Steps>
  <Step title="Elige la tool">
    Activa solo la capacidad que el agente necesita. No habilites todo por defecto.
  </Step>

  <Step title="Define alcance">
    Especifica cuándo debe usarla, qué puede hacer y cuándo debe pedir confirmación.
  </Step>

  <Step title="Configura permisos">
    Limita acciones sensibles. Consultar disponibilidad no es lo mismo que reservar una cita.
  </Step>

  <Step title="Escribe ejemplos">
    Agrega frases reales de clientes que deberían activar esa tool.
  </Step>

  <Step title="Prueba casos felices y fallos">
    Verifica qué responde si la tool no tiene datos, falla o devuelve varias opciones.
  </Step>

  <Step title="Activa en producción">
    Solo después de probar con conversaciones representativas.
  </Step>
</Steps>

***

## Cómo escribir instrucciones para una tool

### Bueno

```text theme={null}
Usa esta tool cuando el cliente quiera agendar, cambiar o cancelar una cita.
Antes de reservar, confirma nombre, fecha, hora y servicio.
Si no hay disponibilidad, ofrece hasta 3 horarios alternativos.
Si el cliente insiste en un horario no disponible, transfiere a humano.
```

### Malo

```text theme={null}
Usar para citas.
```

La segunda instrucción no define límites ni comportamiento ante errores.

***

## Permisos y riesgo

| Tipo de tool    | Riesgo       | Recomendación                         |
| --------------- | ------------ | ------------------------------------- |
| Solo lectura    | Bajo         | Puede activarse antes                 |
| Buscar catálogo | Bajo a medio | Validar que no invente disponibilidad |
| Crear evento    | Medio        | Pedir confirmación antes              |
| Cancelar pedido | Alto         | Requiere confirmación clara o humano  |
| Ejecutar cobro  | Alto         | Mejor con flujo externo controlado    |
| Handoff         | Bajo         | Conviene tenerlo siempre disponible   |

<Warning>
  No habilites acciones irreversibles sin confirmación. Si una tool puede cancelar, cobrar, borrar o modificar datos sensibles, limita su uso.
</Warning>

***

## Qué pasa si una tool falla

Define comportamiento de fallback.

Buenas respuestas:

* "No pude consultar disponibilidad en este momento. Te transfiero con el equipo."
* "No tengo acceso al estado exacto del pedido ahora. ¿Quieres que soporte lo revise?"
* "Encontré varias opciones. Te muestro las principales y puedo filtrar por precio o categoría."

Malas respuestas:

* "Listo, quedó agendado" cuando la reserva no se confirmó.
* "Sí hay disponibilidad" sin haber recibido disponibilidad.
* "No existe" cuando la herramienta falló.

***

## Pruebas mínimas

<Check>El caso feliz: el cliente pide algo simple y la tool responde bien.</Check>
<Check>Faltan datos: el cliente no da fecha, servicio, pedido o identificador.</Check>
<Check>No hay resultados: agenda llena, producto no encontrado o pedido inexistente.</Check>
<Check>Error externo: la tool no responde o devuelve error.</Check>
<Check>Handoff: el agente sabe cuándo transferir a humano.</Check>

***

## Errores comunes

| Error                          | Qué pasa                                | Cómo corregirlo                            |
| ------------------------------ | --------------------------------------- | ------------------------------------------ |
| Habilitar demasiadas tools     | El agente intenta acciones innecesarias | Empieza con pocas y específicas            |
| No definir cuándo usarla       | Llamadas erráticas                      | Escribe triggers claros                    |
| Sin fallback                   | Respuestas falsas ante errores          | Define respuesta de fallo                  |
| Acciones sin confirmación      | Riesgo operativo                        | Pide confirmación antes de modificar datos |
| Tool para información estática | Complejidad innecesaria                 | Usa Knowledge                              |

***

## Tools, Subagents y MCPs

Una tool puede vivir dentro de un flujo más grande.

```mermaid theme={null}
flowchart LR
    customer["Cliente"] --> salesSubagent["Subagent de ventas"]
    salesSubagent --> catalogTool["Tool de catalogo"]
    salesSubagent --> handoffTool["Tool de handoff"]
    catalogTool --> response["Respuesta"]
    handoffTool --> human["Humano"]
```

Si la acción viene de un sistema externo, probablemente la tool se apoyará en un [MCP](/guides/agent-mcps).

***

## Siguiente paso

<CardGroup cols={2}>
  <Card title="Subagents" icon="diagram-project" href="/guides/agent-subagents">
    Diseña especialistas para ventas, soporte, agenda o seguimiento.
  </Card>

  <Card title="MCPs" icon="plug" href="/guides/agent-mcps">
    Conecta sistemas externos con permisos y pruebas claras.
  </Card>

  <Card title="Automatizaciones" icon="bolt" href="/concepts/automations">
    Crea reglas para tags, funnels, mensajes, handoff y webhooks.
  </Card>
</CardGroup>