> ## 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.

# 密钥

> 保存 API 密钥和密码，让 Research 可以通过脚本调用你的其他工具，且值不会出现在聊天中。

密钥让 Research 可以使用你的其他工具，例如 PagerDuty、Grafana 或内部 API。Research 会编写一个简短的脚本，脚本以环境变量的形式读取密钥，例如 `$PAGERDUTY_API_KEY`。Research 永远看不到密钥的值。

![Settings 中的 Secrets 页面，显示四个组织密钥](https://mintcdn.com/enclave/1alCsqvPvQsOJ-2n/images/product/secrets-list.png?fit=max\&auto=format\&n=1alCsqvPvQsOJ-2n\&q=85\&s=96f2e359f99274943e61fb34668d1364)

## 添加密钥

1. 打开 **Settings → Secrets**。选择 **Organization** 或 **Personal** 标签页，然后点击 **New secret**。
2. 在 **Name** 中输入由大写字母、数字和下划线组成的名称，例如 `DATADOG_API_KEY`。脚本使用这个名称。
3. 粘贴 **Value**。大多数凭据选择 **Key-value**。对于双因素验证码，选择 **TOTP** 并粘贴设置时的种子，脚本会据此生成当前验证码。
4. 添加 **Note**，写明密钥的用途以及发送到哪个主机。Research 会读取备注来选择正确的密钥。
5. 点击 **Create secret**。

![New secret 面板，已填写名称、隐藏的值和备注](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** 默认开启。保存后，任何人都无法再次查看该值，也无法关闭隐藏。你仍然可以替换该值。

要一次添加多个密钥，请点击 **Bulk add secrets**，然后像 `.env` 文件一样每行粘贴一个 `NAME=value`。

## 让 Research 请求密钥

当 Research 需要你尚未保存的凭据时，会在聊天中显示一张卡片。粘贴值并点击 **Save secret**。值会直接保存到 Secrets，而不会进入聊天。Research 从下一条命令起即可使用它，以后的会话中也可以使用。

![Research 会话中显示一张卡片，请用户保存 PagerDuty API 密钥](https://mintcdn.com/enclave/1alCsqvPvQsOJ-2n/images/product/secrets-chat.png?fit=max\&auto=format\&n=1alCsqvPvQsOJ-2n\&q=85\&s=0cfcb21c563467dd4b8adb6b33f3685a)

## 谁可以使用密钥

* **Organization**: 可在所有成员的 Research 会话和工作流运行中使用。只有 **Owner** 和 **Admin** 可以添加、编辑或删除。成员可以看到名称和备注，但看不到值。
* **Personal**: 只能在你自己的 Research 会话中使用。任何人都可以添加。

如果两者同名，将使用你的个人密钥。

## 编辑或删除密钥

在列表中点击某个密钥，即可替换其值、修改备注或删除它。使用已删除密钥的脚本将无法运行。

> [!NOTE]
>
> Research 只会将密钥发送到该服务的官方 API 主机，或你指定的主机。即使你要求，它也不会输出密钥的值。


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