Crear herramientas con IA
Crear herramientas con IA es como pedirle a un amigo experto que lea el manual y te deje el aparato listo — tú le dices qué quieres que haga, él se encarga de las partes engorrosas y luego te muestra un resumen ordenado antes de que aprietes el botón. Tú sigues tomando las decisiones; la IA solo te ahorra la lectura.
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
Antes de empezar
- Una credencial guardada (los datos de inicio de sesión que Nirvai conserva para poder hablar con el servicio en tu nombre) 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 inicio de sesión guardado. |
| 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 otro inicio de sesión 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, un inicio de sesión vencido, 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
Cuando estés conforme con tu toolkit, continúa a Usar herramientas con agentes para asignar tus nuevas herramientas a los agentes que deberían tenerlas.