人工智能AI AgentMCP 服务工具调用GUI 自动化语音数字人交互助手【免费下载链接】airi 自托管、归你拥有的 Grok 风格 AI 伴侣与 waifu / 赛博生命灵魂容器目标是接近 Neuro-sama 的高度支持实时语音聊天、Minecraft 和 Factorio 游玩支持 Web / macOS / Windows。项目地址https://gitcode.com/moeru-ai/airi点击查看免费下载本文围绕 AIRI 中 Cloudflare Workers AI 对话提供程序的完整配置流程展开如何准备账号级凭证API Token 与 Account ID、如何在设置页面填写并通过自动必填项校验、如何进入 Consciousness 模块选择模型并用测试消息验证连通性同时结合仓库源码解析该提供程序的定义、校验器与调用链帮助你理解为什么 AIRI 需要 Account ID以及校验失败时的排查路径。Cloudflare Workers AI 使用账号级account-level凭证体系它不像部分第三方网关只需要一个 API Key 加 Base URL而是必须同时提供API Token与Account ID两项信息AIRI 才能定位到你 Cloudflare 账号下的 Workers AI 资源。本文以文档docs/content/en/docs/manual/config/providers/consciousness/cloudflare-workers-ai.md描述的实操流程为主线辅以仓库中的实现证据。一、准备凭证API Token 与 Account ID 缺一不可在 Cloudflare 侧需要准备两样东西创建 API Token在 Cloudflare 控制台的 API Tokens 管理页面dash.cloudflare.com/profile/api-tokens创建一个具有 Workers AI 访问权限的 API Token然后复制该 Token。获取 Account ID在 Cloudflare 控制台中找到你的 Account ID 并复制。它是 Workers AI 请求路由所必需的账号标识。安全提醒API Token 与账号权限直接绑定。建议遵循最小权限原则只授予 AIRI 所需的 Workers AI 相关权限不要给 Token 附带超出需要的管理能力同时不要把 Token 或 Account ID 写入公开日志、截图或粘贴到公开渠道。从源码可以印证这一双凭证设计。提供程序定义文件 packages/provider-inference/src/providers/cloud/cloudflare-workers-ai/index.ts 中配置 schema 用 zod 声明了两个必填字符串字段const cloudflareWorkersAIConfigSchema z.object({ apiKey: z.string(API Key), accountId: z.string(Account ID), })这正是设置页面上看到的API Token底层字段名apiKeyUI 中以 password 类型渲染见 index.ts#L23-L29与Account ID字段名accountId两个输入框的来源。两者的界面文案来自 i18n 资源 packages/i18n/src/locales/zh-Hans/settings.yamlAccount ID 的占位符为请输入 Cloudflare Account IDAPI Key 的占位符为请输入 Cloudflare Workers AI 的 API Key。二、在 AIRI 中配置提供程序配置路径为Settings → Providers → Chat → Cloudflare Workers AI填入API Token与Account ID两个字段。这条路由对应仓库中的通用对话提供程序设置页 packages/stage-pages/src/pages/settings/providers/chat/[providerId].vue。该页面通过useProviderValidation(providerId)组合式函数接管校验状态见 use-provider-validation.ts其中accountId被作为一等公民的凭证字段单独管理use-provider-validation.ts#L70-L77与apiKey、baseUrl并列读写 Pinia 中的 provider 配置保证 Account ID 的修改能即时触发自动校验。需要注意的一点该提供程序没有可编辑的 Base URL 字段。虽然通用设置页模板里带有 Base URL 输入框但 Workers AI 的端点由 Cloudflare 官方网关固定决定凭证中的 Account ID 已经完成资源定位因此不要在该字段填入 Worker URL 或 API 路径——文档的 Troubleshooting 部分明确警告了这一点。三、验证配置自动必填项检查、模型选择与测试消息文档定义的验证流程分三步理解每一步实际验证了什么能帮你快速定位问题等待自动必填项检查通过。AIRI 会自动运行校验但这个检查只确认两个字段都有值不会实际联系 Cloudflare 服务也不会验证凭证本身的正确性。对应源码中注册名为cloudflare-workers-ai:check-config的配置校验器index.ts#L42-L65它对apiKey与accountId分别做trim()后判空空值时分别报告API token is required.或Account ID is required.。是否触发该检查由validationRequiredWhen决定——只有当两个字段都非空时设置页才会进入校验中状态而非保持未配置index.ts#L39-L41。点击 Select Model →跳转到 Settings → Modules → Consciousness。设置页底部按钮的行为见 [providerId].vue#L99-L102goToModelSelection()会把当前providerId写入 consciousness store 的activeProvider然后路由到/settings/modules/consciousness。在 Consciousness 页面选择 Cloudflare Workers AI 及一个可用模型即完成提供程序 → 对话模块的绑定。回到聊天界面发送测试消息。只有收到成功的模型响应才说明 Account ID、API Token 权限与所选模型三者真正可用。第 1 步的本地检查通过≠凭证有效测试消息才是真正的端到端验证。四、源码视角定义、注册与底层调用链为了让配置行为可预期这里把该提供程序在仓库中的完整位置串一遍定义与工厂providerCloudflareWorkersAI通过defineProvider声明index.ts#L13-L38tasks: [chat]表明它只提供对话任务不提供语音/嵌入等。其createProvider调用createWorkersAI(config.apiKey, config.accountId)来自xsai-ext/providers/special/create可见 AIRI 将账号级凭证如何拼进请求的细节完全委托给底层 SDK 的 Workers AI 适配器配置页的职责边界就是收集这两个字符串。注册入口该定义被列入 packages/provider-inference/src/providers/index.ts 的portableProviderDefinitions列表即无需 Electron/Vue 依赖即可加载的可移植定义集合Web 与桌面端共用。注册表机制定义经由 registry.ts 的defineProvider纯函数导入模块不会改变共享注册表交给应用侧的createProviderRegistry后者会对重复 id 抛错并按order/名称排序保证设置页列表的确定性。协议适配实例创建后types.ts 中的getGenerationProvider会检查其是否原生支持 generation 接口否则把chat方法适配为chat-completions协议的生成请求进入 core-agent 的统一推理链路。五、故障排查对照文档给出的排查顺序并叠加源码证据现象可能原因排查动作必填项检查失败报API token is required./Account ID is required.某个字段为空或只填了空白字符确认API Token与Account ID均包含有效内容校验器会先trim()纯空格也算空必填项检查通过但测试消息失败Token 无 Workers AI 权限Token 与 Account ID 不属于同一个 Cloudflare 账号在 Cloudflare 侧确认 Token 的权限模板包含 Workers AI并核对两者来自同一账号请求被拒绝 / 路由错误在 Base URL 中填了 Worker URL 或 API 路径清空 Base URL——该提供程序不使用可编辑 Base URL端点由 Account ID 定位另外两点适用前提其一本地必填项检查永不发起网络请求因此检查通过只说明配置完整不能替代测试消息验证其二由于凭证是账号级绑定更换 Cloudflare 账号或轮换 Token 后需要重新填写并使 Account ID 与 Token 保持同账号一致否则即使字段齐全测试消息仍会失败。小结Cloudflare Workers AI 在 AIRI 中是纯 chat 任务提供程序配置契约只有apiKeyAPI TokenaccountIdAccount ID两个必填字段无 Base URL。配置入口为 Settings → Providers → Chat → Cloudflare Workers AI模型绑定入口为 Select Model → 跳转 Settings → Modules → Consciousness。自动校验只做非空检查cloudflare-workers-ai:check-config真实可用性以聊天测试消息为准。凭证最小权限、Token 与 Account ID 同账号是该提供程序最常见的两类故障根因。赞分享人工智能AI AgentMCP 服务工具调用GUI 自动化语音数字人交互助手【免费下载链接】airi 自托管、归你拥有的 Grok 风格 AI 伴侣与 waifu / 赛博生命灵魂容器目标是接近 Neuro-sama 的高度支持实时语音聊天、Minecraft 和 Factorio 游玩支持 Web / macOS / Windows。项目地址https://gitcode.com/moeru-ai/airi点击查看免费下载相关推荐Kiln 接入 Cloudflare Workers AIOpenAI 兼容端点、双凭证认证与 LiteLLM 集成实战指南Kiln 接入 Cloudflare Workers AIOpenAI 兼容端点、双凭证认证与 LiteLLM 集成实战指南 导读 本文以 Kiln 项目对人工智能AI 应用AI 评测RAG微调提示工程开发工具桌面应用MLOpsKiln 接入 Cloudflare Workers AI 完整研究OpenAI 兼容端点、双凭证认证与 AI Gateway 集成方案Kiln 接入 Cloudflare Workers AI 完整研究OpenAI 兼容端点、双凭证认证与 AI Gateway 集成方案 本篇技术指南围绕开源人工智能AI 应用AI 评测RAG微调提示工程开发工具桌面应用MLOpsAIRI 配置指南在 AIRI 中接入 Azure AI Foundry 聊天模型并验证部署AIRI 配置指南在 AIRI 中接入 Azure AI Foundry 聊天模型并验证部署 本篇指南介绍如何在 AIRI自托管 AI 伴侣项目中配置 A人工智能AI AgentMCP 服务工具调用GUI 自动化语音数字人交互助手后端上一篇Chalice 中间件Middleware完全指南自定义 Lambda 请求与响应生命周期的标准做法下一篇纺织行业质量检测新纪元基于langchain4j的AI视觉检测系统创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考