密钥
T3 Code 可以从密钥提供方(provider)读取凭据,因此凭据留在你的密码管理器里,T3 Code 只保存对它的引用。智能体也可以在一张私密卡片里向你索取密钥,而不是在聊天中索取。
密钥设置页仍在预览中,尚未进入每一个构建。来自智能体的密钥请求则在各处都能使用。
密钥提供方
1Password 是受支持的提供方。T3 Code 通过 1Password CLI(op)读取密钥,因此运行 T3 Code 服务器的那台机器上必须安装 op 并完成登录。当你在另一台机器上或从手机使用 T3 Code 时,指的是那台远程机器,而不是你面前的设备。
桌面登录会在那台机器上请求批准,远程用户无法应答。在远程或无头服务器上,请改为让 op 通过服务账号或 Connect 服务器登录。
添加时,打开设置 → 密钥,选择添加提供方,然后输入名称和 1Password 账号:简写、登录地址(不含 https://)或 ID,以 op account list 的显示为准。密钥提供方属于你当前连接的环境(environment)。每个环境各自保存自己的列表。
使用密钥引用
设置里的凭据字段,例如提供方(provider)的环境变量和凭据、源代码管理令牌、用量限制密钥以及设备主机令牌,会在字段旁显示来源选择器。选择值以保存凭据本身,或选择一个密钥提供方并输入引用,例如 op://vault/item/field。在 1Password 中用复制密钥引用来复制该引用。
T3 Code 在需要时才读取密钥,例如某个提供方启动时。在 1Password 中更改凭据,然后刷新,即可使用新值。
无法读取密钥时
如果 1Password 处于锁定或已登出,需要该密钥的提供方(provider)或功能会显示错误,并写明该密钥提供方的名称。在服务器所在的机器上解锁 1Password,然后在设置 → 提供方中选择刷新。T3 Code 绝不会用另一次登录去替换一份它读不到的已保存凭据。
移除密钥提供方
在设置 → 密钥中移除密钥提供方时,T3 Code 会列出从它读取的字段。移除会清空这些字段,所以请在再次需要之前重新设置。1Password 里的密钥不会被改动。
智能体索取密钥时
需要令牌或密码的智能体会在对话线程(thread)里显示一张密钥请求卡片,而不是让你把内容粘贴进聊天。输入或粘贴该值并选择安全保存,或选择拒绝。你可以从 Web、桌面应用或移动应用应答。
如果该环境有密钥提供方,卡片还允许你选中它并输入引用,而不是输入值。T3 Code 只在你应答时读取一次密钥。如果 1Password 已锁定,卡片会如此说明,请求保持打开:解锁后重试,或改为输入值。
该值绝不会出现在对话里。大多数请求也不会把它交给智能体:T3 Code 把它传给需要它的工具。当智能体必须带着该值运行命令(command)时,卡片会另行说明:该值会写入一个私有文件,智能体的命令大约可以在 24 小时内读取它。