Herramientas Personalizadas
Usar una plantilla de herramienta
Empieza desde una herramienta predefinida para un servicio popular en lugar de configurar una desde cero.
Las plantillas son como muebles pre-armados: tú eliges el color, pero no tienes que averiguar qué tornillo va dónde. Cada plantilla es una herramienta personalizada que ya viene rellenada para un servicio popular, así que solo tienes que elegir tu credencial y ajustar unas pocas opciones.
Image: La galería de plantillas con tarjetas de herramientas organizadas por categoría, con búsqueda y filtros
Antes de empezar
- Una idea clara de con qué servicio quieres que hable tu agente (Slack, Google Sheets, un gestor de proyectos, etc.).
- Una credencial guardada (un inicio de sesión guardado para ese servicio, que Nirvai conserva para poder actuar allí en tu nombre). Si aún no la tienes, configúrala primero en Credenciales.
- Unos minutos para revisar y probar la plantilla antes de guardarla.
Paso a paso
- Desde la página de Herramientas Personalizadas, haz clic en Templates para abrir la galería.
- Usa el cuadro de búsqueda o el filtro por categoría para acotar (Monitoreo y Analíticas, Productividad, Seguimiento de Proyectos, Comunicación, Almacenamiento).
- Haz clic en una tarjeta de plantilla que coincida con lo que quieres que haga tu agente.
- El asistente de creación manual se abre con la configuración pre-rellenada: la dirección web, el método de la solicitud y los parámetros ya están puestos.
- Elige tu credencial (tu contraseña privada que permite a Nirvai conectarse al servicio por ti) en el desplegable.
- Ajusta lo que quieras: el nombre, la descripción, los valores por defecto de los parámetros. Las plantillas son un punto de partida, no una configuración bloqueada.
- Pasa a la página de prueba y ejecuta una prueba real (consulta Probar una herramienta personalizada).
- Haz clic en Save.
Image: Una tarjeta de plantilla con nombre, descripción, etiqueta de método y tipo de autenticación
Qué te da la plantilla (y qué pones tú)
| Lo que rellena la plantilla | Lo que pones tú |
|---|---|
| La dirección web del servicio que Nirvai va a llamar | Tu propia credencial para ese servicio |
| El método de la solicitud (GET, POST, etc.) | Valores de ejemplo cuando pruebes la herramienta |
| La lista de parámetros y sus tipos | Cualquier retoque al nombre, la descripción o los valores por defecto |
| Una descripción inicial y notas de uso | Tus propias advertencias o instrucciones especiales (opcional) |
Image: El asistente manual con campos pre-rellenados desde una plantilla
Todo lo de la plantilla es editable. Renómbrala, reescribe la descripción con tus propias palabras o quita los parámetros que no necesites antes de guardar.
Personalizar después de instalar
Una vez guardada, la herramienta se comporta igual que una que hubieras creado desde cero: puedes abrirla desde la página de Herramientas Personalizadas y:
- Renombrarla o reescribir su descripción.
- Añadir, quitar o renombrar parámetros.
- Cambiar los valores por defecto.
- Adjuntar una salida de ejemplo (image, pdf, markdown, json o file) para previsualizar el tipo de respuesta que devuelve.
- Añadir advertencias que el agente debería leer antes de llamarla.
Solución de problemas
| Problema | Solución |
|---|---|
| No encuentro una plantilla para el servicio que quiero | Prueba el cuadro de búsqueda con otra palabra, o crea la herramienta manualmente (consulta Crear una herramienta personalizada manualmente). |
| El desplegable de credenciales está vacío | Aún no has conectado ese servicio: configura primero la credencial en Credenciales. |
| La prueba falla justo después de instalar la plantilla | Abre la herramienta, verifica que esté seleccionada la credencial correcta y vuelve a ejecutar la prueba. Las causas más comunes son una credencial equivocada o un parámetro obligatorio sin valor. |
| Modifiqué la plantilla y quiero empezar de nuevo | Elimina la herramienta e instala la plantilla otra vez: la versión original siempre está disponible en la galería. |