开始使用
欢迎
互客鱼是一款可嵌入任何网站的销售 AI 聊天小部件。访客打开 您的网站后，小部件加载，一个基于您自己的知识库的智能体 将回答他们的问题、捕获潜在客户，并在需要时转接给人工客服。 本文档涵盖如何构建智能体、嵌入它们、运行工作区以及运营平台。
您可以做什么
构建智能体
角色设定、语气、语言、系统提示词、置信度阈值——每个智能体均可配置。
用您的数据训练
爬取 URL 和站点地图、粘贴文本、从 Notion 或 Google Docs 同步。自动索引访客访问的页面。
一行代码嵌入
单个 <script> 标签即可将小部件部署到任何页面。压缩后 ≤50KB，隔离在 Shadow DOM 中运行。
接管对话
实时收件箱让人工客服可以随时介入对话。访客将无缝看到转接过程。
查看指标
对话数、低置信度缺口、潜在客户转化率、问题解决率——全部集中在一个仪表板中。
套餐与配额
基于 Stripe 的订阅服务、每月对话配额、付费套餐可移除品牌标识。
整体架构
产品包含三个界面：
- 客户应用 — React/Inertia SPA，用于构建智能体、管理知识、运行收件箱和处理账单。位于
/dashboard、/app/agents、/app/inbox等路径。 - 访客小部件 — 在客户网站上运行的 Preact 包。通过签名的 JWT 从同一后端流式传输答案。
- 平台管理 — 仅操作员可用的控制台（
/admin），用于管理套餐、订阅、使用情况、队列健康和全局通知。只有超级管理员可见。
底层技术栈：Laravel 13 + Octane、Postgres + Redis、Laravel Reverb 实现实时通信、 Cashier 集成 Stripe、Cloudflare Workers AI / Vectorize / Browser Rendering 构成 AI 技术栈（OpenAI + Qdrant 作为备选）。完整技术栈详见 架构。
阅读顺序
侧边栏大致按照您需要使用的顺序分组——从上到下开始，跳过不适用的部分。 如果您是运营平台的管理员，直接跳转到 平台管理 和 可观测性。