当 Perplexity Computer 需要访问没有内置连接器的第三方 API 时,你可以安全地提供自己的 API 凭证。你的密钥会被加密并存储,因此不会在代理轨迹(与第三方模型交换的提示和回答)中共享,也不会与任务沙盒共享。在任务中提供凭证适用于所有 Perplexity 客户端;用于保存和管理凭证的凭证库可在网页端使用。
概述
你希望 Computer 使用的一些工具可能还没有内置连接器。自定义凭证可让你自带 API 凭证,使 Computer 能代表你向该服务进行身份验证——例如发送交易邮件、从分析 API 拉取数据,或从数据提供商查询体育比分。Computer 支持这些 API 使用的身份验证方式:令牌、自定义标头、查询参数以及用户名和密码。如果你提供用户名和密码,Computer 会将其保存为 Basic auth 凭证,以便安全地向 API 验证身份。
当任务需要凭证时,Computer 会显示一个安全表单供你填写。你的凭证会被加密,并通过安全代理注入到传出的 API 请求中,因此原始值不会与代理或任务沙盒共享。你可以选择凭证保留多久:仅用于本次任务、保存到个人凭证库以便复用,或与项目共享以便队友也能使用。你在任务中添加的凭证会在该 Computer 会话期间保持可用,并可随时撤销。如果将其保存到个人凭证库,Computer 会在任务需要时自动使用它,因为新凭证默认设为始终允许。你可以在凭证库中将凭证切换为请求批准。
为什么使用自定义凭证?
连接没有内置连接器的服务。自带第三方工具的 API 密钥,让 Computer 可以立即配合使用。
避免让代理看到机密。凭证会被加密并通过安全代理注入,因此原始值不会与代理或沙盒共享。
在多个任务中复用密钥。将凭证保存到个人凭证库一次,即可让 Computer 在未来任务中复用。
与项目共享访问权限。将凭证添加到项目,让团队中的所有人都能使用,而无需共享原始密钥。
保持掌控。对于每个已保存凭证,你可以选择允许 Computer 无需批准即可使用,或要求 Computer 在任务中使用前征求你的批准。
添加自定义凭证前,请检查该服务是否已有内置连接器。连接器是关联第三方服务的首选方式;如果可用,Computer 会优先使用连接器。请将自定义凭证用于尚无连接器的服务。
如果该服务有内置连接器,该连接器也可能包含在插件中。无论在哪里连接,它都会在你账户的所有位置保持连接。你的连接状态和组织的连接器设置也适用于每个插件。请参阅什么是插件?
三种凭证范围
凭证根据保留时长和可使用者分为三种范围:
会话(单个任务):仅在当前任务中使用,不会保存以供复用。
个人(凭证库):保存到你的个人凭证库,可在你自己的任务中复用。
项目(共享):保存到项目中,让团队中的所有人都能使用。
下文将说明每一种范围的工作方式。
会话凭证(单个任务)
会话凭证是最简单的选项:你为一个任务提供密钥,且不会保存。
你会在任务中收到提示。当任务需要凭证时,Computer 会显示安全表单供你输入。它会尽可能预填主机、名称和凭证类型等详细信息。
它会被加密并通过代理发送。你的凭证会被加密并通过安全代理注入到传出的 API 请求中,因此原始值不会与代理或沙盒共享。
它会在整个任务期间有效。添加后,该凭证会在该任务剩余期间可用,包括后续请求。
它不会被保存。会话凭证不会为复用而存储——开始新任务时会再次提示你。如果想将来复用,你可以选择将凭证保存到凭证库。
图 1 — Computer 在任务需要凭证时显示的安全表单。
个人凭证(凭证库)
将凭证保存到个人凭证库后,即可在自己的任务中复用,而无需每次重新输入。
从任务表单保存。当 Computer 提示你输入凭证时,选择保存到凭证库的选项,以便在 Computer 任务中复用。
或者直接添加。前往设置 > 凭证库,即可在任务之外添加和管理凭证。
选择 Computer 何时询问。新凭证默认设为始终允许,因此 Computer 会识别已保存凭证,并在任务需要时使用。如需每次使用前批准,请在凭证库中将该凭证切换为请求批准。
它只对你保持私密。个人凭证属于你的账户,不会与其他任何人共享。
图 2 — 凭证库中已保存的凭证,每个凭证都有各自的批准设置。
项目凭证(与团队共享)
将凭证添加到项目,让该项目中的所有协作者都能使用——这对团队依赖的共享密钥很有用。
在项目中添加。在项目侧边栏中找到凭证库部分,然后选择管理以添加项目凭证。
项目中的所有人都可以使用。项目的所有成员都可以在自己的任务中使用该凭证,但看不到原始值。
写作者可管理它。你至少需要是该项目的写作者,才能添加或撤销项目凭证;其访问规则与项目连接器相同。
选择 Computer 何时询问。新项目凭证默认设为始终允许,因此 Computer 可以在任务中直接使用,无需询问。如果希望 Computer 每次使用前先询问,请将凭证切换为请求批准。
图 3 — 项目侧边栏中的项目凭证。
管理你的凭证
在“设置 > 凭证库”中找到你的凭证库。你的个人凭证库位于账户设置中。如果侧边栏中显示了插件,你也可以尝试从那里打开它:选择添加自定义,然后选择连接你自己的 API。只有当你的套餐和组织设置允许自定义连接器时,才会显示该选项。
添加、查看或移除密钥。打开凭证库即可添加新凭证、查看已保存凭证,或移除不再需要的凭证。
在项目中管理项目凭证。在项目侧边栏的凭证库部分添加或撤销项目凭证。你至少需要是该项目的写作者。
限制和隐私
你的原始密钥保持隐藏。凭证会被加密并通过安全代理注入,因此原始值不会与代理或任务沙盒共享。
仅限 API 请求。自定义凭证支持 Computer 可通过安全代理路由的 API 请求。目前不支持 SSH 密钥等其他机密类型。
已保存凭证默认设为“始终允许”。Computer 会在任务中直接使用已保存的个人凭证或项目凭证,无需询问,除非你将该凭证切换为请求批准。在此默认设置推出前保存的凭证会保留原有设置。
会话凭证不会存储。会话凭证仅在该 Computer 会话中使用,可随时撤销,且不会保存以供后续会话复用,除非你明确选择将该凭证保存到凭证库。
常见问题
会话凭证、个人凭证和项目凭证有什么区别?
会话凭证仅在当前任务中使用且不会保存。个人凭证保存到你的凭证库,可在自己的任务中复用。项目凭证保存到项目中,使该团队中的所有人都能使用。已保存的凭证默认设置为始终允许,你可以将其中任意凭证切换为请求批准。
我应该使用连接器还是自定义凭证?
如果服务有内置连接器,请使用连接器——这是连接第三方服务的首选方式。当你需要的工具没有可用连接器时,再使用自定义凭证。
Computer 能看到我的 API 密钥吗?
不能。你的凭证会被加密并通过安全代理注入到传出请求中,因此原始值不会与代理或任务沙盒共享。如果某个 API 在其响应中包含你的凭证(例如回显请求标头),Computer 可以看到该响应。
为什么 Computer 要求我批准凭证?
只有当已保存的个人凭证或项目凭证设为请求批准时,Computer 才会请求批准。新凭证默认设为始终允许,但在此默认设置推出前保存的凭证会保留原有设置。如需停止某个凭证的批准提示,请在凭证库中该凭证的设置里选择始终允许。
如何在未来任务中复用凭证?
当 Computer 提示时将其保存到凭证库,或直接从凭证库添加。之后的任务中,Computer 会识别并使用该凭证;如果该凭证设为请求批准,则会先询问你。
在哪里找到我的凭证库?
前往设置 > 凭证库。如果侧边栏中显示了插件,你也可以尝试从那里打开它:选择添加自定义,然后选择连接你自己的 API。只有当你的套餐和组织设置允许自定义连接器时,才会显示该选项。
我的队友可以使用我的密钥吗?
可以,前提是你将它们添加为项目凭证。个人凭证对你的账户保持私密。项目凭证可由项目中的所有人使用,而你至少需要是项目写作者才能添加或撤销它们。
我可以存储 SSH 密钥等其他机密吗?
不可以。自定义凭证支持通过安全代理路由的 API 请求。目前不支持 SSH 密钥等其他机密格式。
用户名和密码与我登录该服务网站的凭据相同吗?
不是。当你提供用户名和密码时,Computer 会将它们保存为用于向该服务 API 进行身份验证的 Basic auth 凭证——这不是用于登录该服务网站的通用登录信息。自定义凭证仅用于通过令牌、自定义标头、查询参数或 Basic auth 验证 API 请求。如果不确定应输入哪个值,请查看该 API 文档,了解其预期的请求身份验证方式。
相关文章
需要更多帮助?
通过 Help > Contact Support 联系我们。如果你的问题与特定的 Computer 任务有关,请附上该任务的链接。


