Usar una plantilla de herramienta
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 añadir tus propios datos de inicio de sesión 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 (datos de inicio de sesión) para ese servicio. 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. |
Qué sigue
Después de esto, continúa con Probar una herramienta personalizada para verificar que tu nueva herramienta realmente funciona antes de entregársela a un agente.