---
title: "在 Content AI Cloud 中使用 AI Agent"
description: "了解如何在 Tiptap Content AI Cloud 中使用 AI Agent 扩展。"
canonical_url: "https://tiptap.zhcndoc.com/content-ai/capabilities/agent/use-with-content-ai-cloud"
---

# 在 Content AI Cloud 中使用 AI Agent

了解如何在 Tiptap Content AI Cloud 中使用 AI Agent 扩展。

- **1. 激活试用或订阅**

  开始[免费试用](https://cloud.tiptap.dev/v2?trial=true) 或在您的账户中[订阅团队计划](https://cloud.tiptap.dev/v2/billing)。
- **2. 集成 AI 提供商**

  在您的 [AI 设置](https://cloud.tiptap.dev/v2/cloud/ai)中配置 OpenAI，或查看[自定义 LLM 指南](https://tiptap.zhcndoc.com/content-ai/capabilities/agent/custom-llms.md)。
- **3. 从私有注册表安装**

  要安装前端扩展，请按照 [安装指南](https://tiptap.zhcndoc.com/guides/pro-extensions.md) 认证访问 Tiptap 的私有 npm 注册表。

使用 AI Agent 扩展的最快方式是使用 Tiptap Cloud。它开箱即用，您只需为扩展提供身份验证凭证。

> **注意:**
>
> 本指南依赖于使用 [Tiptap Cloud 服务](https://cloud.tiptap.dev/v2/cloud/ai)。如果您想使用自己的自定义 LLM 进行配置，请改为参考 [自定义 LLM 指南](https://tiptap.zhcndoc.com/content-ai/capabilities/agent/custom-llms.md)。

## 启动您的 Content AI 应用

1. **激活计划：** 开始[免费试用或选择订阅](https://cloud.tiptap.dev/v2/billing)。
2. **配置您的 AI 应用：** 将您的 OpenAI API 密钥添加到您的[Content AI 应用](https://cloud.tiptap.dev/v2/cloud/ai)。
3. **设置身份验证：** 使用 `aud: "AI"` 和 `AI:Generation` 权限签署令牌，然后将其传递给扩展。请参阅[身份验证](https://tiptap.zhcndoc.com/authentication.md)。

## 将身份验证凭证添加到扩展

使用 `AiAgentProvider` 类连接 Tiptap Cloud。它处理与 Tiptap Cloud 的通信，并管理 AI Agent 的状态。

```tsx
import { Editor } from '@tiptap/core'
import StarterKit from '@tiptap/starter-kit'
import AiAgent, { AiAgentProvider } from '@tiptap-pro/extension-ai-agent'

const provider = new AiAgentProvider({
  // 你生成的 JWT。它绝对不能是 OpenAI API 密钥！
  token: 'TOKEN_HERE',
  // ... 其它选项
})
```

当您使用 `AiAgentProvider` 向 AI Agent 发送消息时，Tiptap Cloud API 会被调用以获取 AI Agent 的回复。随后，AI Agent 将生成聊天消息并对文档进行编辑以完成用户的任务。

## 自定义 OpenAI 模型

您可以通过设置 `modelName` 选项来自定义 Tiptap Cloud 中使用的 OpenAI 模型。AI Agent 在使用 `gpt-4.1` 模型时表现最佳，因为它能提供针对复杂文档编辑任务的最佳性能。请注意，该模型需支持 [函数调用](https://platform.openai.com/docs/guides/function-calling)。

```tsx
const provider = new AiAgentProvider({
  modelName: 'gpt-4.1',
})
```