---
title: "Tiptap 的 AI 代理扩展"
description: "构建编辑富文本文件的 AI 代理——从简单的聊天助手到复杂的文档编辑工作流。"
canonical_url: "https://tiptap.zhcndoc.com/content-ai/capabilities/agent/overview"
---

# Tiptap 的 AI 代理扩展

构建编辑富文本文件的 AI 代理——从简单的聊天助手到复杂的文档编辑工作流。

> **已废弃:**
>
> 该扩展正在被 AI 工具包逐步取代，AI 工具包提供了增强的功能和现代化的 API。虽然您仍然可以继续使用此扩展，但我们建议您在新的实现中探索 AI 工具包。

集成 AI 代理扩展，构建能编辑富文本文档的代理。集成现成的助手，或为您自己的代理添加编辑工具。

> **Interactive demo:** [AiAgent](https://feature-beta-ai-extensions--tiptap-pro.netlify.app/preview/Extensions/AiAgent)

AI 代理扩展使您能够构建一个 AI 助手，该助手可以根据用户定义的任务读取、回答问题并编辑您的文档。

> **已经有 AI 代理了吗？:**
>
> 使用 Tiptap 的 AI 代理扩展，赋予它文本编辑超能力。它为代理提供快速高效读取和编辑富文本文档的工具。

## 主要特点

- 快速高效地编辑大型文档。
- 理解文档结构，包括自定义元素。
- 可与外部数据源和 RAG 管道集成。
- 关注编辑器中选定的内容。
- 允许您的用户审阅并接受/拒绝 AI 生成的更改。

## 使用 Tiptap 的 AI 代理 — 或构建您自己的

使用 AI 代理扩展有两种方式：

- [与 Tiptap Cloud 一起使用](https://tiptap.zhcndoc.com/content-ai/capabilities/agent/use-with-content-ai-cloud.md)，提供托管的、即用型 AI 代理。
- [将其添加到您现有的 AI 代理中](https://tiptap.zhcndoc.com/content-ai/capabilities/agent/custom-llms.md)，在您的后端托管。

AI 代理扩展为流行的 AI 提供商库提供工具定义：

- [Vercel 的 AI SDK](https://tiptap.zhcndoc.com/content-ai/capabilities/ai-toolkit/agents/tools/ai-sdk.md)
- [LangChain.js](https://tiptap.zhcndoc.com/content-ai/capabilities/ai-toolkit/agents/tools/langchain-js.md)
- [OpenAI](https://tiptap.zhcndoc.com/content-ai/capabilities/ai-toolkit/agents/tools/openai.md)

## 什么是 AI 代理？

AI 代理是能够通过自主决策完成复杂任务的系统。不同于简单的聊天助手，AI 代理不仅能以文本回复，还能调用“工具”与环境交互。

Tiptap AI 代理扩展为 AI 代理提供执行以下操作的工具：

- 读取文档
- 重写文档内容
- 制定计划，与用户交互，并创建所做更改的摘要

这些内置工具针对富文本编辑进行了优化，遵循大语言模型（LLM）的最佳实践，让您专注于应用的核心逻辑。它们可以与用于数据检索的自定义工具结合使用。

当调用带有这些工具的 LLM 时，它会选择一个工具执行。然后，Tiptap AI 代理扩展应用该工具至编辑器，以高效地修改文档或读取其内容。在典型实现中，LLM 在服务器端调用，文档编辑在浏览器中进行。

可以把 LLM 看作 AI 代理的“大脑”，负责决定调用哪些工具。Tiptap AI 代理扩展则充当“手”和“眼”，使代理能够读取和交互文档。

通过将 AI 代理扩展与 Tiptap Cloud 结合使用，您无需担心服务器 — 我们为您构建好了。但如果您想自定义 LLM 以及 AI 代理可用的工具（使其能执行其他操作，如搜索外部数据源），可以将 AI 代理扩展与您自己的后端集成。
