Herramientas personalizadas
Una herramienta personalizada es como enseñarle a tu agente una nueva habilidad a partir de un manual que tú mismo escribiste — una vez conectada, el agente puede hacer ese trabajo concreto cada vez que sea útil. Cada herramienta le indica al agente cómo llamar a un servicio externo (consultar un pedido, enviar un mensaje, crear un contacto) y le devuelve una respuesta ordenada que puede usar en la conversación.
Esta sección es el punto de partida para todo lo relacionado con las herramientas personalizadas — cómo crear una con ayuda de la IA, cómo armarla a mano y cómo conectar una herramienta terminada a un agente.
De qué está hecha una herramienta personalizada
Una herramienta personalizada es solo tres ingredientes pequeños juntos: una dirección específica que hace una sola cosa, un dato de inicio de sesión opcional para que el servicio externo confíe en ti y una breve descripción que el agente lee para saber cuándo usarla.
| Ingrediente | Qué significa para ti |
|---|---|
| La dirección que Nirvai llama | El lugar exacto del servicio externo donde ocurre la acción (un "endpoint" — una dirección específica que hace una sola cosa, como la ventanilla de "enviar paquete" en una oficina de correos). |
| Un dato de inicio de sesión | Una credencial guardada (los datos de inicio de sesión que Nirvai conserva para poder hablar con el servicio en tu nombre). Algunos servicios no necesitan uno. |
| Parámetros que el agente completa | La información que la herramienta necesita cada vez — como un ID de cliente o un término de búsqueda. Tú decides cuáles completa el agente desde el chat y cuáles son siempre iguales. |
| Un nombre, una descripción y una nota de uso | Etiquetas en lenguaje claro para que tu agente sepa para qué sirve la herramienta y cuándo usarla. |
Image: La página de Herramientas Personalizadas mostrando tarjetas de funciones, estadísticas y la cuadrícula de herramientas
Lo que puedes hacer aquí
| Puedes… | Qué significa para ti |
|---|---|
| Dejar que la IA arme un conjunto de herramientas por ti | Elige un inicio de sesión, describe lo que quieres y la IA lee la documentación del servicio, lo configura todo, lo prueba y te muestra el resultado para que lo revises. |
| Crear una herramienta a mano | Completa la dirección, el tipo de solicitud y los campos tú mismo — ideal cuando ya conoces el servicio o es uno privado al que solo tú puedes acceder. |
| Decidir qué completa el agente | Marca cada campo como "el agente lo completa" o "siempre el mismo valor", para que el agente tenga libertad donde corresponde y reglas claras donde no. |
| Probar antes de guardar | Prueba la herramienta con datos de ejemplo y mira la respuesta real antes de confirmar. |
| Entregar la herramienta a un agente | Asigna las herramientas terminadas a agentes específicos en el Panel de Control del Agente. |
Dos formas de crear una herramienta
Configuración con IA (recomendado para la mayoría). Eliges un inicio de sesión guardado, dices lo que quieres que el agente pueda hacer y la IA lee la documentación del servicio, configura cada herramienta, prueba cada una con una llamada real y luego te muestra una pantalla de revisión ordenada — la Guía del Toolkit — donde puedes mirar cada herramienta, ver respuestas de ejemplo y hacer clic en Crear cuando estés conforme.
Manual. Completas la dirección, el tipo de solicitud y cada campo tú mismo. Ideal cuando ya conoces bien el servicio, cuando es interno o privado, o cuando quieres que cada decisión sea deliberada.
Asignar herramientas a tus agentes
Las herramientas viven en tu espacio de trabajo una vez creadas. Para que un agente pueda usar una de verdad, debes asignársela en el Panel de Control del Agente.
Algunas cosas que conviene saber:
- Cada agente tiene un cupo de 25 herramientas en total. Ese cupo único se comparte entre herramientas personalizadas y herramientas de base de datos — así que si un agente ya usa 10 herramientas de base de datos, le queda espacio para 15 herramientas personalizadas.
- Una misma herramienta se puede asignar a varios agentes. No hace falta volver a crearla para cada uno.
- El agente solo ve el nombre, la descripción, la nota de uso y los campos que marcaste como "el agente los completa". El resto (la dirección, el inicio de sesión, los valores fijos) queda detrás de escena.
Qué sigue
Crear herramientas con IA
Elige un inicio de sesión, describe lo que quieres y deja que la IA investigue, configure y pruebe todo antes de que hagas clic en Crear.
Crear una herramienta manualmente
Arma una herramienta a mano con control total sobre la dirección, el tipo de solicitud y cada campo.
Empezar desde una plantilla
Sáltate la página en blanco — empieza desde una configuración prearmada para un servicio popular y ajústala.
Probar tu herramienta
Envía datos de ejemplo y revisa la respuesta real antes de guardar o de entregar la herramienta a un agente.
Usar herramientas con agentes
Asigna las herramientas terminadas a agentes específicos en el Panel de Control del Agente, dentro del límite compartido de 25 herramientas.