Botpress官网入口、AI Agent可视化搭建、知识库、工作流、人机转接、价格与自托管下线说明及使用教程

Botpress是什么？

Botpress是一款用于构建、部署和管理AI Agent与聊天机器人的云平台。它把可视化工作流、基于大模型的Autonomous Node、知识库、数据表、渠道集成、代码卡片和人机转接放在同一个Studio中，适合制作客服助手、销售线索机器人、员工知识助手和业务流程Agent。

Botpress既支持低代码拖拽，也提供API、SDK和自定义集成。非开发者可以从工作流和模板开始，开发者则能编写TypeScript逻辑、连接外部系统，并把机器人部署到网站、WhatsApp、Messenger或其他渠道。

重要变化：现行产品仅提供云端版

Botpress v12以及其他本地、自托管版本已经正式停止，不能再购买、下载或用于新部署。已有有效v12订阅的客户仍由官方支持，但新用户必须使用Botpress Cloud。

GitHub上仍有Botpress代码和历史教程，不能据此判断现行Cloud可以免费完整私有部署。寻找Windows安装包、Docker Compose或v12本地教程的新用户会遇到失效内容，应直接使用官方云端Studio；

确需数据主权或定制部署时要联系Enterprise销售确认当前方案。

核心功能

1. 可视化Botpress Studio

Studio以节点、卡片、变量和连线组织对话与业务逻辑。用户可以配置入口、条件、消息、数据捕获、代码执行、API调用和子工作流，并在内置模拟器中测试。

可视化方式适合快速理解流程，也便于产品、运营和开发共同维护。

复杂机器人如果把所有逻辑堆在一个画布中会难以调试，建议把认证、查询、转接和完成流程拆成独立Workflow，并为变量、错误和退出条件建立统一规范。

2. Standard Node与Autonomous Node

Standard Node按固定顺序执行Cards，适合必须可预测的流程，例如收集表单、验证账号和确认订单。Autonomous Node则由大模型根据上下文决定回复什么、调用哪个工具、查询哪个知识库或执行哪个工作流，更适合开放式问题和多步骤Agent任务。

Autonomous Node可以配置Instructions、Variables、Tools、Knowledge Bases、Workflows和Exit Conditions，也能单独覆盖默认对话模型与RAG模型。高性能模型通常更能理解工具参数；

较小模型可能因上下文截断或工具选择错误导致循环和失败。

3. 知识库与RAG问答

知识库可以接收网站、文档、表格、富文本、网页搜索和集成数据，让Agent围绕公司政策、产品资料、价格、FAQ或结构化记录回答。新建Agent默认可通过Search Knowledge工具检索知识库，也可以指定只搜索某些资料源。

文档上传后通常会转换为Markdown，原始样式和部分图片会被移除。视觉知识库索引可处理图片、图表和示意图，但属于更高方案能力。

扫描件、复杂表格和频繁变化的数据应先验证解析结果。

知识库占用Vector DB Storage。同时检索多个库会增加Token、延迟和混淆风险；

内容领域分明时，可把不同知识库配置成独立工具，并写清何时调用。

4. 数据表

Botpress Tables用于保存结构化数据，并能被Agent查询或更新，例如产品、门店、库存、工单分类和客户偏好。数据表可与知识回答结合，也可通过API、Webhook或定时任务同步外部系统。

它适合轻量Agent数据，不应无条件替代企业主数据库。敏感数据、事务一致性、访问控制和大规模查询仍应留在专业后端，并通过最小权限API提供。

5. Integrations与渠道

Botpress Hub提供官方和社区集成，可连接WhatsApp、Messenger、Slack、CRM、客服平台、数据库和其他API，也能把Agent部署到不同消息渠道。开发者可使用SDK创建自定义集成、定义事件与动作。

安装集成前要查看发布者、所需凭据、权限和费用。WhatsApp、模型、搜索、短信和客服系统可能由第三方另行计费，Botpress套餐不会自动包含这些服务。

6. Webchat网站聊天组件

Botpress可以把聊天组件嵌入网站，自定义颜色、头像、欢迎语和主动气泡。Plus、Team与Enterprise可以移除“Powered by Botpress”水印，但官方不支持对白标Studio或Dashboard。

嵌入前应处理Cookie同意、隐私说明、移动端布局、无障碍和跨域安全。不要在公开前端暴露机器人管理Token或后台API密钥。

7. Human-in-the-Loop人机转接

HITL允许真人客服加入会话、审批AI输出或接管复杂和敏感场景。新Workspace的人机转接已迁移到Botpress Desk；

旧Workspace仍可使用legacy HITL集成。

HITL至少需要Plus方案。

可靠转接需要定义触发条件、营业时间、等待提示、上下文摘要、工单路由和无人接听方案。只添加一个“转人工”按钮不代表完整客服闭环。

8. Conversation Analysis

平台可以汇总对话主题、情绪、结果和问题是否解决，Plus及以上提供更完整的Conversation Insights，Team加入自定义分析。管理员可用这些数据发现知识缺口和转接原因。

情绪与解决率由AI推断，可能误判讽刺、方言和复杂上下文。分析适合发现趋势，不应单独用于员工考核或高风险用户判断。

9. API、SDK与Bots as Code

开发者可通过Botpress API和SDK创建集成、插件和以代码定义的Agent能力，也能利用Webhook让外部系统触发工作流。TypeScript类型为事件、动作和配置提供约束，适合把Botpress纳入正式研发流程。

可视化Studio与代码需要版本和责任边界。生产环境应区分开发、测试与发布，保护Token，记录集成版本，并为外部API设置超时、重试和幂等。

AI模型与AI Spend

Botpress会按Bot设置为Autonomous Node和RAG选择模型，部分节点可覆盖默认模型。可用模型和定价会随平台更新，复杂工具调用通常需要较强模型。

套餐月费不包含无限模型推理。AI Spend按模型提供商的Token价格计算，Botpress会把实际AI成本计入Workspace。

当前月度AI Spend上限为：PAYG与Plus最多100美元、Team最多500美元、Enterprise定制。上限是消费保护，不是套餐赠送额度。

PAYG可能包含小额月度AI Credit，活动和金额可能变化。第三方Bing Search、消息渠道、CRM和其他API费用另计。

上线前应以真实对话测试平均Token、知识检索和工具迭代次数。

套餐与价格

Botpress当前采用“平台基础费＋AI Spend＋可选Add-ons”结构。月付公开基础价为：

套餐或版本	价格、额度与核心权益
Plus：89美元/月，	含2个Bot、2名协作者、5000条消息、10万行Table、1GB Vector DB、10GB文件存储、1个Always Alive，并加入人机转接、对话洞察、去水印、主动气泡、视觉知识索引和在线技术支持；
Team：495美元/月，	含3个Bot、3名协作者、5万条消息、10万行Table、2GB Vector DB、10GB文件存储、3个Always Alive，并加入RBAC、实时协作、自定义分析和高级支持；
Enterprise：询价，	按安全、规模、部署、支持和定制需求报价。

官网还会提供年付折扣，价格会随合同与活动变化。Managed页面在不同结算周期可能显示不同引导价，采购时应以当前销售报价为准。