Herramientas y funciones
Crea webhooks y funciones que tus agentes pueden invocar para ejecutar acciones reales.
Objetivo
Crear funciones que los agents puedan ejecutar (webhooks o acciones de integraciones).
Acceso
Sidebar -> Webhooks
Ruta: /app/{tenant}/tools
Roles
- owner, admin, agent
Requisitos previos
- Integrations conectadas si quieres Integration Actions.
Crear un Tool
Pulsa Create Tool.
Tipo 1: API Request (Webhook)
Campos:
| Campo | Obligatorio | Formato | Ejemplo | Nota |
|---|---|---|---|---|
| Tool Name | Sí | texto | Book Appointment | Nombre visible |
| Description | No | texto | Reserva cita en CRM | Ayuda al agent |
| API URL | Sí | URL | https://api.example.com/appointments | Soporta {variable} |
| HTTP Method | Sí | GET/POST/PUT/DELETE | POST | - |
| Authentication | No | none/bearer/basic | bearer | Opcional |
| Bearer Token | Si (si bearer) | texto | ******** | - |
| Basic Auth | Si (si basic) | user/pass | user / pass | - |
| Headers | No | key/value | Authorization | Usa {variable} |
| Query Params | No | key/value | status=active | Usa {variable} |
| Body (JSON) | No | JSON | {"id":"{contactId}"} | Válido JSON |
| Parameters Schema | No | JSON schema | {"type":"object"...} | Describe args |
Notas:
- Si Body está vacío, se envía el payload del tool como JSON.
- Usa
{variable}para insertar argumentos del tool.
Tipo 2: Integration Action
Pasos:
- Selecciona la integración (Google Calendar, Gmail, etc.).
- Elige modo:
- Quick Add Múltiple: selección múltiple.
- Add Single (Custom): personaliza nombre/descripción.
Campos:
| Campo | Obligatorio | Formato | Ejemplo | Nota |
|---|---|---|---|---|
| Integration | Sí | selección | Google Calendar | Debe estar conectada |
| Action | Sí | selección | Create event | Según catalogo |
| Tool Name | Si (custom) | texto | Create Meeting | Editable |
| Description | No | texto | Crea evento | Editable |
Ver Tools
En la lista puedes:
- Ver descripción.
- Abrir Parameters y Details.
- Delete tool.
Buenas prácticas
- Usa nombres accionables (Create Ticket, Update Order).
- Define Parameters Schema para evitar errores en ejecución.
- Documenta ejemplos en Description si es posible.
Captura
Relacionados
- Integraciones
- Agentes de IA (selección de tools)