> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kolmena.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Añade y gestiona credenciales para tus agentes

> Guarda credenciales cifradas, concédelas a agentes concretos y responde a las solicitudes de credenciales desde el chat. Los valores no vuelven a mostrarse después de guardarlos.

Las credenciales son claves de API y tokens que tus agentes usan para iniciar sesión en servicios de terceros en tu nombre. Se guardan cifradas y, una vez guardado, el valor puede reemplazarse pero nunca volver a leerse. Las credenciales se gestionan desde **Configuración > Credenciales**.

## Añadir una credencial

**1. Abre la configuración de credenciales**

Ve a **Configuración > Credenciales** desde la barra lateral.

**2. Haz clic en Añadir credencial**

El botón **Añadir credencial** abre una ventana donde pones nombre a la credencial y pegas su valor.

**3. Ponle nombre y guarda**

Escribe un nombre como `NOTION_TOKEN`. Los nombres deben empezar por una letra y contener solo letras, dígitos y guiones bajos. Pega el valor y haz clic en **Añadir**. El valor se guarda cifrado y no vuelve a mostrarse.

> [!NOTE]
>
> Las credenciales gestionadas (por ejemplo, las que crea una integración como Telegram) no se pueden editar desde esta página. Muestran la etiqueta **Gestionado por** y un enlace a la integración a la que pertenecen.

## Conceder credenciales a los agentes

Por defecto no se concede nada, y **Todos los agentes** nunca incluye a Maya. Tienes que elegir expresamente qué agentes pueden usar cada credencial.

### Activar para todos los agentes (excepto Maya)

En la página Credenciales, activa el interruptor **Todos los agentes** junto a una credencial. Así la concedes a todos los agentes personalizados que tienes. Maya queda excluida y, si quieres que la use, tienes que concedérsela aparte.

### Conceder a agentes concretos

1. Haz clic en la etiqueta de acceso junto a una credencial (muestra el número actual de agentes).
2. En la ventana **Gestionar el acceso a la credencial**, marca los agentes a los que quieres concederla.
3. Haz clic en **Guardar**.

Los agentes que heredan el acceso del interruptor **Todos los agentes** muestran la etiqueta *vía Todos los agentes*. Si desmarcas uno de esos agentes, se guarda una excepción explícita en lugar de quitar una concesión directa.

## Rotar una credencial

Si una clave caduca o se ve comprometida, puedes reemplazarla:

1. Haz clic en el icono de rotar junto a la credencial.
2. Pega el nuevo valor en la ventana **Reemplazar credencial**.
3. Haz clic en **Reemplazar**. El nuevo valor se guarda y todos los agentes con acceso lo reciben en su siguiente turno.

> [!WARNING]
>
> El valor actual no se puede mostrar. Rotar es la única forma de cambiar una credencial guardada.

## Eliminar una credencial

1. Haz clic en el icono de eliminar junto a la credencial.
2. Confirma en la ventana. La credencial se elimina de forma permanente y todos los agentes que tenían acceso lo pierden de inmediato.

> [!WARNING]
>
> La eliminación es irreversible. No puedes recuperar el valor, y los agentes que lo usaban dejarán de funcionar con ese servicio hasta que añadas una credencial nueva.

## Solicitudes de credenciales en el chat

A veces un agente necesita una credencial que no tiene. Entonces envía una **solicitud de credenciales** en el chat, pidiéndote las claves concretas que necesita.

Cuando veas una tarjeta de solicitud de credenciales:

1. Revisa los nombres de las credenciales que se piden.
2. Elige si introduces valores nuevos o reutilizas los que ya tienes guardados.
3. Haz clic en **Guardar**. Los valores se guardan, se conceden al agente que los pidió y el agente continúa automáticamente.

El agente solo sabe qué nombres de credenciales se proporcionaron. Los valores reales nunca pasan por el chat.

## Notas de seguridad

* Los valores se cifran antes de llegar a la base de datos.
* Ningún endpoint devuelve el valor de una credencial, ni siquiera a su propietario.
* Los cuatro últimos caracteres se muestran solo para ayudarte a reconocer qué clave está guardada.
* Las credenciales gestionadas las controla la integración a la que pertenecen y deben cambiarse desde la página de configuración de esa integración.

## Próximos pasos

> [card] [Conecta aplicaciones](https://docs.kolmena.ai/es/integrations/connect-apps.md)
>
> Conecta aplicaciones que usan estas credenciales.

> [card] [Habilidades](https://docs.kolmena.ai/es/integrations/skills.md)
>
> Instala habilidades que pueden necesitar credenciales.

> [card] [Navegadores](https://docs.kolmena.ai/es/integrations/browsers.md)
>
> Vincula un navegador para acceder a la web.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.