在 Content AI Cloud 中使用 AI Agent

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

启动您的 Content AI 应用

1. 激活计划： 开始一个 免费试用或选择订阅。
2. 配置您的 AI 应用： 在您的 Content AI 应用 中添加您的 OpenAI API 密钥。
3. 设置身份验证： 使用我们提供的密钥生成一个 JWT（HS256 算法），以便扩展程序通过该令牌验证我们的服务。 获取您的 JWT 密钥。

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

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

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

const provider = new AiAgentProvider({
  // 您的 Tiptap Content AI 应用 ID
  appId: 'APP_ID_HERE',
  // 您生成的 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 模型时表现最佳，因为它能提供针对复杂文档编辑任务的最佳性能。请注意，该模型需支持 函数调用。

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