---
title: "服务器评论"
description: "使用服务器 AI 工具包，启用服务器端 AI 代理读取和编辑 Tiptap 文档中的评论。"
canonical_url: "https://tiptap.zhcndoc.com/content-ai/capabilities/server-ai-toolkit/agents/comments"
---

# 服务器评论

使用服务器 AI 工具包，启用服务器端 AI 代理读取和编辑 Tiptap 文档中的评论。

赋予您的 AI 代理读取、编写和编辑文档中评论的能力，完全在服务器端完成。

> **Interactive demo:** [server comments](https://ai-toolkit-demos.vercel.app/server-comments)

查看 [GitHub 上的源码](https://github.com/ueberdosis/ai-toolkit-demos)。

> **继续阅读 AI 代理聊天机器人指南:**
>
> 本指南接续 [AI 代理聊天机器人指南](https://tiptap.zhcndoc.com/content-ai/capabilities/server-ai-toolkit/agents/ai-agent-chatbot.md)。请先阅读它。

## 启用评论工具

要启用评论工具，获取服务器 AI 工具包 API 的工具定义时，传递 `getThreads` 和 `editThreads` 选项。

```ts
import { getAuthHeaders } from '@/lib/server-ai-toolkit/get-auth-headers'

const response = await fetch(`${apiBaseUrl}/v4/ai/toolkit/fetch-tools`, {
  method: 'POST',
  headers: await getAuthHeaders(),
  body: JSON.stringify({
    editorContext,
    tools: {
      // 禁用 tiptap 编辑工具，使 AI 不能编辑文档，
      // 只能添加评论
      tiptapEdit: false,
      // 启用评论工具
      getThreads: true,
      editThreads: true,
    },
  }),
})
```

## 执行评论工具

评论工具需要一个 **Tiptap Cloud 文档**，因为线程和评论存储在 Tiptap Document Server 上。传递 `document: { type: 'cloud', id }`，这样 AI Server 就可以自动从 Document Server 获取它。

### 请求体

在请求体中包含云文档引用：

- `document.id` (`string`，必填)：文档的 ID。
- `user` (`string`，可选)：创建评论的用户 ID。若省略，评论将不关联用户。

```ts
const result = await fetch(`${apiBaseUrl}/v4/ai/toolkit/execute-tool`, {
  method: 'POST',
  headers: await getAuthHeaders('your-document-id'),
  body: JSON.stringify({
    editorContext,
    // 引用 Tiptap Cloud 文档
    document: {
      type: 'cloud',
      id: 'your-document-id',
    },
    user: 'ai-assistant',
    tool: {
      name: 'editThreads',
      input: {},
    },
  }),
})
```

## 最终效果

结果是一个简单但完善的 AI 聊天机器人应用：

> **Interactive demo:** [server comments](https://ai-toolkit-demos.vercel.app/server-comments)

查看 [GitHub 上的源码](https://github.com/ueberdosis/ai-toolkit-demos)。

## 下一步

- 探索 [REST API 参考](https://tiptap.zhcndoc.com/content-ai/capabilities/server-ai-toolkit/api-reference/rest-api.md)