Las tools son acciones que el agente puede ejecutar durante una conversacion. Permiten que el agente interactue con sistemas externos como tu API, bases de datos o servicios de terceros.
Vienen incluidas con Thaliq y no requieren configuracion adicional:
- Buscar documentos: Busca en tu base de conocimiento RAG
Llaman a cualquier API REST que configures. El agente decide cuando usarlas basandose en el contexto de la conversacion.
Ejemplo: Una tool que consulta el stock de productos en tu API.
Se importan desde MCP Servers (Model Context Protocol). Ideales para conectar sistemas complejos.
Disponible en: Growth y Enterprise.
- Ve a Tools en el menu lateral
- Click en Crear Tool
- Configura los campos:
| Campo | Descripcion |
|---|
| Nombre | Nombre descriptivo (ej: consultar_stock) |
| Descripcion | Que hace la tool — el agente usa esto para decidir cuando usarla |
| Metodo | GET, POST, PUT, DELETE |
| URL | Endpoint de tu API (ej: https://api.tuempresa.com/products/stock) |
| Headers | Headers adicionales (ej: Authorization, x-api-version) |
| Body template | Template del body para POST/PUT (con variables) |
| Requiere auth | Si la tool necesita autenticacion del usuario |
La descripcion es critica. El agente la usa para decidir cuando invocar la tool. Se claro y especifico. Ejemplo: “Consulta el stock disponible de un producto por su codigo SKU. Retorna cantidad disponible y ubicacion en almacen.”
requiresAuth:
| Valor | Widget | SDK/API |
|---|
false | Visible | Visible |
true | No visible | Visible |
requiresAuth: false para tools publicas (consultar info, FAQs).
Usa requiresAuth: true para tools que acceden a datos del usuario (mis pedidos, mi cuenta).
Puedes agregar headers personalizados a tus tools HTTP. Utiles para:
- Versionado de API (
x-api-version: v2)
- Identificacion de region (
x-country: PE)
- Tokens estaticos
Los headers se envian en cada ejecucion de la tool.
Limites
| Plan | HTTP Tools max |
|---|
| Starter | 5 |
| Growth | Ilimitadas |
| Enterprise | Ilimitadas |
