` | 需要用户审批的工具（人机协作） |
| `commands` | `Array<{ name, description, input? }>` | 自定义斜杠命令 |
## 自定义
### 多智能体
你可以从单个服务器暴露多个智能体。ACP 客户端在创建会话时选择使用哪个智能体：
```typescript theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
const server = new DeepAgentsServer({
agents: [
{ name: "code-agent", description: "通用编程" },
{ name: "reviewer", description: "代码审查" },
],
});
```
某些 ACP 客户端（如 Zed）目前不提供在多个智能体之间选择的 UI。在这种情况下，请考虑运行多个单智能体的独立服务器实例。
### 斜杠命令
服务器向 IDE 注册内置的斜杠命令：`/plan`、`/agent`、`/ask`、`/clear` 和 `/status`。你也可以为每个智能体定义自定义命令：
```typescript theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
const server = new DeepAgentsServer({
agents: {
name: "my-agent",
commands: [
{ name: "test", description: "运行项目的测试套件" },
{ name: "lint", description: "运行代码检查并修复问题" },
{
name: "deploy",
description: "部署到预发环境",
input: { hint: "环境（staging 或 production）" },
},
],
},
});
```
### 人机协作
使用 `interruptOn` 在智能体运行敏感工具之前要求在 IDE 中进行用户审批：
```typescript theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
const server = new DeepAgentsServer({
agents: {
name: "careful-agent",
interruptOn: {
execute: { allowedDecisions: ["approve", "edit", "reject"] },
write_file: true,
},
},
});
```
当智能体调用受保护的工具时，IDE 会提示用户允许或拒绝该操作，并可选择为本次会话记住该决定。
### 自定义工具
```typescript theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
import { DeepAgentsServer } from "deepagents-acp";
import { tool } from "@langchain/core/tools";
import { z } from "zod";
const searchTool = tool(
async ({ query }) => {
return `查询结果：${query}`;
},
{
name: "search",
description: "搜索代码库",
schema: z.object({ query: z.string() }),
},
);
const server = new DeepAgentsServer({
agents: {
name: "search-agent",
tools: [searchTool],
},
});
await server.start();
```
### 自定义后端
```typescript theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
import { DeepAgentsServer } from "deepagents-acp";
import { CompositeBackend, FilesystemBackend, StateBackend } from "deepagents";
const server = new DeepAgentsServer({
agents: {
name: "custom-agent",
backend: new CompositeBackend({
routes: [
{
prefix: "/workspace",
backend: new FilesystemBackend({ rootDir: "./workspace" }),
},
{ prefix: "/", backend: new StateBackend() },
],
}),
},
});
await server.start();
```
### 技能和记忆
```typescript theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
import { startServer } from "deepagents-acp";
await startServer({
agents: {
name: "project-agent",
description: "具有项目特定知识的智能体",
skills: ["./skills/", "~/.deepagents/skills/"],
memory: ["./.deepagents/AGENTS.md"],
},
workspaceRoot: process.cwd(),
});
```
请参阅上游 ACP 文档了解协议详情和编辑器支持：
* 介绍：[https://agentclientprotocol.com/get-started/introduction](https://agentclientprotocol.com/get-started/introduction)
* 客户端/编辑器：[https://agentclientprotocol.com/get-started/clients](https://agentclientprotocol.com/get-started/clients)
***
通过 MCP [连接这些文档](/use-these-docs)到 Claude、VSCode 等工具，获取实时答案。
[在 GitHub 上编辑此页面](https://github.com/langchain-ai/docs/edit/main/src/oss/deepagents/acp.mdx)或[提交问题](https://github.com/langchain-ai/docs/issues/new/choose)。