Herramientas Personalizadas
Crear herramientas con IA
De qué está hecha una herramienta personalizada, y cómo la IA lee la documentación de un servicio, crea y prueba las herramientas y te entrega una guía para revisar.
Una herramienta personalizada es como enseñarle a tu agente una nueva habilidad a partir de un manual — una vez configurada, el agente puede hacer ese trabajo concreto cada vez que sea útil: consultar un pedido, enviar un mensaje, crear un contacto. Tus herramientas están en la página de Integraciones, agrupadas bajo la credencial que usa cada una. Si una app ofrece un conjunto ya listo, un servidor MCP te ahorra armarlas una por una.
Image: La página de Herramientas Personalizadas mostrando tarjetas de funciones, estadísticas y la cuadrícula de herramientas
De qué está hecha una herramienta personalizada
| Ingrediente | Qué significa para ti |
|---|---|
| La dirección que Nirvai llama | El lugar exacto del servicio externo donde ocurre la acción (un "endpoint" — como la ventanilla de "enviar paquete" en una oficina de correos). |
| Una credencial | Un inicio de sesión guardado para el servicio — Nirvai lo conserva para poder actuar allí en tu nombre. Algunos servicios no necesitan una. |
| 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. |
El agente solo ve el nombre, la descripción, la nota de uso y los campos que completa. La dirección, la credencial y los valores fijos quedan detrás de escena.
Dos formas de crear una herramienta
Esta página cubre el camino con IA, el indicado para la mayoría: es como pedirle a un amigo experto que lea el manual y te deje el aparato listo. Dices lo que quieres, la IA lee la documentación del servicio, configura y prueba cada herramienta, y te muestra un resumen ordenado antes de que hagas clic en Crear. ¿Prefieres control total, o el servicio es privado? Crea una herramienta manualmente.
Antes de empezar
- Una credencial guardada para el servicio que quieres conectar. Si aún no tienes una, créala primero en Credenciales.
- Una idea clara de lo que quieres que el agente pueda hacer — "listar contactos, crear un contacto, actualizar un contacto" es mucho más útil que "cosas de HubSpot".
- Unos minutos de paciencia mientras la IA lee la documentación y prueba cada herramienta con una llamada real.
Paso a paso
- Abre Herramientas Personalizadas desde la barra lateral y haz clic en Creación de Herramientas con IA.
- Aparecerás en una página con tus inicios de sesión guardados como tarjetas — elige la del servicio que quieres conectar.
- Dile a la IA, en lenguaje claro, lo que quieres que el agente pueda hacer. La IA puede mostrarte una pregunta de opción múltiple con las acciones que conoce para ese servicio — marca las que quieras.
- Espera mientras la IA trabaja en la configuración. Avanza por etapas y muestra una línea de tiempo de progreso dentro del chat.
- Cuando la IA termine, aparecerá una tarjeta Abrir Guía de Configuración. Haz clic en ella para abrir la Guía del Toolkit — una revisión ordenada de cada herramienta que la IA construyó.
- Revisa cada tarjeta de herramienta, expande las secciones que quieras inspeccionar y luego haz clic en la tarjeta Crear al final para guardar todo el lote en tu espacio de trabajo.
Image: El Creador de Herramientas con IA mostrando la vista de chat con la línea de tiempo de progreso y el resultado del toolkit
Puedes conversar con la IA en lenguaje natural en cualquier momento — pídele que te explique qué hace una herramienta, por qué eligió cierto campo o que agregue otra herramienta. Es una conversación real, no un asistente rígido.
Qué hace la IA mientras esperas
La IA trabaja por etapas, en pequeños lotes, para poder seguir avanzando incluso con toolkits grandes. Cada etapa aparece en el chat a medida que ocurre.
| Etapa | Qué está pasando |
|---|---|
| Búsqueda | Busca en línea la documentación del servicio. |
| Lectura | Lee las páginas reales de documentación para encontrar cada dirección que hace una sola cosa. |
| Configuración | Arma cada herramienta — la dirección, el tipo de solicitud y los campos que el agente debería completar. |
| Prueba | Hace una llamada real para cada herramienta usando tu credencial guardada. |
| Validación | Marca cuáles herramientas pasaron la prueba y ajusta las que no. |
Si una prueba necesita un valor real de tu cuenta (como un ID de pedido existente), la IA pausará y te lo pedirá — en el chat — antes de seguir.
Cómo leer la Guía del Toolkit
Cada herramienta que la IA construyó aparece como una tarjeta. La mayoría de las tarjetas tienen estas piezas:
| Pieza de la tarjeta | Qué te dice |
|---|---|
| Insignia del tipo de solicitud | El tipo de solicitud — GET, POST, PUT, PATCH o DELETE — para que veas de un vistazo si la herramienta lee, crea, actualiza o borra. |
| Nombre y descripción | Lo que hace la herramienta, en las palabras que tu agente leerá al decidir si la usa. |
| Advertencias | Notas de colores que dejó la IA. Tres niveles: info (solo para que lo sepas), advertencia (un límite real que tu agente debe sortear) y crítica (revísala antes de crear). El agente también las ve al momento de ejecutarla. |
| La dirección que Nirvai llama | El lugar exacto al que va la herramienta — útil si quieres contrastarla con la documentación del servicio. |
| Lo que la IA va a completar | Una lista expandible de cada campo — su nombre, tipo, dónde va (path, query, header, body) y si lo completa el agente o si siempre es el mismo valor. |
| Respuestas de ejemplo | Una vista previa de lo que la herramienta devolvió durante la prueba — las imágenes se muestran en línea, los documentos cortos se renderizan en su lugar y los archivos más grandes aparecen como enlaces. |
| Resultado de la prueba | Si la prueba pasó o falló, con una sección expandible para ver la respuesta completa que envió el servicio. |
Cuando estés conforme con todo, haz clic en Crear y todo el lote se guarda en tu espacio de trabajo.
Consejos y datos útiles
Puedes volver más adelante y agregar más herramientas. Las sesiones se guardan automáticamente — abre Herramientas Personalizadas, busca la sesión en progreso y continúa donde la dejaste. Tu chat, las configuraciones y los resultados de las pruebas se conservan.
Puedes crear herramientas para varios servicios en una misma sentada. Después de terminar un lote, haz clic en Seguir trabajando con la IA en la pantalla de finalización, apunta la IA a otra credencial y arranca un nuevo toolkit. Cada servicio se convierte en su propio grupo.
Lee las advertencias de cada tarjeta de herramienta antes de hacer clic en Crear. Una advertencia "crítica" suele significar que la herramienta solo funciona en modo de pruebas, requiere una revisión adicional o tiene un detalle no obvio que tu agente debería conocer.
Solución de problemas
| Problema | Qué revisar |
|---|---|
| La IA dice que no encuentra documentación del servicio | Puede que el servicio no tenga un sitio público e indexado de documentación. Prueba la ruta manual — consulta Crear una herramienta manualmente. |
| Una herramienta falla su prueba una y otra vez | Abre el resultado de la prueba en esa tarjeta y lee la respuesta que envió el servicio — suele decir exactamente qué está mal (un campo faltante, una credencial vencida, un permiso que no tienes). Luego pídele a la IA en el chat que ajuste y reintente. |
| La IA me pide un ID y no tengo uno | Pega cualquier ejemplo real de tu cuenta (un pedido, contacto o registro existente). La IA solo necesita algo real para que la llamada de prueba tenga posibilidades de funcionar. |
| Cambié de opinión sobre una herramienta | En la Guía del Toolkit puedes ignorar las herramientas que no quieres — solo las que conservas se guardan al hacer clic en Crear. También puedes pedirle a la IA en el chat que quite o modifique una. |
| Volví a empezar y perdí el trabajo | Usa el botón Reiniciar solo cuando de verdad quieras empezar de cero — borra toda la sesión. Para conservar el progreso, simplemente cierra la página; la sesión queda guardada. |
Qué sigue
- Crear una herramienta manualmente — arma una herramienta a mano, con control total sobre cada campo.
- Dar una herramienta a un agente — asigna tus nuevas herramientas a los agentes que deberían tenerlas.