Construye tu agente
Herramientas
Dale a tu agente la capacidad de tomar acciones — buscar en la web, gestionar calendarios, enviar mensajes y más
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 la sección Perfil guardada, 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.
Agrega herramientas a tu agente
- En el constructor, elige Herramientas en el menú de la izquierda.
- Un buscador te permite encontrar una herramienta por su nombre, y el contador muestra cuántas herramientas usa el agente. Hay tres pestañas:
- Mis Herramientas — las herramientas que ya tiene este agente, más tus propias herramientas que puedes agregar.
- Herramientas Nirvai — herramientas integradas que puedes activar.
- Plantillas — configuraciones de herramientas listas para instalar.
- 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.
Herramientas
Las apps y servicios que este agente puede usar en tu nombre.
- · Conecta APIs y servicios que tu agente puede usar
- · Dale a cada herramienta un alias claro y luego menciona ese alias en las instrucciones.
- · Python, búsqueda web, archivos y visión siempre están activos.
¿Cuántas herramientas?
No hay un límite fijo, pero menos es mejor: con una lista larga el agente tiene más opciones entre las cuales elegir y elige con menos precisión. Cuando un agente tiene más de unas 12 herramientas, su Resumen sugiere mover las que casi no se usan a una habilidad. Python, búsqueda web, archivos y visión siempre están activos y no necesitas agregarlos.
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. |
| Una herramienta personalizada no aparece en la lista | Asegúrate de haberla creado y guardado primero en Integraciones → Herramientas Personalizadas. |
Qué sigue
Luego, dale tus documentos y una memoria con Proyectos.