Paso 4: Herramientas
Las herramientas son como las apps de un teléfono: por sí solo el teléfono puede hacer poco, pero al agregarle apps puede tomar fotos, enviar mensajes y revisar el calendario. Agregar herramientas a tu agente funciona igual: lo convierten de algo que solo conversa en un asistente que puede tomar acciones. Con herramientas, tu agente puede buscar en internet, crear eventos de calendario, buscar datos en una base de datos, enviar mensajes y conectarse con otros servicios que usas.
Antes de empezar
- Un agente guardado — al menos con el paso de Perfil completado, para tener un agente al que agregarle herramientas.
- Para las herramientas de conector (como Google Calendar o Slack), los datos de inicio de sesión de ese servicio ya guardados en Integraciones → Credenciales. A esos datos de inicio de sesión guardados les llamamos credencial.
- Para las herramientas personalizadas, la conexión ya creada en Integraciones → Herramientas Personalizadas (más abajo lo explicamos).
Tipos de herramientas
Nirvai tiene cuatro clases de herramientas.
Herramientas nativas
Herramientas integradas, disponibles para todos los agentes. No necesitas configurarlas: siempre están ahí.
| Herramienta | Qué hace |
|---|---|
| Búsqueda Web | Busca en internet información actualizada |
| Generación de Imágenes | Crea imágenes a partir de descripciones de texto |
Herramientas de conector
Conexiones listas para usar con servicios populares. Usan una credencial: los datos de inicio de sesión que guardaste para ese servicio en la sección de Credenciales.
| Conector | Acciones de ejemplo |
|---|---|
| Google Calendar | Crear eventos, revisar disponibilidad, listar próximas reuniones |
| Slack | Enviar mensajes, leer canales, publicar actualizaciones |
| Google Sheets | Leer y escribir datos de hojas de cálculo |
| Gmail | Enviar correos, buscar en la bandeja de entrada, leer mensajes |
Para usar una herramienta de conector, primero guarda la credencial de ese servicio en Integraciones → Credenciales.
Herramientas personalizadas
Conexiones que tú mismo creas con la función de Herramientas Personalizadas. Estas permiten que tu agente se comunique con casi cualquier otro servicio: tu propio sistema, un servicio externo o cualquier dirección web que acepte una conexión. (Por detrás, esta es la conexión que Nirvai usa para comunicarse con ese servicio por ti.)
Las herramientas personalizadas se crean en Integraciones → Herramientas Personalizadas y luego se activan para tu agente aquí.
Herramientas de base de datos
Cuando conectas una base de datos de Nirvai a tu agente, el sistema crea automáticamente herramientas para esa base de datos. Estas permiten que el agente busque, agregue, modifique y elimine registros.
Las herramientas de base de datos se configuran en el panel de Bases de Datos, no en este paso. Sí cuentan para tu límite de herramientas (ver más abajo).
Agrega herramientas a tu agente
- Haz clic en el nodo Herramientas en el lienzo de creación.
- Se abre el panel de herramientas, que muestra las herramientas disponibles agrupadas por tipo.
- Activa las herramientas que quieres que tu agente use.
- Cada herramienta de conector muestra a qué credencial está vinculada. Si aún no existe ninguna, se te pedirá que configures una.
Image: El panel de herramientas mostrando herramientas nativas, de conector y personalizadas con interruptores
Límites de herramientas
Tu agente puede tener hasta 25 herramientas entre herramientas personalizadas y de base de datos combinadas. Las herramientas nativas y de conector no cuentan para este límite.
| Tipo de herramienta | ¿Cuenta para el límite? |
|---|---|
| Herramientas nativas | No |
| Herramientas de conector | No |
| Herramientas personalizadas | Sí |
| Herramientas de base de datos | Sí |
Si conectas más de una base de datos, cada una agrega varias herramientas (hasta 7 por base de datos). Planifica con cuidado si te estás acercando al límite de 25 herramientas.
Cómo decide el agente usar una herramienta
Cuando alguien envía un mensaje, el agente decide si usar una herramienta según tres cosas:
- La solicitud — "¿Qué tengo en mi calendario mañana?" hace que el agente recurra a la herramienta de Google Calendar.
- Las instrucciones del agente — Puedes indicarle al agente cuándo y cómo usar herramientas específicas.
- La descripción de la herramienta — Cada herramienta tiene una breve descripción que ayuda al agente a saber cuándo es la indicada.
El agente puede usar varias herramientas en una sola respuesta. Por ejemplo, puede buscar información en internet, agregar un resumen a una base de datos y luego enviar un aviso por Slack, todo en un mismo turno.
Consejos para configurar herramientas
| Consejo | Por qué |
|---|---|
| Activa solo las herramientas que el agente realmente necesita | Menos herramientas significa respuestas más rápidas y enfocadas |
| Escribe instrucciones claras sobre cuándo usar cada herramienta | El agente funciona mejor cuando sabe lo que esperas |
| Prueba las herramientas en el chat antes de conectar el agente a un canal | Detecta problemas de inicio de sesión o configuración a tiempo |
| Asegúrate de que las credenciales sigan vigentes antes de agregar herramientas de conector | Los datos de inicio de sesión vencidos hacen que las herramientas fallen a mitad de la conversación |
Solución de problemas
| Problema | Solución |
|---|---|
| Una herramienta de conector no se activa | Verifica que hayas guardado la credencial (datos de inicio de sesión) de ese servicio en Integraciones → Credenciales. |
| Una herramienta falla a mitad de una conversación | Los datos de inicio de sesión guardados pueden haber vencido. Vuelve a guardar la credencial de ese servicio e inténtalo de nuevo. |
| El agente no usa una herramienta que activaste | Agrega una instrucción que le indique cuándo usarla y confirma que la descripción de la herramienta diga claramente para qué sirve. |
| No puedes activar más herramientas | Es posible que hayas llegado al límite de 25 herramientas. Quita una herramienta personalizada o de base de datos que no necesites; las nativas y de conector no cuentan. |
| Una herramienta personalizada no aparece en la lista | Asegúrate de haberla creado y guardado primero en Integraciones → Herramientas Personalizadas. |
Qué sigue
Después de esto, continúa con Paso 5: Base de Conocimiento.