关于 Granetra 的一切

Granetra 是一个您可以根据自己的内容进行训练的 AI 聊天机器人——网站、PDF 或 Word 文档——并通过一行代码嵌入到您的网站上。它在任何时候都能用您提供的材料回答客户的问题。当它确实不知道某个问题时，它会坦诚相告，而不是猜测，并且可以将对话转交给真实的人。

本文档涵盖了完整的产品：创建和训练机器人、自定义小部件、自动化（主动触发、代理行为、对话流程、AI 代理团队、MCP 连接器）、通过网络小部件和 WhatsApp/Telegram/Slack 的对话、分析、团队、计划和账单以及安全。如果您希望通过 API 而不是仪表板进行构建，请跳转到 API 与网络hooks 或完整的 开发者参考。

核心循环

1. 训练 一个基于您内容的机器人。
2. 自定义 它的外观和对话方式。
3. 嵌入 在您的网站上放置一个脚本标签。
4. 监控 对话并随着时间的推移进行改进。

机器人可以同时从一个或多个来源进行训练，您可以稍后添加更多：

每次同步读取的页面是上限，而不是您消耗的配额 — 每次同步都是全新的。单次运行也会在时间预算上停止，因此训练会及时完成，因此非常大的网站会根据预算允许的深度进行读取，而不是直接失败。在 管理知识 中删除文档会立即释放其位置。

在后台，您的内容被拆分为段落，转化为嵌入，并存储，以便机器人可以在每个回答中提取最相关的材料。除非您开启 灵活推理（见 行为），否则它不会从您未提供的内容中回答。

保持知识最新

• 添加知识 — 在不重新开始的情况下，向已经训练好的机器人附加更多的 PDF、Word 文档或 URL。
• 重新同步网站 — 重新爬取原始网站 URL，仅替换网站来源的知识，保留任何上传的文件不变。适用于所有计划。在 Scale 上，您还可以在 Bot Studio → 行为中开启自动重新同步（每日、每周或每月），这样就可以在您不在时自动进行。
• 管理知识 — 查看每个训练来源，并从机器人的知识面板中单独删除任何来源。

这里的所有内容都在 Bot Studio → 自定义 → 外观中：

• 徽标 — 显示在启动按钮和聊天头部。PNG、JPG 或 WebP，最大 2 MB。
• 小部件颜色 — 您的强调色，贯穿整个面板。
• 颜色模式 — 明亮、黑暗或自动（遵循您网站的明暗偏好）。
• 小部件主题 增长计划 — 12个与常见行业（店面、电路、护理、地产、校园、礼宾、账本、顾问、脉搏、工作室、航行、单色）匹配的现成预设。每个预设都有深色和浅色两种变体，因此它会自动跟随您网站的主题。选择一个预设还会建议一个匹配的强调色，您可以在之后进行更改。保持默认设置将保留标准外观。
• 启动器位置和气泡样式 — 左下角或右下角，渐变光晕或平面实色强调。
• 角落圆度、窗口高度和宽度 — 滑块，面板在移动设备上会自动全屏停靠，无论您的设置如何。
• 自定义字体 — 与您网站的字体匹配，只要它已经加载在页面上。
• 自定义CSS 扩展计划 — 使用您自己的规则重新样式化小部件的任何部分，仅在小部件的隔离阴影DOM内应用（它无法泄漏到您的页面，您的页面也无法泄漏进来）。在规则前加上 .dark 或 .light 以仅针对一个主题；Bot Studio 包含一个带有自己深色/浅色切换的实时预览。

• 欢迎消息 — 访客打开聊天时，机器人说的第一句话。
• 后备消息 — 当它无法提供帮助时所说的话。
• 交接邮件 — 当它卡住时指向访客的地方。
• 推理模式 增长计划 — 基础（默认）仅从您训练的内容中回答。灵活模式允许它在商业相关问题上稍微超出您的文档进行推理，但它仍然不会编造具体的价格、日期或政策，并且仍然拒绝任何与您的业务无关的内容。
• 访客记忆 增长计划 — 默认关闭。当开启时，机器人会记住跨会话的回访访客，而不仅仅是在一个标签页内：它会回忆起他们分享的持久事实和之前对话的简短总结，因此重复访客不必重新解释自己。记忆仅从访客实际输入的内容中提取，并在机器人被删除时一并删除。访客也可以随时自行删除：当记忆开启时，小部件会在消息框下显示一个安静的“忘记我”链接，清除机器人存储的关于他们的所有信息，无需账户或支持票。它在白标小部件上也保持可见——隐私控制不应因为品牌消失而消失。
• AI模型 扩展计划 — 将机器人指向 OpenAI（调优的默认值）、Anthropic Claude、Groq、DeepSeek、Gemini 或 xAI。每个提供商提供一份简短的、经过审查的模型列表，并附有速度和成本提示，因此拼写错误不会悄悄将您的机器人发送到一个不存在的模型。需要列表上没有的东西？在同一面板中使用“请求不同或更高的模型”，我们的团队将进行审核。用于训练的嵌入始终在 OpenAI 上运行，无论聊天模型如何。
• 实时人工交接 扩展计划 — 添加一个“与人交谈”按钮。请参见下面的 人工接管。

每个机器人自动理解并回复95种以上的语言，检测访客使用的任何语言——即使访客用拉丁字母拼写时，也能以该语言的本地脚本进行回复。

Bot Studio → 知识列出机器人训练过的每个来源——文件和页面都有——并可以选择删除任何单一来源。要添加更多内容，请使用 添加知识；要刷新它从实时网站所知道的内容，请使用 重新同步网站。这两者在上面的 训练来源 中都有详细说明。

根据您计划的每个机器人的自动化规则限制（增长10，规模20），有三种类型：

• 闲置 — 在页面上停留设定的秒数后触发。
• 退出意图 — 当访客的鼠标移动到关闭标签时触发（仅限桌面）。
• 页面 — 在任何包含您选择的片段的 URL 上延迟触发。

每条规则在每个访客的浏览器会话中触发一次，每次页面加载只显示一个提示卡，因此不会显得烦人。在聊天面板已经打开、对话进行中或进行实时交接时，什么都不会触发。

将您自己的 HTTPS 端点注册为聊天模型可以在对话中调用的工具 — 订单查询、检查可用性、创建支持票。模型决定何时相关，使用您定义的参数调用它，并将真实结果纳入其回答，而不是猜测。

• 每个操作最多 6 个参数，最多达到您计划的自动化限制每个机器人。
• GET 或 POST，带有可选的 bearer secret 作为 Authorization 头发送。
• 内置的 "测试端点" 按钮在您保存之前使用真实示例数据对定义进行干运行。
• 每次调用都受到保护，防止访问内部/私人地址，响应时间限制为 10 秒和 4,000 个字符，且仅发送您声明的参数到您的端点。

操作也可以通过 API 管理 — 请参见 API 与网络hooks。

适用于任何需要精确、可重复序列而不是自由形式答案的情况 — 资格审查、预定演示、退款路由。流程在访客的消息包含其触发短语之一时开始，并由一小组节点类型构建：

任何流程未覆盖的内容将直接转到正常的 AI 回答 — 流程是附加的，而不是知识库的替代品。

而不是一个机器人回答所有问题，定义最多 8 个专家 — 销售、支持、账单，任何适合您业务的角色 — 每个都有自己的路由描述、可选的专家指令、自己的工具权限，和可选的 AI 模型。每条访客消息都由正确的专家分类和回答，部件显示一个小标签，标明谁回复了。

• 路由是粘性的 — 对话保持在一个专家那里，直到话题明显转变，因此后续问题不会在代理之间跳转。
• 工具权限是按代理分配的 — 仅授予专家应能使用的代理行为和 MCP 连接器。拥有空白允许列表的代理根本无法使用任何工具。
• 他们可以在回答中交接 — 如果问题明显属于某个队友，专家会将其传递过去，该队友会立即在自己的指令、工具和模型下回答。访客无需重复提问，也不会看到交接过程。
• 每个回复都有归属 — 您的对话收件箱为每个答案标记了撰写者的专家，包括在中途交接后的回复，以便您审核对话如何在团队中移动。
• 专家添加，而不是覆盖 — 您的知识库、安全规则和基础仍然适用于每个代理，完全相同。
• 模板 — 从现成的销售、支持或账单专员开始，或一键创建整个初始团队，然后编辑任何内容。

如果路由无法决定，或者您没有定义代理，机器人将简单地以其自身的身份回答——就像今天一样。

MCP（模型上下文协议）是向 AI 助手公开工具的开放标准。只需连接一次 MCP 服务器，您的机器人就会自动发现它提供的每个工具——无需每个端点注册，无需编写模式。这些工具可以通过与代理行为相同的机制在对话中调用。

• 每个机器人最多可连接 3 个服务器，每个服务器最多提供 25 个工具。
• 使用可选的 Bearer 令牌进行身份验证的公共 HTTPS 服务器，采用可流式传输的 HTTP 传输。
• "测试连接"在您保存之前列出服务器公开的每个工具，因此您确切知道您的机器人获得了什么。
• 保存时工具会被缓存，因此连接服务器不会给实时对话增加延迟。重新保存会刷新列表。
• 每个连接器可以独立暂停，并且只有在您运行 AI 代理团队 时才能授予特定代理。

每个小部件对话都保存在您的对话收件箱中。可以按机器人或 "需要关注" 标记进行筛选，该标记标记了机器人回答在您训练的内容中得分低的对话——这是它没有给出良好答案的强烈信号。打开任何对话以阅读完整的记录，包括哪些回复被标记。

"重置分析"会清除机器人对话历史记录，而不会影响您计划的每月对话计数——使用是独立测量的，因此无法通过清除视图来重置。

在 Bot Studio 中连接一个渠道 → 部署 → 渠道，您的机器人将在那里以与网站小部件完全相同的知识、流程、代理团队和访客记忆进行回答——每个对话都将落入同一个收件箱，并标记其来源渠道。

• WhatsApp — 通过 Meta Cloud API，使用您自己的 Meta 应用。
• Telegram — 通过您与 @BotFather 创建的机器人。免费且设置最快，因此是最容易尝试的第一个。
• Slack — 回答直接消息和 @提及您的应用。

您提供自己的凭据，因此没有共享的平台账户，也无需等待 Meta 商业验证。每个渠道在面板中都有编号的设置指南，一个 "验证连接" 按钮可以在您依赖之前实时检查您的凭据，还有一个暂停开关可以在不断开连接的情况下停止渠道。

人工接管 也可以在渠道上工作——从您的收件箱加入渠道对话，您的回复将送达访客的应用中。返回的 WhatsApp 或 Telegram 联系人也会被访客记忆识别，就像返回的网站访客一样。

照片和语音消息被理解，而不是被忽视。 这些平台上的客户通常会发送收据的照片或录制快速问题，而不是输入。您的机器人可以读取图像——包括其中可见的任何文本、订单号或金额——并转录语音消息，然后像往常一样根据您的知识进行回答。这适用于您设置的任何 AI 模型。它无法打开的文件（PDF、文档）会被确认，客户会被询问详细信息，而不是完全没有回复。

Facebook 和 Instagram 广告：机器人知道他们点击了哪个广告。 将 "发送消息" 广告指向您连接的 WhatsApp 号码，其他无需设置。当有人点击时，您的机器人打开对话，已经知道广告的标题——因此它立即回答有关该产品或课程的问题，而不是再次询问刚刚告诉您他们想说什么的人，这是大多数广告驱动聊天失去用户的地方。如果他们更改主题，它会跟随他们，并且从不提及广告或任何跟踪。

每个对话都在您的收件箱中标记了其广告，分析 → 按广告 根据对话、参与度、捕获的电子邮件和 回答率 对您的活动进行排名——即机器人实际处理每个广告发送的人的能力。流量充足而回答率低的活动通常意味着广告承诺了您的机器人尚未训练的内容，这是 Meta 自身报告无法显示的差距。广告 ID 和点击 ID 也会与每个潜在客户一起传递到您的 CRM，因此您可以将转化报告回 Meta。

在 Bot Studio 中启用此功能 → 行为，"与人交谈" 按钮将出现在小部件中。当访客使用它时——或者您主动介入——您会立即收到电子邮件，您的回复会在几秒钟内出现在他们的聊天窗口中。完成后可以将对话交还给机器人，访客也可以随时返回机器人。

点击该按钮将在新标签页中打开一个专用的全屏聊天页面，携带到目前为止的对话内容，以免重复。已经登录 Granetra 的访客直接进入聊天——他们不会被要求再次登录。匿名访客会被要求先在该页面注册或登录，然后直接回到同一聊天。这对他们来说只需几秒钟，并在对话中提供了真实的电子邮件地址——因此如果他们在您回复之前关闭标签，您仍然可以跟进。

一切保持为一个对话：您从同一个收件箱回答，客户网站上的小部件也会显示您的回复，因此访客可以自由切换两个标签。

• 按天或周统计的对话量和回答率。
• 访客实际询问的热门问题，按频率排名。
• 主题细分和简单的漏斗：开始 → 参与 → 解决。
• 错失的机会 — 机器人反复无法回答的问题，这是下一个需要添加到其知识中的最明确信号。
• 访客的满意度反馈（点赞/点踩）和潜在客户——当访客因为机器人无法提供帮助而被指向您的交接电子邮件的时刻。
• 一份简短的基于规则的建议下一步行动列表。

在分析页面的顶部，您会找到一个网站流量面板：访客、页面浏览量、会话和每次访问的页面数，以及与之前时期的比较，您可以按日、周、月或年查看的时间线，您的热门页面，流量来源，设备分布，以及当前在您网站上的实时访客数量。

无需安装任何东西。 您已经嵌入的聊天小部件负责测量，这也意味着它测量小部件安装的页面——不一定是您网站的每个页面。如果您想要全面覆盖，请将小部件添加到整个网站。

它默认设计为尊重隐私：不会设置新的cookie，查询字符串和URL片段在存储之前被剥离（因此您自己URL中的会话令牌或电子邮件地址不会被记录），引用者被简化为基本域名。流量数据保留400天。

从仪表板 → 团队邀请队友。每个账户都有自己的个人团队；邀请某人会在一个角色下与他们共享您的机器人、对话和设置：

座位（成员加待定邀请）根据您的计划进行扩展 — Growth 包含最多 3 个，Scale 包含最多 10 个。对机器人、成员或设置的每次更改都会记录在团队活动日志中。

所有价格均为月度显示；按年支付可节省 20%。需要更大、定制的数量或签署 DPA？请查看 企业版。

每个付费计划——Starter、Growth 和 Scale——在仪表板上您的账户名称旁都有一个 验证徽章，以便任何查看您的个人资料或管理员列表的人都知道这是一个真实的、已订阅的 Granetra 账户。Granetra 员工（首席账户）默认携带此徽章，无论计划如何。

账单由 Polar 处理，我们的记录商——您的支付信息不会直接接触 Granetra 的服务器。您可以随时通过仪表板 → 管理账单管理您的订阅（更新卡片、切换计划、取消、查看发票），这将打开 Polar 的安全托管门户。

• 无论您是按月还是按年付款，谈话使用量将在您的每月账单周期内重置。
• 升级立即生效；降级将在下次续订时生效。
• 企业计费基于发票，并提供专用的DPA — 请参见 企业版。

• 您的数据属于您 — 您的知识库仅用于回答您自己访客的问题。它从未被出售或共享。
• 端到端加密 — 所有内容在传输中（TLS）和静态时均被加密。
• 从不用于训练 AI 模型 — 您的内容和对话从未被反馈到任何模型的训练中。
• 按设计符合 GDPR — 您可以随时从设置中导出或永久删除您的帐户及其所有数据，无需支持票。
• 帐户保护 — 每个帐户均可免费使用双因素身份验证和完整的活动会话视图（查看并注销任何设备）。

详细信息请参见我们的 隐私政策 和 服务条款。

一个REST API和签名的webhooks，用于自动化仪表板所做的一切：列出您的机器人，读取对话和记录，发送聊天消息并获取回复，以及管理代理操作 — 所有这些都使用范围限定的bearer密钥。Webhooks在对话开始、访客请求人工客服或捕获潜在客户时，立即发送签名的重试POST。密钥还可以携带IP允许列表并报告每个密钥的使用情况。

阅读完整的API参考

小部件在我的网站上不显示

确认脚本标签存在并放置在 </body> 之前，并且机器人的状态为“准备就绪”（而不是“训练中”或“失败”）。如果您在 Bot Studio → 访问中设置了“允许的网站”列表，请确保您测试的域名已包含在内——否则小部件将按设计静默拒绝加载。

训练失败，或网站无法爬取

某些网站会阻止自动爬虫，而完全使用 JavaScript 渲染的页面无法以这种方式读取。尝试导出相同内容的 PDF 或 Word 文件 — 这几乎总能解决问题。

机器人一直说它不知道

检查您期望它知道的内容是否实际列在知识库中。通过 "添加知识" 添加更多源材料，或开启 "灵活推理"（Growth+），以便它可以在您的确切文档之外进行一些推理。

访客在聊天过程中被要求注册

作为使用保障，匿名访客在一次对话中达到 5 条消息而未留下联系信息时，会被邀请登录或创建一个免费帐户以继续。如果该人是已登录的 Granetra 用户，则不适用——这仅影响真正的匿名网站访客。

我已达到每月对话限制

仪表板上的使用计量器准确显示您的当前状态以及何时重置。随时升级您的计划以获得更高的限制——请参见 计划。

已登录？在仪表板侧边栏中使用 "发现错误？" 按钮直接向我们的团队报告问题。对于其他任何问题，请发送电子邮件至 granetra@gmail.com——或者直接在此页面的角落打开聊天气泡。这是一个真正的 Granetra 机器人，经过本文件的训练。

已经在使用 Granetra？我们真心希望听到您的使用情况——从任何机器人卡片中复制您的机器人 ID，并在我们的 评论页面 上留下评论。