Credenciales
Usar Credenciales con Herramientas
Conecta tus credenciales guardadas a las herramientas del agente para que tus agentes puedan trabajar con otros servicios
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 es un inicio de sesión guardado para un servicio externo — Nirvai lo conserva para poder actuar allí en tu nombre — 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 el inicio de sesión, así que la herramienta puede comunicarse con el otro servicio en tu nombre. Tu agente nunca ve la credencial sin procesar — solo recibe el resultado.
Conectar una credencial a una herramienta
- Abre tu agente en el constructor (Editar en el centro de Agentes).
- Elige Herramientas en el menú de la izquierda.
- 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 los cambios (cada sección se guarda por separado).
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 (API key, bearer token, un inicio de sesión del tipo "Iniciar sesión con...", un usuario y contraseña, o una conexión Meta — consulta Tipos de Credenciales).
- 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 |
| Bearer token | El servicio lo expiró | Las llamadas de la herramienta fallan. Obtén un token 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 |
Qué sigue
- Gestión de Credenciales — edita, reconecta o elimina tus credenciales.
- Darle una herramienta a un agente — asigna una herramienta (y su credencial) a un agente.