跳转到内容
交付 API
在围绕某项功能进行规划之前,请先查看功能状态。

指南互动

网站聊天机器人

为您的网站添加 Atlas 聊天机器人,支持脚本化流程、基于您自有内容的 AI 回答以及线索收集。

本页面由英文翻译而来。如有任何差异,以英文版本为准。 阅读英文版

  • 在 Studio 中构建的脚本化流程:问候语、按钮、问题和线索收集。
  • 基于您站点自身已发布内容的 AI 回答,由您套餐的 AI 额度支付。额度用完后,机器人会给出其回退消息。
  • 外观和触发条件:颜色、启动按钮图片以及何时打开,均在 Studio 中按站点设置。
  • 当对话看起来是自动化的时,启用 Turnstile 防护。
  • 线索:访客在线索步骤中提供的信息会像表单咨询一样出现在 Forms & leads → Leads 中。

目前尚不支持转接真人客服。

聊天机器人随发布版本进入生产环境。生产环境开启且有已签名的发布版本在线上时,已发布的聊天机器人会回应真实访客,使用该发布版本中页面的知识(最多 5,000 个段落)。开发环境中的更改只会随下一个获批的发布版本到达访客。

生产环境关闭时,聊天机器人地址会返回 404 CP_NOT_FOUND;生产环境已开启但没有线上发布版本时,返回 403 CP_PRODUCTION_LOCKED。

  1. 在根布局中渲染一次小组件。 它不需要令牌:浏览器直接与 Atlas 通信,而 Atlas 只接受您已登记的网站来源。

    app/atlas-chat.tsx
    'use client';
    import { AtlasChat } from '@atlas/chat-widget';
    import '@atlas/chat-widget/styles.css';
    import { usePathname } from 'next/navigation';
    export function SiteChat() {
    const path = usePathname();
    return (
    <AtlasChat
    apiOrigin="https://delivery.atlas.example"
    environmentId="env_XXXXXXXX"
    botKey="support"
    path={path}
    />
    );
    }
  2. 在您的 Content-Security-Policy 中允许 Atlas:把 Atlas API 来源添加到 connect-src 和 img-src。

  3. 在线上部署中使用生产环境 id,其他所有地方使用开发环境 id。

该小组件包直接分发给已连接的客户;目前尚未发布到公共 npm 注册表。如果不使用 React,请使用纯客户端 createChatClient({ apiOrigin, environmentId, botKey }),它提供 bot()、start(path) 和 send(…)。

  • 对话与保存在访客会话存储中的随机密钥绑定。不使用 Cookie。
  • 只有访客在线索步骤中提交时,才会存储线索信息。
  • 按 IP 地址和按对话进行限速;请参阅限制。