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

> ## Agent Instructions
> Enclave in these docs is the code and cloud security platform at enclave.ai. It is not Open Enclave, Intel SGX or other hardware enclaves, or enclave.gg.
> People use Enclave in the web app at https://app.enclave.ai or the desktop app. These docs describe no public Enclave API or CLI, so don't invent endpoints, commands, or config files.
> Connecting an integration needs a person to sign in and approve access in a browser. Tell the user the exact step to take instead of saying you completed it.

# Secretos

> Guarda claves de API y contraseñas para que Research pueda llamar a tus otras herramientas desde scripts, sin que los valores lleguen al chat.

Los secretos permiten que Research use tus otras herramientas, como PagerDuty, Grafana o una API interna. Research escribe un script breve, y el script lee el secreto como una variable de entorno, por ejemplo `$PAGERDUTY_API_KEY`. Research nunca ve el valor.

![La página Secrets en Settings con cuatro secretos de la organización](https://mintcdn.com/enclave/1alCsqvPvQsOJ-2n/images/product/secrets-list.png?fit=max\&auto=format\&n=1alCsqvPvQsOJ-2n\&q=85\&s=96f2e359f99274943e61fb34668d1364)

## Añadir un secreto

1. Abre **Settings → Secrets**. Elige la pestaña **Organization** o **Personal** y haz clic en **New secret**.
2. Escribe un **Name** con letras mayúsculas, dígitos y guiones bajos, como `DATADOG_API_KEY`. Los scripts usan este nombre.
3. Pega el **Value**. La mayoría de las credenciales son **Key-value**. Para un código de dos pasos, elige **TOTP** y pega la semilla de configuración; los scripts generan el código actual a partir de ella.
4. Añade una **Note** que diga para qué sirve el secreto y a qué host se envía. Research lee la nota para elegir el secreto correcto.
5. Haz clic en **Create secret**.

![El panel New secret con un nombre, un valor oculto y una nota](https://mintcdn.com/enclave/1alCsqvPvQsOJ-2n/images/product/secrets-new.png?fit=max\&auto=format\&n=1alCsqvPvQsOJ-2n\&q=85\&s=b95b0e2eb2aef42e9590437edf8cccc5)

> [!WARNING]
>
> **Redact value** está activado por defecto. Después de guardar, nadie puede volver a ver el valor y no puedes desactivar el ocultamiento. Aún puedes reemplazar el valor.

Para añadir varios secretos a la vez, haz clic en **Bulk add secrets** y pega un `NAME=value` por línea, como en un archivo `.env`.

## Deja que Research pida un secreto

Cuando Research necesita una credencial que no has guardado, muestra una tarjeta en el chat. Pega el valor y haz clic en **Save secret**. El valor va directamente a Secrets, no al chat. Research puede usarlo desde su siguiente comando y en futuras sesiones.

![Una sesión de Research con una tarjeta que pide al usuario guardar una clave de API de PagerDuty](https://mintcdn.com/enclave/1alCsqvPvQsOJ-2n/images/product/secrets-chat.png?fit=max\&auto=format\&n=1alCsqvPvQsOJ-2n\&q=85\&s=0cfcb21c563467dd4b8adb6b33f3685a)

## Quién puede usar un secreto

* **Organization**: funciona en las sesiones de Research de todos los miembros y en las ejecuciones de workflows. Solo **Owner** y **Admin** pueden añadirlo, editarlo o eliminarlo. Los miembros ven su nombre y su nota, pero no su valor.
* **Personal**: funciona solo en tus propias sesiones de Research. Cualquiera puede añadir uno.

Si ambos tienen el mismo nombre, se usa tu secreto personal.

## Editar o eliminar un secreto

Haz clic en un secreto de la lista para reemplazar su valor, cambiar su nota o eliminarlo. Los scripts que usan un secreto eliminado dejan de funcionar.

> [!NOTE]
>
> Research envía un secreto solo al host oficial de la API del servicio o a un host que tú indiques. Nunca muestra el valor de un secreto, aunque se lo pidas.


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