进阶 docs.budibase.com 2026-11-12 08:33:37 · 21 阅读

第11章 Budibase Agents 配置指南

Agents 配置 本页介绍在消息渠道中使用 Budibase Agents 之前需要完成的必要设置。

在创建 Agent 或部署到渠道之前,你需要在“工作区设置 > 连接 > AI 模型”中至少配置一个模型。

如需了解更全面的 AI 设置流程,请参阅“快速入门:Budibase AI”。

开始前 请确保你拥有:

- 访问工作区设置的权限 - 所选模型提供商的凭证 - 至少一个可用于运行聊天或 Agent 的模型

在 AI 模型中配置你的第一个模型

打开你的工作区设置 进入“连接 > AI 模型” 点击“连接” 选择一个提供商并填写所需的凭证 选择或输入模型名称 添加显示名称并保存

保存后,该模型即可在 Agent 的模型选择中使用。

支持的提供商 Budibase 支持多个模型提供商:

提供商 | 说明 Budibase AI | Budibase 托管的提供商 Anthropic | 直接连接 Claude 模型 Google | 直接连接 Gemini 模型 Mistral | 直接连接 Mistral 模型 OpenAI | 直接连接 OpenAI 模型 OpenRouter | 连接广泛的托管模型 API 目录 Groq | 连接高速托管模型 API

自定义提供商设置 如果你的提供商不在列表中,请使用“连接到自定义提供商”。

根据提供商的不同,你可能需要提供以下值:

- API 基础 URL - API 密钥 - 访问密钥和私密密钥 - 默认模型名称

请使用提供商期望的确切值。错误的值可能导致设置保存成功,但在运行时失败。

对于 OpenAI 兼容的提供商,API 基础 URL 必须包含 API 根路径的版本化路径——通常是 /v1。例如,使用 https://proxy.example.com/v1,而不是 https://proxy.example.com。缺少版本化路径的基础 URL 通常允许设置保存成功,但在第一次模型调用时会出现 404 错误。

验证你的提供商设置 在将模型附加到 Agent 之前:

- 确认提供商在“连接 > AI 模型”中显示为已启用 - 确认你的目标模型名称可用且拼写正确 - 从一个 Agent 运行一个简单的短提示测试 - 将成功的配置保存为团队默认设置

在 Agent 中选择模型 在 AI 模型中配置好模型后,将其附加到每个 Agent:

打开 Agents 创建新的 Agent 或打开现有的一个 点击“连接 AI 模型” 选择已配置的提供商和模型

渠道部署就绪清单 在启用渠道之前,请确认:

- 你的 Agent 已连接 AI 模型 - 所选模型能运行聊天/补全提示 - Agent 已保存并能回答一个简单的测试提示

接下来,在“消息渠道”中配置部署。

故障排除 如果模型连接或 Agent 测试失败:

- 重新检查 API 凭证和模型 ID - 验证提供商特定的基础 URL 值 - 确认你的环境允许出站互联网访问 - 保存更改后重新运行一个简单的提示测试

如果你正在自托管并使用 Budibase AI,请确保 BBAI_LITELLM_KEY 环境变量已正确配置,并对所有运行 Agent 的服务可用,包括自动化 worker。要使用 Agent 知识功能(如文件上传和 SharePoint 摄入),你还必须配置 GEMINI_API_KEY 环境变量,该变量默认通过特定的 Gemini flash 模型进行通信,如果没有预定义覆盖部署,请求可顺利传递。有关网络要求的更多详细信息,请参阅“自托管 AI 功能”。

相关指南

- 消息渠道 - Agent 构建 101 - Agent 指令指南 - Agent 测试指南 - Agent 故障排除 15 天前更新 此页面是否对你有帮助?

评论 (0)