For AI agents: the complete documentation index is available at https://docs.danqiuos.com/llms.txt, the full documentation bundle is available at https://docs.danqiuos.com/llms-full.txt, and this page is available as Markdown at https://docs.danqiuos.com/start/quickstart.md.

快速开始:构建 CRM 场景方案

这份教程带你把企业的业务场景做成一套可使用的方案:先用 WorkBuddy 或 Codex 构建 Workbench 应用和 Arcubase 数据,再让数字员工通过对话处理具体工作。

以“CRM 客户线索管理”为例,完成后销售可以在工作台查看和跟进线索,也可以对销售助理说“帮我记录这个客户”。助理将确认后的信息写入同一个数据应用,工作台随即能查询到这条记录。

先理解三个组成部分

组成在 CRM 场景中负责什么
Workbench 工作台提供线索列表、搜索筛选、详情和跟进操作,让人直接管理业务
Arcubase 数据基座保存线索和跟进记录,定义字段、关系和访问范围
销售助理数字员工理解对话或材料,提取信息、检查缺项和重复,确认后写入数据

应用与数字员工使用同一个 Arcubase App 和业务记录。 共享数据连接了两种工作入口,无需先让员工模拟点击工作台。如果应用还要直接调用员工、会话或任务,则按需增加 Octopus 或 Taskboard 客户端。

WorkBuddy、Codex 负责帮助你开发和装配上述方案;销售助理负责方案投入使用后的业务工作。两种角色的身份和授权分别核对。

第一步:连接企业环境

先完成连接 WorkBuddy 或 Codex:安装 octopus-cli、登录企业 Portal、绑定目标 Team,安装并加载 workbench-app-development Skill。

本步结果: AI 工具能读取开发 Skill,CLI 返回的 Profile、Host、账号和 Team 与你的企业信息一致。准备一条获准用于测试的线索,以及可执行样例写入的授权;不要使用尚未允许处理的真实客户资料。

第二步:把自己的业务说清楚

先确定最小范围。本教程第一版只做线索录入、查询和跟进,不一次加入报价、合同或回款。你可以把下面内容直接发给 WorkBuddy 或 Codex,并补充企业差异:

请使用 workbench-app-development Skill,帮助我们构建 CRM 客户线索管理方案。
目标:销售可以在 Workbench 查看、搜索和跟进线索;之后由销售助理通过对话录入,
两种入口使用同一个 Arcubase 数据应用。

第一版需要:线索列表、按负责人和状态筛选、线索详情、新增线索、添加跟进记录。
业务角色:销售只访问获授权的线索,销售经理按企业规则查看团队范围。
数字员工稍后接入,先把应用和数据跑通。

请先核对当前账号、企业和 Team,询问我缺少的业务规则。
先提出页面、表结构、字段、角色权限和验收方案,不创建数据或发布应用。
说明哪些能力需要启用,并让我选择复用已有 Arcubase App 还是新建。

确认四件事:谁使用、字段是什么、谁能读写、什么算完成。需要更复杂的分析时使用CRIDO 场景卡,但不用先学完所有平台概念才开始。

第三步:确认 Arcubase 数据基座

以下是本教程的建议结构,由你和 AI 工具结合业务确认。它不是预置表,也不是可直接提交的 API 请求体。

表建议字段业务用途
客户线索企业名称、联系人、联系方式、线索来源、需求摘要、负责人、状态、下次跟进日期保存线索主体和当前处理状态
跟进记录关联线索、跟进人、时间、方式、跟进内容、下一步动作保留每一次跟进及其依据

先约定必填项,例如企业名称、需求摘要和负责人;联系方式未知时可以留空。状态可先采用“待跟进、跟进中、已转化、暂缓”等企业确认的值。查重依据可以是标准化联系方式和企业名称组合,模糊相似只提示核对,不直接合并。

  • 复用已有 App: 核对明确的 App ID、现有表结构、字段 key 和权限,避免另建一份客户台账。
  • 新建 App: 确认字段、关联和访问模型后,授权 AI 工具在指定 Team 创建。
  • 身份与权限: 应用用户和销售助理分别获得所需权限;“销售只看自己的线索”必须由实际数据权限支持,不能只靠页面过滤。

确认方案后,可继续发送:

我选择【复用 App ID:…… / 在指定 Team 新建数据应用,两者选一】。
按刚确认的表结构和访问范围实施;写入范围仅限本次批准的结构和测试记录。
请先再次核对登录上下文,回读实际表结构。此步只准备数据,不生成前端工程文件。
不要按表名猜字段或标识。交付时列出实际 App ID、表标识、稳定字段 key、
关联关系、状态值和各角色权限,供后续销售助理复用。

本步结果: 真实的数据应用和权限已配置,拿到了可回读的结构与标识。细节见数据与权限设计。

第四步:用 Skill 构建并验收工作台

让 AI 按官方 Skill 继续创建或扩展应用。CRM 的持久化业务数据需要 arcubase;仅展示当前登录用户无需额外选择 octopus。如果需要查询团队成员、调用数字员工或使用会话等平台能力,再选择 octopus;需要管理任务时再选 taskboard。

请继续使用 workbench-app-development Skill 构建已确认的 CRM 工作台。
新应用使用官方脚手架;已有项目保留原工程和改动。
创建或检查业务工程后,在明确的项目目录内根据实际 App 表结构生成 Arcubase 强类型客户端。
使用刚确认的同一个 App,保留官方认证。

完成列表、搜索、负责人/状态筛选、详情、新增线索和添加跟进。
展示真实后端记录;没有记录时显示真实空状态,不用模拟数据冒充接入。
保存失败要显示错误,保存成功后重新查询并刷新列表。

启动本地预览,告诉我实际 URL、登录方式、目标 Team、所选能力和 App ID。
先做本地验收,暂不创建远端项目或发布。

打开 AI 提供的本地 URL,按脚手架的开发登录 / JCode 流程完成授权。CLI 登录不代替这里的浏览器登录。 验证获准测试的新增、筛选和跟进操作,并回读后端记录;用受限角色检查看不到未授权线索。

本步结果: 用户通过工作台能操作真实数据。保留 App ID、表字段说明、权限和测试结果,下一步交给数字员工复用。官方开发要求见Workbench 应用开发。

第五步:装配销售助理

工作台和数据跑通后,再把“听懂对话并录入线索”交给销售助理。可以继续让 AI 工具通过当前 CLI 支持的配置能力协助装配;若当前版本不支持所需配置,则由授权管理员在 Portal 完成,不能凭空编造命令。

配置项本教程要求
岗位职责协助当前获授权销售录入线索、查询线索和登记跟进
岗位 Skill提取信息 → 核对必填项 → 查重 → 展示待写入内容 → 确认 → 写入并回读
工具能力Arcubase 使用类能力及实际需要的资料读取能力;业务岗位无需因此获得表结构管理权限
数据绑定复用工作台的同一 App、表、稳定字段 key、状态及关系
身份与资源确认用户、执行员工、Team 和数据访问范围;不从昵称猜负责人
输出返回实际记录标识和结果摘要;工作台重新查询可看到对应记录

可以给开发助手发送:

现在为这个 CRM 场景配置“销售助理”。请复用已经验证的同一 Arcubase App,
不要新建客户库。先依据现有表结构生成岗位说明、线索录入 Skill 和最小授权方案。

从用户对话提取企业、联系人、联系方式、来源、需求和跟进安排。
缺必填项时询问;可能重复时展示候选供人确认;禁止自动合并客户。
写入前展示结构化内容并请求确认;写入后回读真实记录,返回记录标识和摘要。
不能确定用户归属或数据权限时先停止并说明缺口。

先展示岗位、Skill、数据映射和授权清单。经我确认后,用当前已验证的 CLI 配置能力
或明确的 Portal 操作完成装配,报告实际数字员工标识和验证结果。

具体的岗位定义、技能编写和装配交付在对应章节展开。本页的提示词用于指导开发助手,不能代替真实的员工创建、技能绑定和资源授权。

第六步:验证“对话录入,工作台可见”

在 Octopus 中打开已配置的销售助理会话。下面使用虚构样例,发送前换成已获准的测试信息,并补充明确的跟进日期:

请帮我记录一条测试线索:示例制造公司的王经理想了解数字员工方案,
来源是展会沟通,需求是整理客户线索并提醒跟进。联系方式暂未提供。
请由我负责,下一次跟进日期是【填写具体日期】。先把准备录入的内容给我确认。

检查助理是否解析到正确的负责人、询问必要缺项、查询重复项,并在确认后写入。然后打开工作台:

  1. 刷新列表,找到刚创建的记录,核对实际记录标识与字段。
  2. 在工作台添加一条获准的测试跟进。
  3. 回到助理会话,查询该线索,确认它能读取刚更新的信息。
  4. 再测试重复线索、缺少必填项、取消确认和越权查询。

通过标准: 工作台与员工读写的是同一条真实记录;失败时如实说明,未确认或未授权时不写入。助理说“已录入”或界面弹出“成功”都不足以独立证明完成。

第七步:发布和交给业务团队

本地联合验收通过后,明确批准发布,由 AI 工具按官方 Workbench Skill 完成构建、发布和状态跟踪。取得最终地址后,再验收登录、直接打开与刷新业务路由,以及员工写入后的工作台展示。

交接时记录:Workbench 地址与项目/发布任务标识、Team、Arcubase App 和表字段、销售助理标识、岗位 Skill、各角色权限、验收结果和维护人。发布应用、配置员工和验证业务是三个不同环节,完成其中一个不能代替另外两个。

换成你自己的业务场景

要替换的部分CRM 客户线索财务报销
工作台线索、跟进和负责人视图我的报销、明细、附件及复核入口
数据基座线索表、跟进记录报销单、费用明细、发票附件关联
数字员工销售助理整理对话并录入线索报销助理读取对话和发票,生成待确认草稿
人工节点查重、负责人和写入确认信息核对、归属确认、提交与审批
联合验收对话录入后工作台可见;界面更新后员工能读取发票整理后工作台有草稿;复核状态能被员工查询

下一步阅读财务报销示例方案,或在本教程跑通后扩展销售跟进与商机协作。每次扩展都复核数据、权限和验收路径,让已有方案逐步承接更多业务。