Usar Credenciales con Herramientas
Una credencial por si sola es como una llave de repuesto guardada en un cajon: solo sirve cuando la pones en una cerradura. La desbloqueas conectandola a una herramienta en la configuracion de tu agente. Esta pagina explica como funcionan juntas las credenciales y las herramientas, y como vincularlas. Una credencial son los datos de inicio de sesion que Nirvai guarda para actuar en tu nombre con otro servicio, y una herramienta es una accion que tu agente puede realizar, como enviar un correo.
Como funciona
Cuando tu agente decide usar una herramienta (por ejemplo, "enviar un correo"), la herramienta carga automaticamente la credencial que le vinculaste. La credencial lleva los datos de inicio de sesion, asi que la herramienta puede comunicarse con el otro servicio en tu nombre. Tu agente nunca ve los datos de inicio de sesion sin procesar — solo recibe el resultado.
Conectar una credencial a una herramienta
- Abre tu agente en el Panel de Control del Agente.
- Ve al paso de Herramientas.
- Agrega una herramienta o selecciona una existente.
- En los ajustes de la herramienta, busca el menu desplegable de Credencial.
- Elige la credencial que quieres usar.
- Guarda el agente.
Image: Seleccionando una credencial en el menu desplegable de configuracion de la herramienta
El menu desplegable solo muestra credenciales que encajan con la herramienta. Por ejemplo, una herramienta de Gmail solo muestra credenciales que inician sesion con una cuenta de Google.
Si el menu desplegable esta vacio, primero necesitas crear una credencial para ese servicio.
Una credencial, muchas herramientas
Una sola credencial puede impulsar varias herramientas en distintos agentes. Por ejemplo, una credencial de inicio de sesion de Google puede usarse en:
- Una herramienta de Gmail en tu agente de soporte al cliente
- Una herramienta de Google Sheets en tu agente de ingreso de datos
- Una herramienta de Google Calendar en tu agente de agendamiento
Si actualizas o vuelves a conectar la credencial, todas las herramientas que la usan se actualizan automaticamente.
Una credencial, muchos agentes
La misma credencial tambien puede compartirse entre agentes. Si tres agentes necesitan enviar correos por Gmail, todos pueden apuntar a la misma credencial de Gmail — no necesitas crear una por agente.
Herramientas que necesitan una credencial
La mayoria de las herramientas que se comunican con un servicio externo necesitan una credencial. Aqui hay algunos ejemplos comunes:
| Herramienta | Con que se conecta | Que hace |
|---|---|---|
| Enviar Correo (Gmail) | Un inicio de sesion de Google | Envia correos desde tu cuenta de Gmail |
| Publicar Mensaje (Slack) | Un inicio de sesion de Slack | Publica mensajes en canales de Slack |
| Crear Contacto (HubSpot) | Un inicio de sesion de HubSpot | Agrega contactos a tu CRM |
| Enviar Mensaje de WhatsApp | Una conexion Meta (WhatsApp) | Envia mensajes de WhatsApp desde tu numero de empresa |
| Obtener Pedidos (Shopify) | Un inicio de sesion de Shopify | Busca datos de pedidos de tu tienda |
| Generar Texto (OpenAI) | Un codigo privado de OpenAI | Le pide a los modelos de OpenAI que escriban texto |
Herramientas personalizadas
Cuando creas una herramienta personalizada (una herramienta que se comunica con tu propio servicio u otro que no esta en la lista), eliges que tipo de conexion necesita durante la configuracion. Los ajustes de la herramienta te pediran:
- Elegir el tipo de conexion (un codigo privado, un pase de acceso, un inicio de sesion del tipo "Iniciar sesion con...", un usuario y contrasena, o una conexion Meta).
- Vincular una credencial guardada de ese tipo.
- La herramienta usara los datos de esa credencial cada vez que se ejecute.
Para herramientas personalizadas de tipo Meta, al elegir una credencial los datos de conexion se completan automaticamente — no necesitas ingresarlos a mano.
Las herramientas personalizadas que se comunican con un servicio publico sin inicio de sesion no necesitan ninguna credencial. Establece el tipo de conexion en Ninguno durante la configuracion.
Cuando una credencial deja de funcionar
| Tipo de credencial | Por que podria dejar de funcionar | Que hacer |
|---|---|---|
| Codigo privado (API key) | El servicio lo expiro o lo revoco | Las llamadas de la herramienta fallan. Obten un codigo nuevo y actualiza la credencial |
| Pase de acceso (token) | El servicio lo expiro | Las llamadas de la herramienta fallan. Obten un pase nuevo y actualiza la credencial |
| Inicio de sesion "Iniciar sesion con..." | El acceso se renueva solo, pero a veces caduca | Si caduca, vuelve a conectar desde la pagina de Gestion |
| Usuario y contrasena | Cambiaste tu contrasena | Actualiza la credencial con la nueva contrasena |
| Meta | Las conexiones normalmente no expiran | Si algo se rompe, vuelve a conectar mediante el inicio de sesion de Facebook |
Cuando una credencial deja de funcionar o se elimina, todas las herramientas que la usan dejan de funcionar tambien. Verifica que herramientas dependen de una credencial antes de cambiarla. Consulta Gestion de Credenciales para mas detalles.
Solucion de problemas
| Problema | Solucion |
|---|---|
| El menu desplegable de credenciales esta vacio | Crea una credencial para ese servicio primero — el menu solo muestra credenciales que encajan con la herramienta |
| Mi credencial no aparece en el menu desplegable | Puede ser del tipo equivocado para esta herramienta. El menu solo lista credenciales que encajan, asi que crea o elige la correcta |
| La herramienta falla despues de funcionar bien antes | La credencial puede haber dejado de funcionar. Abre Gestion de Credenciales y luego actualizala o vuelve a conectarla |
| Mi herramienta personalizada no se guarda sin una credencial | Vincula una credencial, o establece el tipo de conexion en Ninguno si el servicio no necesita inicio de sesion |
Que sigue
Despues de vincular tus credenciales, continua con Gestion de Credenciales para mantenerlas al dia.