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

> ## Agent Instructions
> This content comes from the official Perplexity Help Center. Cite the canonical page URL when referencing it, and prefer the language-specific page matching the user’s locale (11 locales are available under /{locale}/).

# 在 Computer 中使用自定义 API 凭证

> 当 Computer 需要访问没有内置连接器的第三方 API 时，你可以安全地提供自己的 API 凭证。

当 Perplexity Computer 需要访问没有内置连接器的第三方 API 时，你可以安全地提供自己的 API 凭证。你的密钥会被加密并存储，因此不会在代理轨迹（与第三方模型交换的提示和回答）中共享，也不会与任务沙盒共享。在任务中提供凭证适用于所有 Perplexity 客户端；用于保存和管理凭证的凭证库可在网页端使用。

## 概述

你希望 Computer 使用的一些工具可能还没有内置连接器。自定义凭证可让你自带 API 凭证，使 Computer 能代表你向该服务进行身份验证——例如发送交易邮件、从分析 API 拉取数据，或从数据提供商查询体育比分。Computer 支持这些 API 使用的身份验证方式：令牌、自定义标头、查询参数以及用户名和密码。如果你提供用户名和密码，Computer 会将其保存为 Basic auth 凭证，以便安全地向 API 验证身份。

当任务需要凭证时，Computer 会显示一个安全表单供你填写。你的凭证会被加密，并通过安全代理注入到传出的 API 请求中，因此原始值不会与代理或任务沙盒共享。你可以选择凭证保留多久：仅用于本次任务、保存到个人凭证库以便复用，或与项目共享以便队友也能使用。你在任务中添加的凭证会在该 Computer 会话期间保持可用，并可随时撤销。如果将其保存到个人凭证库，Computer 会在任务需要时自动使用它，因为新凭证默认设为**始终允许**。你可以在凭证库中将凭证切换为**请求批准**。

## 为什么使用自定义凭证？

<ul>
  <li>
    **连接没有内置连接器的服务。**自带第三方工具的 API 密钥，让 Computer 可以立即配合使用。
  </li>

  <li>
    **避免让代理看到机密。**凭证会被加密并通过安全代理注入，因此原始值不会与代理或沙盒共享。
  </li>

  <li>
    **在多个任务中复用密钥。**将凭证保存到个人凭证库一次，即可让 Computer 在未来任务中复用。
  </li>

  <li>
    **与项目共享访问权限。**将凭证添加到项目，让团队中的所有人都能使用，而无需共享原始密钥。
  </li>

  <li>
    **保持掌控。**对于每个已保存凭证，你可以选择允许 Computer 无需批准即可使用，或要求 Computer 在任务中使用前征求你的批准。
  </li>
</ul>

> [!NOTE]
>
> 添加自定义凭证前，请检查该服务是否已有内置连接器。连接器是关联第三方服务的首选方式；如果可用，Computer 会优先使用连接器。请将自定义凭证用于尚无连接器的服务。

如果该服务有内置连接器，该连接器也可能包含在插件中。无论在哪里连接，它都会在你账户的所有位置保持连接。你的连接状态和组织的连接器设置也适用于每个插件。请参阅[什么是插件？](https://www.perplexity.ai/help-center/help-center/zh-CN/articles/2026100701-shenme-shi-chajian.md)

## 三种凭证范围

凭证根据保留时长和可使用者分为三种范围：

<ul>
  <li>
    **会话（单个任务）：**仅在当前任务中使用，不会保存以供复用。
  </li>

  <li>
    **个人（凭证库）：**保存到你的个人凭证库，可在你自己的任务中复用。
  </li>

  <li>
    **项目（共享）：**保存到项目中，让团队中的所有人都能使用。
  </li>
</ul>

下文将说明每一种范围的工作方式。

## 会话凭证（单个任务）

会话凭证是最简单的选项：你为一个任务提供密钥，且不会保存。

<ul>
  <li>
    **你会在任务中收到提示。**当任务需要凭证时，Computer 会显示安全表单供你输入。它会尽可能预填主机、名称和凭证类型等详细信息。
  </li>

  <li>
    **它会被加密并通过代理发送。**你的凭证会被加密并通过安全代理注入到传出的 API 请求中，因此原始值不会与代理或沙盒共享。
  </li>

  <li>
    **它会在整个任务期间有效。**添加后，该凭证会在该任务剩余期间可用，包括后续请求。
  </li>

  <li>
    **它不会被保存。**会话凭证不会为复用而存储——开始新任务时会再次提示你。如果想将来复用，你可以选择将凭证保存到凭证库。
  </li>
</ul>

[![任务中的安全表单，标题为“为 httpbin basic auth 添加凭证”，包含名称、主机、凭证类型、用户名和密码字段，以及“保存到凭证库以在 Computer 任务中复用”选项。](https://mintcdn.com/perplexity-help-center/Qv3d0vQE9qMlZrQx/help-center/assets/img/26ab37cfa8_session-credential-form.png?fit=max\&auto=format\&n=Qv3d0vQE9qMlZrQx\&q=85\&s=4b1b1538c0da2b87d89e336257203067)](../../assets/img/26ab37cfa8_session-credential-form.png)

*图 1 — Computer 在任务需要凭证时显示的安全表单。*

## 个人凭证（凭证库）

将凭证保存到个人凭证库后，即可在自己的任务中复用，而无需每次重新输入。

<ul>
  <li>
    **从任务表单保存。**当 Computer 提示你输入凭证时，选择保存到凭证库的选项，以便在 Computer 任务中复用。
  </li>

  <li>
    **或者直接添加。**前往**设置 > 凭证库**，即可在任务之外添加和管理凭证。
  </li>

  <li>
    **选择 Computer 何时询问。**新凭证默认设为**始终允许**，因此 Computer 会识别已保存凭证，并在任务需要时使用。如需每次使用前批准，请在凭证库中将该凭证切换为**请求批准**。
  </li>

  <li>
    **它只对你保持私密。**个人凭证属于你的账户，不会与其他任何人共享。
  </li>
</ul>

[![Perplexity 设置中的凭证库页面，显示两个已保存凭证：“httpbin basic auth”和“Loops.so emails”；每个凭证都有“请求批准/始终允许”下拉菜单和“添加凭证”按钮。](https://mintcdn.com/perplexity-help-center/kBGsQkSG8SPEk_Ye/help-center/assets/img/e1c1c32ab2_credential-vault-add.png?fit=max\&auto=format\&n=kBGsQkSG8SPEk_Ye\&q=85\&s=899b43b9847e8c08545f62d905a50a9e)](../../assets/img/e1c1c32ab2_credential-vault-add.png)

*图 2 — 凭证库中已保存的凭证，每个凭证都有各自的批准设置。*

## 项目凭证（与团队共享）

将凭证添加到项目，让该项目中的所有协作者都能使用——这对团队依赖的共享密钥很有用。

<ul>
  <li>
    **在项目中添加。**在项目侧边栏中找到**凭证库**部分，然后选择**管理**以添加项目凭证。
  </li>

  <li>
    **项目中的所有人都可以使用。**项目的所有成员都可以在自己的任务中使用该凭证，但看不到原始值。
  </li>

  <li>
    **写作者可管理它。**你至少需要是该项目的写作者，才能添加或撤销项目凭证；其访问规则与项目连接器相同。
  </li>

  <li>
    **选择 Computer 何时询问。**新项目凭证默认设为**始终允许**，因此 Computer 可以在任务中直接使用，无需询问。如果希望 Computer 每次使用前先询问，请将凭证切换为**请求批准**。
  </li>
</ul>

> [!WARNING]
>
> \*\*项目凭证会与项目共享。\*\*任何有权访问项目的人都可以在自己的任务中使用该项目的凭证，因此只添加你打算与该团队共享的密钥。

[![项目侧边栏中高亮显示“凭证”部分，其中包含“添加凭证”按钮，以及一个已保存的“Loops Emails”凭证，主机为 api.loops.so，类型为 bearer。](https://mintcdn.com/perplexity-help-center/Qv3d0vQE9qMlZrQx/help-center/assets/img/2306922c68_project-credential-form.png?fit=max\&auto=format\&n=Qv3d0vQE9qMlZrQx\&q=85\&s=3663691de3732e7b2ab7acae07ed2a6c)](../../assets/img/2306922c68_project-credential-form.png)

*图 3 — 项目侧边栏中的项目凭证。*

## 管理你的凭证

<ul>
  <li>
    **在“设置 > 凭证库”中找到你的凭证库。**你的个人凭证库位于账户设置中。如果侧边栏中显示了**插件**，你也可以尝试从那里打开它：选择**添加自定义**，然后选择**连接你自己的 API**。只有当你的套餐和组织设置允许自定义连接器时，才会显示该选项。
  </li>

  <li>
    **添加、查看或移除密钥。**打开凭证库即可添加新凭证、查看已保存凭证，或移除不再需要的凭证。
  </li>

  <li>
    **在项目中管理项目凭证。**在项目侧边栏的**凭证库**部分添加或撤销项目凭证。你至少需要是该项目的写作者。
  </li>
</ul>

## 限制和隐私

<ul>
  <li>
    **你的原始密钥保持隐藏。**凭证会被加密并通过安全代理注入，因此原始值不会与代理或任务沙盒共享。
  </li>

  <li>
    **仅限 API 请求。**自定义凭证支持 Computer 可通过安全代理路由的 API 请求。目前不支持 SSH 密钥等其他机密类型。
  </li>

  <li>
    **已保存凭证默认设为“始终允许”。**Computer 会在任务中直接使用已保存的个人凭证或项目凭证，无需询问，除非你将该凭证切换为**请求批准**。在此默认设置推出前保存的凭证会保留原有设置。
  </li>

  <li>
    **会话凭证不会存储。**会话凭证仅在该 Computer 会话中使用，可随时撤销，且不会保存以供后续会话复用，除非你明确选择将该凭证保存到凭证库。
  </li>
</ul>

## 常见问题

### 会话凭证、个人凭证和项目凭证有什么区别？

会话凭证仅在当前任务中使用且不会保存。个人凭证保存到你的凭证库，可在自己的任务中复用。项目凭证保存到项目中，使该团队中的所有人都能使用。已保存的凭证默认设置为**始终允许**，你可以将其中任意凭证切换为**请求批准**。

### 我应该使用连接器还是自定义凭证？

如果服务有内置连接器，请使用连接器——这是连接第三方服务的首选方式。当你需要的工具没有可用连接器时，再使用自定义凭证。

### Computer 能看到我的 API 密钥吗？

不能。你的凭证会被加密并通过安全代理注入到传出请求中，因此原始值不会与代理或任务沙盒共享。如果某个 API 在其响应中包含你的凭证（例如回显请求标头），Computer 可以看到该响应。

### 为什么 Computer 要求我批准凭证？

只有当已保存的个人凭证或项目凭证设为**请求批准**时，Computer 才会请求批准。新凭证默认设为**始终允许**，但在此默认设置推出前保存的凭证会保留原有设置。如需停止某个凭证的批准提示，请在凭证库中该凭证的设置里选择**始终允许**。

### 如何在未来任务中复用凭证？

当 Computer 提示时将其保存到凭证库，或直接从凭证库添加。之后的任务中，Computer 会识别并使用该凭证；如果该凭证设为**请求批准**，则会先询问你。

### 在哪里找到我的凭证库？

前往**设置 > 凭证库**。如果侧边栏中显示了**插件**，你也可以尝试从那里打开它：选择**添加自定义**，然后选择**连接你自己的 API**。只有当你的套餐和组织设置允许自定义连接器时，才会显示该选项。

### 我的队友可以使用我的密钥吗？

可以，前提是你将它们添加为项目凭证。个人凭证对你的账户保持私密。项目凭证可由项目中的所有人使用，而你至少需要是项目写作者才能添加或撤销它们。

### 我可以存储 SSH 密钥等其他机密吗？

不可以。自定义凭证支持通过安全代理路由的 API 请求。目前不支持 SSH 密钥等其他机密格式。

### 用户名和密码与我登录该服务网站的凭据相同吗？

不是。当你提供用户名和密码时，Computer 会将它们保存为用于向该服务 API 进行身份验证的 Basic auth 凭证——这不是用于登录该服务网站的通用登录信息。自定义凭证仅用于通过令牌、自定义标头、查询参数或 Basic auth 验证 API 请求。如果不确定应输入哪个值，请查看该 API 文档，了解其预期的请求身份验证方式。

## 相关文章

<ul>
  <li>[什么是插件？](https://www.perplexity.ai/help-center/help-center/zh-CN/articles/2026100701-shenme-shi-chajian.md)</li>
  <li>[添加自定义远程连接器](https://www.perplexity.ai/help-center/help-center/zh-CN/articles/13915507-tian-jia-zi-ding-yi-yuan-cheng-lian-jie-qi.md)</li>
  <li>[什么是项目？](https://www.perplexity.ai/help-center/help-center/zh-CN/articles/10352961-shenme-shi-xiangmu.md)</li>
  <li>[什么是 Computer？](https://www.perplexity.ai/help-center/help-center/zh-CN/articles/13837784-shen-me-shi-computer.md)</li>
</ul>

## 需要更多帮助？

[通过 **Help > Contact Support** 联系我们](https://www.perplexity.ai/?support=true#settings/account)。如果你的问题与特定的 Computer 任务有关，请附上该任务的链接。


## Related topics

- [Computer](https://www.perplexity.ai/help-center/help-center/zh-CN/collections/18534886-computer.md)
- [在 Slack 中使用 Perplexity](https://www.perplexity.ai/help-center/help-center/zh-CN/articles/14016915-zai-slack-zhong-shi-yong-perplexity.md)
- [添加自定义远程连接器](https://www.perplexity.ai/help-center/help-center/zh-CN/articles/13915507-tian-jia-zi-ding-yi-yuan-cheng-lian-jie-qi.md)
- [在 Microsoft Teams 中使用 Perplexity](https://www.perplexity.ai/help-center/help-center/zh-CN/articles/14855210-zai-microsoft-teams-zhong-shiyong-perplexity.md)
