Skip to main content
作者：anna239

​
电梯演讲

您提议进行什么更改？
我建议添加有关代理支持的身份验证方法的更多信息，这将允许客户端绘制更合适的 UI。

​
现状

今天的事情是如何运作的，这导致了什么问题？我们为什么要改变？
代理有不同的用户身份验证方式：带有 api 密钥的环境变量，运行像 <agent_name> login 这样的命令，有些只是打开浏览器并使用 oauth。 AuthMethod 并没有真正告诉客户端应该做什么来身份验证。这意味着我们无法向用户显示用于输入密钥的控件（如果代理支持通过环境变量进行身份验证）。 很少有代理可以完全自行进行身份验证而无需用户输入，因此支持 ACP 身份验证的代理在它们可以提供的方法方面受到限制，或者需要在作为 ACP 代理运行之前进行手动设置。

​
我们提议对此做什么

您提议如何改善情况？
我们可以添加 AuthMethods 的其他类型，为客户端提供额外信息，以便它们可以帮助登录过程。

​
美好的未来

一旦这个功能存在，事情将如何发展？
从 IDE 内部开始使用代理对最终用户来说会更容易，因为身份验证过程将更加直接

​
实施细节和计划

告诉我更多关于您的实施。我的详细实施计划是什么？
我建议添加以下身份验证类型：
  1. 代理身份验证
与现有的相同——代理自己处理身份验证，如果未提供类型，这应该是默认类型以保持向后兼容 
{
  "id": "123",
  "name": "Agent",
  "description": "通过代理进行身份验证",
  "type": "agent" // 可选/默认值
}
  1. 环境变量
用户可以输入密钥，客户端会将其作为环境变量传递给代理 
{
  "id": "123",
  "name": "OpenAI api key",
  "description": "提供您的密钥",
  "type": "env_var",
  "varName": "OPEN_AI_KEY",
  "link": "可选链接到用户可以获取密钥的页面"
}
由于这需要在进程启动时提供给代理，客户端可以检查是否已经向进程传递了这样的环境变量，在这种情况下，用户可以单击按钮，代理将读取已经可用的密钥。 否则，当用户单击按钮时，客户端可以重新启动带有所需环境变量的代理进程，然后自动发送带有正确 ID 的身份验证消息以代表用户登录。
  1. 终端身份验证
已经有关于”终端身份验证”体验的实验作为后备。这需要客户端能够运行交互式终端，让用户通过 TUI 登录。 
{
  "id": "123",
  "name": "在终端中运行",
  "description": "设置标签",
  "type": "terminal",
  "args": ["--setup"],
  "env": { "VAR1": "value1", "VAR2": "value2" }
}
不能指定 command；客户端将使用完全相同的设置调用完全相同的二进制文件。代理可以根据需要提供额外的参数和环境变量。这些将额外提供在服务器启动时默认提供的任何参数/环境变量。因此，代理需要有一种方式来启动它们的交互式登录流程，即使提供了正常的 acp 命令/参数也是如此。 这样代理就不需要知道它运行的环境。它不一定知道绝对路径，并且不应该能够提供其他命令或程序以最大程度地减少安全问题。

​
AuthErrors

将 AuthMethod 列表包含在 AUTH_REQUIRED JsonRpc 错误中可能很有用。如果它们已经在 initialize 中共享，为什么我们需要这个： 所有支持的身份验证方法在 initialize 期间共享。当用户启动会话时，他们已经选择了一个模型，这可以缩小选项列表。 
{
  "jsonrpc": "2.0",
  "id": 2,
  "error": {
    "code": -32000,
    "message": "需要身份验证",
    "authMethods": [
      {
        "id": "chatgpt",
        "name": "使用 ChatGPT 登录",
        "description": "使用您的 ChatGPT 登录 Codex CLI（需要付费的 ChatGPT 订阅）"
      }
    ]
  }
}

​
常见问题

在编写本文档的过程中或随后的讨论中出现了哪些问题？

​
您考虑了哪些替代方法，为什么选择这一个？

一种替代方法是将此信息包含在代理的声明中，使其更加静态，请参阅 Registry RFD 还有一种添加单独的 elicitation 功能的替代方法，就是为此创建一个单独的身份验证类型。然后客户端可以自己决定是否支持它。

​
修订历史

有关于征求建议的部分 https://github.com/agentclientprotocol/agent-client-protocol/blob/939ef116a1b14016e4e3808b8764237250afa253/docs/rfds/auth.mdx 已删除，稍后将移至单独的 rfd
  • 2026-01-14：根据核心维护者讨论进行更新