ACP Server
开始使用
库 · TS & Rust 1.0

ACP SDK 与库

除非你在给一门新语言写绑定，否则不要手写 JSON-RPC framing。官方 SDK 同时覆盖客户端和 Agent 两侧。

TypeScript SDK

官方 SDK

没有语言限制就从这里开始。

TypeScript
1.0

@agentclientprotocol/sdk

npm install @agentclientprotocol/sdk
Docs GitHub
Rust
1.0 runtime / 2.x crate

agent-client-protocol

cargo add agent-client-protocol
Docs GitHub
Python
Official

agent-client-protocol

pip install agent-client-protocol
Docs GitHub
Java
Official

java-sdk

See Maven/Gradle setup in the Java SDK README
Docs GitHub
Kotlin
JVM first

com.agentclientprotocol:acp

implementation("com.agentclientprotocol:acp")
Docs GitHub

社区库

能用，但要核对它们跟当前 schema 的距离。官方列表在 agentclientprotocol.com/libraries/community。

Go

acp-go-sdk

Go

acp-go

.NET

acp-csharp

.NET

Acp.Net

Swift

swift-acp

Swift

acp-swift-sdk

Dart

acp_dart

C++

acp-cpp

Elixir

raxol_agent_client_protocol

Crystal

acp.cr

Emacs Lisp

acp.el

React

use-acp

怎么选

TypeScript / JavaScript

用 @agentclientprotocol/sdk。旧的 AgentSideConnection / ClientSideConnection 已弃用，改用 agent() 和 client()。

Rust

运行时用 agent-client-protocol，线上类型用 agent-client-protocol-schema。Zed 自己就用这套。草案 v2 需显式打开。

Python

PyPI 上的 agent-client-protocol：Pydantic 模型、异步 agent/client 基类，以及包含 Gemini CLI 桥的示例。

JVM

Java SDK 加上 kotlin-sdk（先做 JVM，其他 target 进行中）。JetBrains Koog 也有 ACP 集成。

SDK 里的 v2

Rust crate 2.x 可以通过 unstable_protocol_v2 / .v2() 暴露草案 v2。生产流量继续走 v1，直到协议被标成稳定。对齐 schema 版本比追最新 crate 号更重要。

SDK FAQ