---
title: "配置 AI 代理的工具"
description: "学习如何配置 AI 代理的工具。"
canonical_url: "https://tiptap.zhcndoc.com/content-ai/capabilities/agent/custom-llms/tools"
---

# 配置 AI 代理的工具

学习如何配置 AI 代理的工具。

工具是 AI 代理的构建块。它们定义了 AI 模型可以采取的与环境互动的行动。

Tiptap AI 代理扩展提供了一组内置工具，使您的 AI 代理能够读取和编辑富文本文档。

尽管 AI 代理扩展提供了一组内置工具，您也可以[定义自定义工具](#custom-tools)来扩展您的 AI 代理的能力。

## 内置工具

### `read_first_chunk`

从文档开头开始读取当前文档。

### `read_next_chunk`

读取文档的下一部分。

### `read_previous_chunk`

读取文档的上一部分。

### `apply_diff`

这是 AI 代理用于更改文档的主要工具。它将一系列差异应用到文档中。每个差异包含：

- 变更前的内容，用于定位编辑位置。
- 需要删除的内容
- 需要插入的内容

### `replace_document`

用新内容替换整个文档。

### `plan`

规划要完成的工作。它会生成 Markdown 格式的步骤列表。

### `ask_user`

向用户提问。

### `finish_with_summary`

标记任务已完成，并以 Markdown 格式提供总结。

## 自定义内置工具

您可以通过配置 `AiAgentToolkit` 实例来移除或替换内置工具。

```ts
import {
  AiAgentToolkit,
  planTool,
  askUserTool,
  readFirstChunkTool,
  readNextChunkTool,
  readPreviousChunkTool,
  replaceDocumentTool,
  finishWithSummaryTool,
  applyDiffTool,
} from '@tiptap-pro/extension-ai-agent-server'

const toolkit = new AiAgentToolkit({
  tools: [
    // 这些都是所有内置工具。根据需要移除或替换它们。
    planTool(),
    askUserTool(),
    readFirstChunkTool(),
    readNextChunkTool(),
    readPreviousChunkTool(),
    replaceDocumentTool(),
    finishWithSummaryTool(),
    applyDiffTool(),
  ],
})
```

## 自定义工具

除了内置工具，您还可以定义额外的工具。自定义工具有两种类型：

- [**客户端工具**](https://tiptap.zhcndoc.com/content-ai/capabilities/agent/custom-llms/client-side-tools.md) 在客户端运行。它们与编辑器内容交互。例如：用于计数文档中的单词数的工具，或者用于格式化文档的工具。所有内置工具都是客户端工具。
- [**服务器端工具**](https://tiptap.zhcndoc.com/content-ai/capabilities/agent/custom-llms/server-side-tools.md) 在服务器端运行。它们与外部数据源交互。例如：用于网络搜索的工具，或用于查询数据库的工具。