> 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.

# 快速开始：构建 CRM 场景方案

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

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

## 先理解三个组成部分

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

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

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

## 第一步：连接企业环境

先完成[连接 WorkBuddy 或 Codex](https://docs.danqiuos.com/start/connect-ai.md)：安装 `octopus-cli`、登录企业 Portal、绑定目标 Team，安装并加载 `workbench-app-development` Skill。

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

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

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

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

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

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

确认四件事：谁使用、字段是什么、谁能读写、什么算完成。需要更复杂的分析时使用[CRIDO 场景卡](https://docs.danqiuos.com/build/crido.md)，但不用先学完所有平台概念才开始。

## 第三步：确认 Arcubase 数据基座

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

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

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

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

确认方案后，可继续发送：

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

**本步结果：** 真实的数据应用和权限已配置，拿到了可回读的结构与标识。细节见[数据与权限设计](https://docs.danqiuos.com/build/data.md)。

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

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

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

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

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

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

**本步结果：** 用户通过工作台能操作真实数据。保留 App ID、表字段说明、权限和测试结果，下一步交给数字员工复用。官方开发要求见[Workbench 应用开发](https://docs.danqiuos.com/build/workbench.md)。

## 第五步：装配销售助理

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

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

可以给开发助手发送：

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

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

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

具体的[岗位定义](https://docs.danqiuos.com/build/employee.md)、[技能编写](https://docs.danqiuos.com/build/skills.md)和[装配交付](https://docs.danqiuos.com/build/delivery.md)在对应章节展开。本页的提示词用于指导开发助手，不能代替真实的员工创建、技能绑定和资源授权。

## 第六步：验证“对话录入，工作台可见”

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

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

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

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

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

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

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

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

## 换成你自己的业务场景

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

下一步阅读[财务报销示例方案](https://docs.danqiuos.com/scenarios/reimbursement.md)，或在本教程跑通后扩展[销售跟进与商机协作](https://docs.danqiuos.com/scenarios/sales.md)。每次扩展都复核数据、权限和验收路径，让已有方案逐步承接更多业务。