# 工具组合

用于研究 agent、编码 agent 和长时间运行 agent 的常见 Anthropic 工具配对。

---

Anthropic 提供的工具设计为协同工作。常见的 agent 模式将覆盖工作流互补阶段的工具配对：一个工具收集或发现，另一个处理或执行。以下组合是起点，而非处方。根据你的任务进行组合。

每个代码片段仅展示 `tools` 数组。完整的请求格式参见[处理工具调用](/docs/en/agents-and-tools/tool-use/handle-tool-calls)。

## 研究 agent：web_search + code_execution

搜索查找来源；代码执行分析和综合。Claude 搜索数据，然后编写 Python 来处理、制表或可视化数据。这种配对适合需要最新信息和对该信息进行非平凡计算的问题，例如"比较前五大云提供商本季度的收益"。

```json
{
  "tools": [
    { "type": "web_search_20260209", "name": "web_search" },
    { "type": "code_execution_20250825", "name": "code_execution" }
  ]
}
```

流程通常是搜索，然后执行，如果第一轮发现了缺口则可选地再次搜索。代码执行在服务端运行，因此无需管理客户端沙箱。

## 编码 agent：text_editor + bash

文本编辑器读取和修改文件；bash 运行测试和构建命令。这是经典的软件开发循环：检查代码、进行编辑、运行测试、重复。两个工具都是客户端执行的，因此你的应用程序控制哪些文件和命令可访问。

```json
{
  "tools": [
    { "type": "text_editor_20250728", "name": "str_replace_based_edit_tool" },
    { "type": "bash_20250124", "name": "bash" }
  ]
}
```

如果 agent 操作不受信任的代码，请配合受限的工作目录和命令白名单使用。执行契约参见[文本编辑器工具](/docs/en/agents-and-tools/tool-use/text-editor-tool)和 [Bash 工具](/docs/en/agents-and-tools/tool-use/bash-tool)。

## 先引用后获取：web_search + web_fetch

搜索呈现候选 URL；获取检索相关页面的完整内容。这避免了预先获取所有内容。Claude 运行搜索，检查摘要，挑选两三个看起来相关的结果，然后仅获取这些。

```json
{
  "tools": [
    { "type": "web_search_20260209", "name": "web_search" },
    { "type": "web_fetch_20260209", "name": "web_fetch" }
  ]
}
```

当答案存在于长篇内容中（文档页面、文章、规范）且搜索摘要无法完全捕获时，这种配对很有用。获取会拉取完整页面，以便 Claude 引用特定段落。

## 长时间运行 agent：memory + 任意工具集

Memory 跨对话持久化状态；其他工具执行工作。将 memory 添加到任何需要记住先前会话的 agent 中，例如回忆客户早期问题的支持 agent 或跟踪上周决策的项目助手。

```json
{
  "tools": [{ "type": "memory_20250818", "name": "memory" }]
}
```

在同一数组中将你的其他工具与 `memory` 一起添加。

Memory 与你的其他工具集正交。它不改变其他工具的行为；它为 Claude 提供一个地方来记录和稍后检索在上下文窗口重置时会丢失的事实。存储模型参见 [Memory 工具](/docs/en/agents-and-tools/tool-use/memory-tool)。

## 一体化：computer_use

Computer use 工具通过操作完整桌面来包含大多数其他工具。Claude 看到截图并发出鼠标和键盘操作，这意味着它可以驱动任何人能使用的应用程序。当任务需要更具体的工具无法触及的任意 GUI 交互时使用：没有 API 的遗留软件、视觉验证步骤，或跨多个桌面应用的工作流。

```json
{
  "tools": [
    {
      "type": "computer_20250124",
      "name": "computer",
      "display_width_px": 1280,
      "display_height_px": 800
    }
  ]
}
```

Computer use 是最通用的选项，也是最慢的，因为每个操作都需要截图往返。当更窄的工具覆盖你的用例时优先使用它们，当没有其他工具合适时再使用 computer use。沙箱设置参见 [Computer use 工具](/docs/en/agents-and-tools/tool-use/computer-use-tool)。

## 下一步

<CardGroup cols={2}>
  <Card
    title="工具参考"
    icon="book"
    href="/docs/en/agents-and-tools/tool-use/tool-reference"
  >
    Anthropic 提供的工具完整目录，包含类型字符串和参数。
  </Card>
  <Card
    title="工具使用概览"
    icon="map"
    href="/docs/en/agents-and-tools/tool-use/overview"
  >
    工具使用的工作原理，以及何时使用 Anthropic 工具与自定义工具。
  </Card>
</CardGroup>