# 概览 ## 按场景 [#按场景] ## 按行业 [#按行业] # 网店客服 让顾客在你的网店里问商品、查订单、了解售后，不必离开正在购物的页面；服务入口、品牌和客户关系仍由你经营。 ## 适合谁 [#适合谁] 适合有自己的网站、登录体系和订单系统的商家，以及为商家建设店铺的开发者。你需要整理商品资料、售后规则和人工联系入口，并能提供按顾客身份查询订单的业务接口。 先从一个店铺和一类问题开始，例如已登录顾客的订单查询。把回答依据和转人工条件写清楚，比一开始覆盖所有售后流程更容易验收。演示中的账户与订单是样例，不能直接作为你的客户系统。 ## 能做到的几件事 [#能做到的几件事] * **在购物页面答疑**：顾客点开客服气泡，围绕商品与店铺规则提问。商家决定名称、欢迎语和回答范围。 * **查自己的订单**：接入订单工具后，客服可以读取当前顾客的订单状态，省去让顾客反复描述订单的步骤。 * **按流程申请退货**：先核对订单与条件，再让顾客确认；演示展示的是提交申请，不是承诺自动退款或固定到账时间。 查询和提交动作都依赖你接入的业务工具。订单归属要由工具服务端核对，不能让顾客在对话里换一个姓名就读到别人的订单。资料里没有的政策，客服应引导顾客联系商家确认。 ## 方案组成 [#方案组成] | 业务需要 | 接入入口 | | ------------- | ----------------------------------------------------------------------------------------- | | 确定客服职责与回答范围 | [服务智能体](/docs/developers/agent) | | 在店铺显示客服窗口 | [选择嵌入方式](/docs/developers/agent/embed/overview) | | 识别当前顾客并提供会员信息 | [嵌入令牌](/docs/developers/agent/embed/tokens)与[业务上下文](/docs/developers/agent/embed/context) | | 查询订单、处理授权 | [工具授权](/docs/developers/agent/embed/tool-authorization) | | 按登录用户接入完整页面 | [SaaS 嵌入配方](/docs/cookbook/scenarios/saas-embedded-assistant) | ## 怎么上线 [#怎么上线] 1. 按[智能体快速开始](/docs/developers/agent/quickstart)准备客服，录入你已确认的售后规则，并在试用中核对回答。 2. 按[嵌入到网页](/docs/developers/agent/embed/quickstart)接入店铺；账户身份来自你的网站登录态，凭证由后端保管。 3. 按[工具授权](/docs/developers/agent/embed/tool-authorization)接通订单查询，再验证退货申请。先用测试账户和测试订单走完流程。 4. 用两个不同账户检查订单隔离、退出登录后的行为、未知政策的回复和申请确认。核对业务系统的记录确实变化后，再开放给顾客；保留原有人工联系入口。 **交给你的代理**： ```text 目标：在我的网店接入客服。先阅读本站 /docs/solutions/ecommerce-support，沿页面链接完成接入。 请向我确认店铺地址、测试环境、智能体、登录方式、订单接口和已审核的售后规则；凭证只配置在后端，不要在对话中输出。 完成判定：页面可对话；两个测试账户只能查询自己的订单；退货申请经确认后写入业务系统；未知政策指向人工联系入口。 交付接入结果、验证记录和关闭客服入口的方法。 ``` ## 成本估算 [#成本估算] 成本估算待补。[公开定价](/docs/developers/account/pricing)与[模型目录](/docs/developers/model/catalog)不足以给出这套客服方案的完整费用。试用时先记录会话数、每次会话轮数、模型用量和工具调用，再据可核对的价格估算；这里不承诺每单固定成本。 ## 演示 [#演示] 打开[好物集客服演示](https://praxis-kit-demo-develop.jshansince93.workers.dev/products/headphones)，在右上角选择一个演示账户，再打开客服气泡，试问“查看我的订单”。核对回答和“我的订单”页面一致；需要体验退货时使用演示订单，不输入真实客户资料。 ## 下一步 [#下一步] 先走完[网页嵌入指南](/docs/developers/agent/embed/quickstart)，再通过[运营与管理](/docs/developers/agent/monitor)查看会话与用量。只需要回答公开规则时，可以从[产品帮助中心方案](/docs/solutions/help-center-assistant)开始。 # 在线教育助教 让学员在你的课程页面里获得与当前课时有关的解释和复习提示，把提问留在学习过程里，课程内容、品牌和学员关系仍归你。 ## 适合谁 [#适合谁] 适合拥有课程网站的教育机构、课程创作者，以及为其建设学习平台的开发者。你需要准备可供助教使用的课时介绍、要点和回答边界，并能改动课程页面、连接现有登录体系。 先选一门资料完整的课程验证。助教依据你提供的内容与页面状态回答，并不会因为页面上有视频就自动理解全部音视频。涉及课程之外的知识、考试评分或个别学习判断时，应明确说明需要教师确认。 ## 能做到的几件事 [#能做到的几件事] * **围绕当前课时提问**：把课程名称和课时信息传给助教，学员不必每次重复“我正在看哪一课”。 * **读取播放进度**：页面工具可以读取播放器当前位置，让“我看到哪里了”这样的提问有具体依据。 * **在学习页面调整播放**：接入对应页面工具后，助教可以配合学员的请求跳到指定位置或切换课时；具体动作由你的播放器实现。 页面信息用于理解学习场景，不用于判定课程购买权限。学员能否访问某门课仍由你的网站决定；不能把浏览器报告的课程名称或进度当作成绩和结业凭据。 ## 方案组成 [#方案组成] | 学习体验 | 接入入口 | | -------------- | ------------------------------------------------------------- | | 定义助教角色、知识范围与口吻 | [服务智能体](/docs/developers/agent) | | 在课程旁展示助教 | [选择嵌入方式](/docs/developers/agent/embed/overview) | | 提供当前课时与播放位置 | [前端工具与页面上下文](/docs/developers/agent/embed/client-tools) | | 关联登录学员 | [嵌入令牌与终端用户](/docs/developers/agent/embed/tokens) | | 将组件接入已有账户页面 | [SaaS 嵌入配方](/docs/cookbook/scenarios/saas-embedded-assistant) | ## 怎么上线 [#怎么上线] 1. 按[智能体快速开始](/docs/developers/agent/quickstart)建立助教，准备课程介绍、课时要点和范围外问题的处理方式。 2. 按[网页嵌入指南](/docs/developers/agent/embed/quickstart)把助教接到课程页面，让后端根据当前登录学员签发令牌。 3. 按[前端工具与页面上下文](/docs/developers/agent/embed/client-tools)接入课时信息与播放器。先接读取进度，再根据需要接入跳转或切换动作。 4. 在不同课时、不同进度提问，核对回答使用当前状态；检查学员切换、退出登录与工具失败时的行为。确认教师认可回答范围后，再向学员开放。 **交给你的代理**： ```text 目标：给我的课程网站接入助教。阅读本站 /docs/solutions/course-assistant，并沿链接完成接入。 请确认课程页面地址、登录方式、智能体、课时资料、播放器接口，以及允许助教执行的动作；凭证只配置在后端。 完成判定：助教可对话；切换课时后识别新课时；报告的播放进度与页面一致；允许的播放动作可验证；范围外问题引导联系教师。 交付验证记录，以及暂停助教入口、不影响课程播放的方法。 ``` ## 成本估算 [#成本估算] 成本估算待补。[公开定价](/docs/developers/account/pricing)尚不足以给出完整的课程助教费用。先用一门课程采集活跃学员数、每位学员的问答轮数与模型用量，再制定预算；视频托管和你现有教学系统的费用应分别统计。 ## 演示 [#演示] 打开[好物集课程助教](https://praxis-kit-demo-develop.jshansince93.workers.dev/courses/earbuds-101)，选择演示账户并打开助教。切换课时、拖动播放进度，再问“我现在学到哪里了？”并对照页面验证。 演示使用模拟播放器，展示的是课时、进度与助教之间的交互，不是实际课程的视频分析。可以继续请求跳到某个位置，观察播放器是否执行了相应动作。 ## 下一步 [#下一步] 从[页面工具指南](/docs/developers/agent/embed/client-tools)接入你实际使用的播放器。上线前阅读[嵌入安全](/docs/developers/agent/embed/security)，并为助教无法回答的问题保留教师联系入口。 # 产品帮助中心 让客户在你的帮助中心直接提问，从已发布的资料中找到使用方法和服务规则；帮助内容、品牌与客户联系入口由你维护。 ## 适合谁 [#适合谁] 适合已经有产品文档、常见问题或售后规则的企业，以及维护这些站点的开发者。你需要一组已经审核、可以公开的问答资料，一个能改动的页面，以及能为访问者建立身份的后端。 先选范围明确的主题，例如配送、退换货和会员说明。资料少时可以直接配置回答内容；资料多时再单独评估知识检索的接入。本方案演示的是基于一组固定问答的助手，不承诺自动抓取全站或自动保持资料更新。 ## 能做到的几件事 [#能做到的几件事] * **在原页面直接问**：客户点击搜索入口，或使用页面提供的快捷键，打开问答窗口，不必切换到另一个聊天产品。 * **围绕已发布内容回答**：把常见问题变成自然语言问答，客户可以继续追问同一个主题。 * **给范围外问题留出路**：资料没有说明的优惠、时效和服务承诺，应提示客户联系你的客服确认，避免把猜测当成政策。 这个助手负责解释帮助内容。它不会因为知道退货规则就自动获得查订单或退款权限；需要访问账户数据时，再按业务需要接入经过授权的工具，并另行验收。 ## 方案组成 [#方案组成] | 服务入口 | 接入入口 | | ----------- | ----------------------------------------------------- | | 设置资料范围与回答规则 | [服务智能体](/docs/developers/agent) | | 在站点打开问答窗口 | [文档站问答配方](/docs/cookbook/scenarios/docs-qa-assistant) | | 选择弹窗或嵌入形态 | [嵌入方式](/docs/developers/agent/embed/overview) | | 区分访问者与会话 | [嵌入令牌与终端用户](/docs/developers/agent/embed/tokens) | | 管理会话与查看使用情况 | [运营与管理](/docs/developers/agent/monitor) | ## 怎么上线 [#怎么上线] 1. 按[智能体快速开始](/docs/developers/agent/quickstart)创建助手，整理可公开资料和客服联系入口。先在试用中验证答案与原文一致。 2. 按[文档站问答配方](/docs/cookbook/scenarios/docs-qa-assistant)接入窗口与打开入口。已有登录体系时使用登录身份；面向访客时，由后端为不同访客建立稳定、独立的身份。 3. 按[嵌入安全](/docs/developers/agent/embed/security)核对站点来源与后端凭证保管。演示里的共用访客身份只用于演示，不直接复制为正式站点的身份方案。 4. 测试已知问题、未知问题、窗口关闭与重新打开、不同访问者的会话，以及加载失败的提示。保留原有帮助文章与联系客服入口，确认问答不可用时客户仍能求助。 **交给你的代理**： ```text 目标：给我的帮助中心接入问答。阅读本站 /docs/solutions/help-center-assistant，并沿链接完成接入。 请确认帮助中心地址、已审核的公开资料、智能体、登录或访客身份方案及人工联系入口；凭证只配置在后端。 完成判定：点击入口可提问；已知问题与原文一致；未知问题不编造政策；不同访问者的会话隔离；失败时仍能阅读帮助文章并联系支持。 交付验证记录和关闭问答入口的方法。 ``` ## 成本估算 [#成本估算] 成本估算待补。[公开定价](/docs/developers/account/pricing)与[模型目录](/docs/developers/model/catalog)不能单独推出完整问答服务的成本。试用时记录问答次数、平均轮数、资料长度和实际模型用量；后续若接入知识检索，应另行计入相关费用。 ## 演示 [#演示] 打开[好物集帮助中心](https://praxis-kit-demo-develop.jshansince93.workers.dev/help)，点击搜索入口或按 ⌘K（Windows、Linux 为 Ctrl+K）。试问“如何申请退货？”，再问资料中没有的具体退款时效。 对照页面上的原始问答检查回答：已知规则应一致，缺失的承诺应引导联系客服。这里的资料是网店示例；接入你的产品时，要替换为你自己的帮助内容。 ## 下一步 [#下一步] 从[文档站问答配方](/docs/cookbook/scenarios/docs-qa-assistant)开始接入。需要查询客户订单、提交售后申请时，再阅读[网店客服方案](/docs/solutions/ecommerce-support)，为新增业务动作补齐授权与验证。 导出自 Praxis 文档 · 2026-10-22 · 共 4 页