Agent Client Protocol (ACP)

Agent Client Protocol (ACP) 是 Zed 推出的智能体通用通信协议，用于将智能体的核心能力（服务端）与用户界面（客户端）解耦，让不同的智能体服务端和客户端能在统一协议下灵活组合与交互。
TRAE CLI 支持 ACP 协议，可作为智能体服务端，与所有支持 ACP 协议的编辑器实现无缝集成。

手动启动 ACP 服务器

执行以下命令启动 ACP 服务器，然后即可在 Zed 官方声明支持的 ACP Client 中使用 TRAE CLI。

traecli acp serve

通常无需手动执行上述命令来启动 ACP 服务器。实际使用中，ACP Client 会通过 subprocess 方式自动启动该服务器，下文将以 Zed 编辑器为例，详细说明集成步骤。

示例：在 Zed 中集成 TRAE CLI

在 Zed 中通过 ACP 协议集成 TRAE CLI 的步骤如下：

1. 新建 ~/.config/zed/settings.json 文件。若已存在该文件，跳过此步骤。

2. 在 ~/.config/zed/settings.json 文件中，新增以下配置：

   {
     "agent_servers": {
       "TRAE CLI": {
         "type": "custom",
         "command": "traecli",
         "args": ["acp", "serve"],
         "env": {}
       }
     }
   }
   

   参数说明如下：

   参数	描述
   type	指定服务端的类型。"custom" 表示用户自定义的服务端，需要指定启动命令。
   command	指定启动服务端的可执行文件或命令，Zed 将调用这个命令来启动 ACP 服务器，此处为系统中的 traecli 可执行文件 。
   args	指定传给 command 的命令行参数，等价于在终端执行：traecli acp serve；其中 "acp" 是子命令，"serve" 是动作参数，用于启动 ACP 服务器。
   env	指定启动服务端时的环境变量。空对象 {} 表示使用默认系统环境变量。

3. 在 Zed 编辑器侧边的 New Thread 面板中，新建 TRAE CLI 线程。
   集成完毕，你可以在 Zed 编辑器中使用 TRAE CLI。