接入 AI 服务商

开始之前#

本文帮助管理员接入 ChatHub AI Agent 功能共用的 AI 服务商，包括回复建议、会话摘要和自动回复。你需要选择服务商、填写 API 密钥、选择模型，然后保存并检查连接。

1. 1

   使用一个可以访问并保存“设置”的 ChatHub 账号。

2. 2

   准备所选服务商的 API 密钥，并确认该 API 账号可以使用你打算使用的模型。用量由服务商直接计费。

3. 3

   若使用自定义 API，还需准备该服务提供的 API 基础地址和模型 ID。

1. 打开 AI 服务商设置#

1. 1

   在 ChatHub 中打开 Quản trị → Cài đặt（管理 → 设置）。

2. 2

   在左侧选择 Nhà cung cấp AI（AI 服务商），或在你的 ChatHub 域名下打开 /settings?tab=ai。

3. 3

   在顶部找到 AI 服务商面板，其中包含服务商、API 密钥、模型、启用 AI 功能，以及保存和测试连接按钮。

2. 选择服务商并获取 API 密钥#

1. 1

   OpenAI：在 Nhà cung cấp（服务商）中选择 OpenAI，点击模型下方的 OpenAI 链接进入其密钥管理页面。

2. 2

   DeepSeek：选择 DeepSeek，点击模型下方的 DeepSeek 链接进入其密钥管理页面。

3. 3

   API tùy chỉnh（自定义 API）：如果服务或网关支持 OpenAI 兼容的 API 格式，请选择此项。密钥、基础地址和模型 ID 需从该服务获取。

ChatHub 链接的 OpenAI API 密钥页面 ↗

ChatHub 链接的 DeepSeek API 密钥页面 ↗

在服务商的管理页面登录你的账号，按其说明创建或获取 API 密钥，复制后填入 ChatHub 表单。本文演示的是 ChatHub 的配置过程，不会创建密钥，也不会改动服务商的计费设置。

3. 填写密钥、模型并启用 AI#

1. 1

   API 密钥：首次配置时粘贴所选服务商的密钥。若已保存过密钥，该字段会显示为 API key mới（新 API 密钥）。

2. 2

   模型：填写你的 API 账号可用的准确模型 ID。可以选择建议项，也可以直接输入。留空则使用你所安装 ChatHub 版本中该服务商的默认模型。

3. 3

   更换服务商后请再次检查模型：ChatHub 会清除之前的选择，并显示新服务商的默认建议值。

4. 4

   打开 Bật tính năng AI（启用 AI 功能）以允许调用 AI。若要停止调用，关闭该开关并保存；密钥仍会保留。

ChatHub 会加密保存密钥，且不会把它回传给浏览器。“已配置”只表示存在密钥，并不代表密钥有效、模型可用或 AI 已启用。

4. 配置自定义 API#

1. 1

   选择 API tùy chỉnh（自定义 API）后会出现 URL API 字段。

2. 2

   填写该服务的基础地址，必要时包含 API 版本。https://api.example.com/v1 只是格式示例，请替换成你实际使用的服务地址。

3. 3

   不要在地址后追加 /chat/completions 或 /models。地址中也不要包含 API 密钥、登录凭据、查询参数（?...）或锚点（#...）。密钥请填在单独的字段里。

4. 4

   填写自定义服务的 API 密钥和模型 ID。不要默认所有网关都提供建议的那个模型。

5. 5

   启用 AI，然后按下文说明保存并测试。

地址必须是有效的 HTTP 或 HTTPS。该服务需要支持 ChatHub 使用的接口：用于连接检查的 /models 和用于 AI 请求的 /chat/completions。请使用服务商文档中给出的基础地址。

5. 保存并测试连接#

1. 1

   核对服务商、API 密钥、模型、AI 开关，以及自定义地址（如适用）。

2. 2

   点击 Lưu（保存），等待提示 “Đã lưu cấu hình AI.”（AI 配置已保存）。

3. 3

   点击 Kiểm tra kết nối（测试连接）。在保存密钥之前该按钮不可用。

4. 4

   阅读结果：出现 “Gọi được …, model …, mất …ms.” 表示服务商已响应。核对显示的服务商和模型与你保存的一致。

若结果同时提示模型不在服务商返回的列表中，请检查模型 ID 和账号权限，更正后保存并重新测试。有些服务不会列出全部模型，因此还应通过实际的 AI 功能验证。

该测试只请求模型列表，并不会发送会话内容去生成回复。测试通过不代表所有生成类功能都能正常工作。接下来请在一个测试会话中试用 AI 功能，内容需适合发送给你的服务商。

6. 从网站抓取训练资料#

AI 服务商连接正常后，可以把文档网站转换成供 AI 检索的问答条目。ChatHub 会在服务器端先执行试抓，略过菜单、侧栏和评论；目录页只用于发现真正的文章。试抓只生成预览，不会保存文档。

1. 1

   在 Tài liệu huấn luyện AI（AI 训练文档）区域点击 Quét từ website（从网站抓取）。

2. 2

   在 Địa chỉ trang tài liệu（文档地址）中粘贴完整的 HTTPS 地址。本文示例为 https://help.cmsnt.co/。建议直接指向相关文档目录或分区，不要使用无关页面。

3. 3

   需要时展开选项。Chỉ trong mục này（仅当前分区）只跟随同一路径下的链接；Cả tên miền（整个域名）可以跟随该域名上的所有链接。页面数可设为 1 至 40，默认为 12。

4. 4

   点击 Quét thử（试抓），等待服务器逐页读取；抓取期间不要关闭对话框。

5. 5

   检查问答条目、文章、目录页和跳过页面四项统计，并在已抓取页面列表中查找无关分支、无法读取或被 robots.txt 阻止的页面。

6. 6

   仔细阅读预览，因为这就是 AI 将使用的内容。如果不合适，请调整地址、范围或页数后重新试抓。

7. 7

   填写便于识别的文档名称。只有预览无误后才点击 Lưu tài liệu（保存文档）；保存后可在 AI 训练文档列表中启用、停用或查看内容。

达到页数上限时，应先改用更接近目标文档分区的地址，并保留“仅当前分区”。确认网站不会把抓取器带到无关内容后，再提高页数或选择“整个域名”。

7. 问题排查与后续步骤#

1. 1

   “Cần nhập API key.”（需要填写 API 密钥）：首次配置时尚无密钥。填写密钥并保存。

2. 2

   “Cần nhập URL API HTTP hoặc HTTPS hợp lệ.”（需要有效的 HTTP/HTTPS API 地址）：检查自定义 API 地址，去掉查询参数、锚点和登录凭据，使用正确的基础地址。

3. 3

   已保存密钥却显示未配置：确认已选择服务商、已启用 AI 并保存了设置。自定义 API 还需检查地址。

4. 4

   服务商拒绝请求：阅读显示的状态码和错误详情，按提示检查凭据、权限或 API 账号。

5. 5

   无法连接：检查 API 地址以及运行 ChatHub 的服务器的网络访问。你自己电脑能打开管理网站，并不代表 ChatHub 服务器能访问该 API。

6. 6

   连接测试通过但功能不运行：检查模型以及该功能自身的配置。接入服务商是前提条件，不能替代机器人或自动化的设置。

AI 训练文档不包含 API 密钥。若抓取提示地址无效，请使用以 https:// 开头的完整链接。页面被跳过时，在已抓取页面列表中查看状态：它可能没有可读内容、无法访问，或被 robots.txt 阻止。