配置 Cloudflare Workers AI 的 API 密钥

[Discourse]

Cloudflare Workers AI

在本示例中，我们使用 Cloudflare Workers AI 来生成密钥。

Cloudflare Workers AI 在 Discourse AI 中用作嵌入提供商（例如用于语义搜索和 RAG）。它不作为 LLM 提供商使用。

注意：Workers AI 在免费和付费的 Cloudflare 计划中均可用。可能会根据使用情况计费。有关最新信息，请参阅此处详情。

平台会不断变化，因此本指南可能无法完全反映 100% 的流程。

生成 API 密钥

1. 登录 Cloudflare。按照官方文档中的说明获取 API 密钥和账户 ID。
2. 生成 API 密钥并记录账户 ID。
3. 密钥生成后，请将其保存在安全的地方并复制该密钥。

在 Discourse AI 中使用 API 密钥

Cloudflare Workers AI 的凭据现在通过AI 密钥和AI 嵌入管理页面进行配置，而不是通过插件站点设置。

1. 进入 管理 → 插件 → Discourse AI → AI 密钥（/admin/plugins/discourse-ai/ai-secrets）
2. 使用您的 Cloudflare API 令牌创建新的密钥
3. 进入 管理 → 插件 → Discourse AI → AI 嵌入（/admin/plugins/discourse-ai/ai-embeddings）
4. 创建或编辑嵌入定义，选择 Cloudflare 作为提供商
5. 将 URL 设置为您包含账户 ID 的 Cloudflare Workers AI 端点，例如：
   https://api.cloudflare.com/client/v4/accounts/YOUR_ACCOUNT_ID/ai/run/@cf/baai/bge-large-en-v1.5
6. 选择您在步骤 2 中创建的 AI 密钥

旧的站点设置 ai_cloudflare_workers_api_token 和 ai_cloudflare_workers_account_id 现已隐藏并弃用。现有配置已自动迁移至新的嵌入定义和 AI 密钥系统。