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

第31章 Budibase Chatbox 组件指南:在应用中嵌入智能体聊天体验

ChatboxChatbox 在应用界面内嵌入智能体聊天体验。Chatbox 组件让你把 Budibase 的聊天体验直接放进自己的应用里。

它复用了 Agent chat 的同一套聊天配置,包括智能体可用性、访问角色、默认设置和对话开场白。

开始之前 请确保你已完成:

Agents 配置 在 Agent chat 中启用至少一个 live agent 通过 Agents -> Deployment -> Open chat 验证过聊天访问

添加 Chatbox 组件

在 Apps 下打开你的应用 点击 Add component 打开 AI 分类 选择 Chatbox

然后就可以像其他屏幕组件一样调整它的大小和位置。

Chatbox 设置

设置说明Intro text 显示在对话区域上方的简短文字。Input placeholder 聊天输入框中的占位文字。Send button label 发送按钮上显示的标签。

样式 Chatbox 支持:

内边距(Padding) 背景 边框

为了获得最佳效果,请给 Chatbox 留出足够的纵向空间,方便用户查看历史消息和编写新消息。

运行时行为 在应用运行时,Chatbox 会:

从工作区的聊天配置加载已启用的智能体 使用配置的默认智能体开启新对话 在配置了的情况下显示各智能体的对话开场白 从启用列表中隐藏不可用的智能体 在相关消息底部渲染升级卡片(human-in-the-loop 请求)

如果没有配置或启用任何智能体,用户看到的将是空状态提示,而不是聊天会话。

访问与可用性 Chatbox 中智能体的可用性取决于 Agent Chat 配置:

智能体必须在聊天设置中启用 智能体应处于 live 状态 用户必须满足配置的访问角色 App Portal 中必须可用聊天路由

如果组件已显示但用户无法开始对话,请到 Agent chat 中检查这些设置。

故障排查 如果 Chatbox 可见但无法使用:

确认能从 Agents -> Deployment -> Open chat 正常打开聊天 确认 Agent Chat 中至少启用了一个 live agent 确认你的用户角色有权限访问所选智能体 发布后重新打开应用,加载最新的聊天设置

相关指南

Agent chat Agents config Agent building 101 更新于约 2 个月前 这个页面对你有帮助吗?

评论 (0)