Pitchbar 小白使用指南

一句话介绍：把它挂到你的网站上，就多了一个 24 小时在线的 AI 销售客服——回答访客问题、识别意向客户、自动收集线索，你随时可以人工接管。 UI看着不咋滴，大家可以让AI再优化设计

0先搞清楚三个概念

整体流程：

登录→配 AI 密钥→建智能体→喂知识→调行为→发布→嵌入网站

1登录系统

• 本地环境部署：打开 http://127.0.0.1:8000（服务器环境就是你自己的域名）
• 登录页：点右上角「登录」，账号 [email protected] 密码 password
• 登录后：
  • admin 账号 → 自动进入 /admin 平台管理后台（管用户、套餐、全局设置）
  • 要操作智能体、对话、线索 → 点侧栏切到客户视角 /app
  • customer 账号 → 直接进客户工作区，日常使用主要在这里

第一件事：改密码！右上角头像 → 个人资料 → 修改密码。默认密码全网公开。

2配 AI 密钥（没有它机器人不会说话）

机器人的”大脑”和”记忆”都靠外部 AI 服务，需要三选一配置密钥：

在哪配：登录客户工作区 → 右上角设置 → AI 密钥（BYOK） → 填入密钥 → 点「测试连接」看到 ✓ 就 OK。

配置后到平台后台「系统健康」页确认：LLM 服务商、向量库都显示就绪。

3创建你的第一个智能体

1. 客户工作区 → 智能体 → 「新建智能体」
2. 基础设置：
   • 名称/人设：比如”小艾”，告诉它”你是 XX 店的客服，语气亲切”
   • 默认语言：选 zh（中文）
   • 开场问题：预设 3 条访客常问的，如”多少钱？””怎么发货？”
   • 外观：主题色、圆角、位置（居中条/右下气泡），有实时预览

4喂知识（决定它答得好不好）

进入智能体 → 知识来源 → 添加，支持 5 种方式：

知识源要等「索引完成」状态才生效。测试提问时，如果它答不上来，八成是没索引完或知识里确实没写。

5调行为规则（什么时候弹出、怎么留线索）

智能体 → 行为规则：

• 弹出时机：页面加载即弹 / 停留 N 秒 / 滚动到某深度 / 访问定价页等意向页才弹
• 线索门槛：开”聊天前留姓名+邮箱”，或让 AI 在访客聊出购买意向时弹表单
• 转人工：设关键词（如”人工”），触发后你在收件箱一键接管

6发布 + 嵌入你的网站

1. 智能体页面点 「发布」（改设置后要重新发布才生效）
2. 点 「嵌入」，复制那行 <script> 代码
3. 粘贴到你网站的 </body> 之前，保存刷新——右下角就有 AI 客服了

不确定效果？先在智能体的「试验场（Playground）」里模拟访客聊几句，再嵌入正式网站。

7日常运营看哪里

8常见问题排查

9本地启动 / 宝塔部署速查

本地部署

浏览器打开 http://127.0.0.1:8000。本地用的是 SQLite + 同步队列，开箱即用。

宝塔服务器

照 pitchbar宝塔部署流程.html 一步一步做即可（PHP 8.4 + MySQL + Redis + PM2 + Nginx SSE 配置 + 每分钟计划任务）。

服务器部署时记得：.env 里 APP_ENV=production、APP_DEBUG=false、改 WIDGET_JWT_SECRET、改两个种子账号密码。