--- url: https://docs.danqiuos.com/index.md --- > 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. OCTOPUS DOCK · 企业专属装配版 # Octopus 产品文档 从一个业务场景开始， 构建属于你企业的数字员工应用。 Octopus 是丹丘光年的数字员工产品。企业专属装配版提供数字员工的开发、装配与运行底座。你可以定义岗位职责，装配企业知识与技能，连接业务数据和系统，让数字员工进入真实工作流程，并在关键节点由人确认。 ## 从这里开始 [↗ **构建第一个场景方案 **用 WorkBuddy 或 Codex 构建 CRM 工作台，再接入销售助理，共享业务数据。 ](/start/quickstart)[⌘ **装配自己的数字员工 **从岗位设计、技能编写到权限配置，理解完整构建方法。 ](/build/overview)[▦ **开发企业场景应用 **把数字员工、业务数据与交互界面连接成一个应用。 ](/build/workbench)[▤ **探索业务场景 **参考客户线索、财务报销、经营分析与订单协同方案。 ](/scenarios/operations) ## 从方案设计到工具选择 | 当前任务 | 阅读入口 | 需要形成的结果 | | --------------- | --------------------------------------------------------------------------------------------------------------------- | -------------------- | | 连接 AI 开发工具与企业环境 | [WorkBuddy / Codex 接入](https://docs.danqiuos.com/start/connect-ai.md) | CLI 登录、团队核验与开发 Skill | | 把业务需求拆成可执行流程 | [CRIDO 场景分析](https://docs.danqiuos.com/build/crido.md) | 触发、依据、输入、动作与输出 | | 设计团队内的岗位和资源 | [Team 方案设计](https://docs.danqiuos.com/build/team-design.md) | 岗位卡、能力组合和工作区边界 | | 查找具体能力与工具标识 | [工具集速查](https://docs.danqiuos.com/reference/overview.md) | 与场景匹配的最小能力组合 | | 确认版本和交付标准 | [文档基线](https://docs.danqiuos.com/operations/doc-baseline.md)与[验收](https://docs.danqiuos.com/operations/acceptance.md) | 环境、证据及未验证项 | ## 一套底座，承载企业自己的应用 场景应用是业务入口，数字员工承接岗位工作，企业专属装配版提供共同的运行基础。已有场景可以作为起点，企业也可以按自己的业务流程开发新的应用。 **业务场景 ** 经营分析 销售跟进 订单协同 你的专属场景 **数字员工 ** 岗位与职责 知识与技能 工具与数据 任务与协作 Octopus 企业专属装配版 · 开发 / 装配 / 运行 / 治理 | 你需要解决的问题 | 对应的文档入口 | | ---------------- | ----------------------------------------------------------------------------------------------------------------------- | | 数字员工怎样理解职责并执行工作 | [岗位定义](https://docs.danqiuos.com/build/employee.md)与[技能编写](https://docs.danqiuos.com/build/skills.md) | | 如何读取业务数据并与现有系统协作 | [Arcubase](https://docs.danqiuos.com/platform/arcubase.md)与[企业系统连接](https://docs.danqiuos.com/platform/integrations.md) | | 如何把工作交给人确认、跟踪结果 | [Taskboard](https://docs.danqiuos.com/platform/taskboard.md)与[验收指南](https://docs.danqiuos.com/operations/acceptance.md) | | 如何构建团队长期使用的操作界面 | [Workbench 应用开发](https://docs.danqiuos.com/build/workbench.md) | ## 从业务目标，到可验收的结果 1. **定义工作。** 说明谁使用、需要什么结果、哪些动作需要确认。 2. **准备能力。** 配置岗位技能、数据来源、系统连接与授权范围。 3. **试跑场景。** 用可核对的样例执行任务，检查数据、工具轨迹和交付物。 4. **持续改进。** 依据运行问题补充规则与用例，再扩展到更多岗位。 查看 Octopus 工作台界面 ![Octopus 工作台，包含今日计划与业务管家对话](/images/workbench.png) 现有产品界面；具体菜单和能力以所用部署版本为准。 ## 如何使用这份文档 - **企业业务负责人：** 从[快速开始](https://docs.danqiuos.com/start/quickstart.md)和[场景实践](https://docs.danqiuos.com/scenarios/operations.md)了解应用与交付物。 - **企业开发者：** 阅读[构建方法](https://docs.danqiuos.com/build/overview.md)、[Workbench 开发](https://docs.danqiuos.com/build/workbench.md)和[CLI 指南](https://docs.danqiuos.com/build/cli.md)。 - **FDE 与实施团队：** 从[CRIDO](https://docs.danqiuos.com/build/crido.md)和[Team 设计](https://docs.danqiuos.com/build/team-design.md)准备方案，再使用[装配交付](https://docs.danqiuos.com/build/delivery.md)、[验收](https://docs.danqiuos.com/operations/acceptance.md)与[故障排查](https://docs.danqiuos.com/operations/troubleshooting.md)。 - **AI 编码助手：** 使用[供 AI 阅读](https://docs.danqiuos.com/operations/for-agents.md)中的 Markdown 文档入口。 :::tip 文档范围 本文档围绕企业专属装配版的能力与构建方法编写。场景实践是可供参考的方案，不代表开通后自动获得全部应用。具体可用能力、接入方式和实施范围，需结合部署版本与企业授权确认。 ::: --- url: https://docs.danqiuos.com/start/quickstart.md --- > 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)。每次扩展都复核数据、权限和验收路径，让已有方案逐步承接更多业务。 --- url: https://docs.danqiuos.com/start/connect-ai.md --- > 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. # 连接 WorkBuddy 或 Codex 你可以让 WorkBuddy 或 Codex 在本地开发项目中使用 `octopus-cli`，连接企业 Octopus 环境并构建应用。本页完成后，AI 开发工具应能识别开发 Skill、核对登录上下文，并在你指定的团队内开展已授权工作。 **选择一个工具即可。** WorkBuddy 与 Codex 使用同一份 Workbench 开发 Skill，只是安装目标不同。这里的 AI 工具是开发助手；后续销售助理、报销助理是部署在企业 Team 内的业务数字员工。 ## 1. 准备环境和企业信息 | 准备项 | 从哪里获得或怎样确认 | | ------------------------------- | ------------------------------------ | | WorkBuddy 或 Codex | 使用可访问本地项目、运行终端并加载 Skill 的工作环境 | | Node.js / npm、Git、Bash、Python 3 | 用于 CLI 安装、克隆与官方 Skill 安装校验；按官方依赖要求准备 | | 企业 Portal 地址 | 从企业管理员获取或复制实际 Portal 的来源地址，不使用本文示例代替 | | 账号与目标 Team ID | 由管理员确认账号权限及需要装配的团队 | | 开发目录 | 新应用选择空目录；已有应用打开原工程，保留现有改动 | | 业务权限 | 明确谁可以创建数据应用、配置员工，以及进行样例写入和发布 | 以下安装命令使用 Bash。Windows 用户应使用可供所选 AI 工具访问的 Bash 环境，并确认安装位置、CLI 与项目位于同一执行环境；不要把装在另一个用户或环境中的 Skill 当作已加载。 ## 2. 安装并连接 Octopus CLI 可在 AI 工具的终端运行，也可以让 AI 工具协助检查和执行。先检查是否已有 CLI；没有安装时再安装： ```bash octopus-cli --version ``` ```bash npm install -g @syngy/octopus-cli ``` 把下方占位内容替换为企业提供的真实值。`` 是你为该企业环境选择的本地配置名称： ```bash octopus-cli auth login --profile "" --web-url "<企业 Portal 来源地址>" octopus-cli configure team use "" octopus-cli auth whoami --json ``` 按照 CLI 提示在浏览器中完成登录授权，再核对返回的 Profile、Host、账号和 Team。CLI 登录和团队绑定成功，不代表该身份自动获得全部业务资源权限。 已有多个配置时，先选择正确的 Profile，再切换团队并复核： ```bash octopus-cli auth profiles list octopus-cli auth profiles use "" octopus-cli configure team use "" octopus-cli auth whoami --json ``` 缺少地址、团队或必要权限时向管理员补齐；不要根据公司简称猜测域名或 Team ID。具体参数以当前命令 `--help` 为准。本文连接命令已与官方开发契约及本机 CLI 0.1.13 帮助核对，未代替你的企业登录验证。 ## 3. 安装 Workbench 开发 Skill 开发流程由 [Workbench App Development Skill](https://github.com/syngy-ai/workbench-app-development-skill) 统一维护。首次安装，在你选择的工具资料目录中克隆仓库： ```bash git clone https://github.com/syngy-ai/workbench-app-development-skill.git cd workbench-app-development-skill ``` 按你使用的 AI 工具，**只执行对应一条**： ```bash # 使用 Codex ./scripts/install-local.sh codex ``` ```bash # 使用 WorkBuddy ./scripts/install-local.sh workbuddy ``` 默认安装位置分别为 `~/.codex/skills/workbench-app-development` 与 `~/.workbuddy/skills/workbench-app-development`；Codex 配置了 `CODEX_HOME` 时，安装脚本遵循该配置。脚本先用 Python 3 校验，再复制 Skill。已有该仓库时复用并核对版本，不要在非空业务应用目录中重复克隆或脚手架化。 安装完成后新建 AI 会话或重新加载技能，并打开你自己的业务应用项目目录。可以发送： ```text 请确认你能读取 workbench-app-development Skill 及其引用的命令和本地验收契约。 检查当前项目目录：新应用应为空，已有应用应保留现有工程和改动。 通过 octopus-cli auth whoami --json 核对当前 Profile、Host、账号和 Team， 并与我提供的企业信息比较。现在只检查，不创建应用、数据或远端项目。 请告诉我已具备哪些条件，以及还缺什么。 ``` 如果 AI 无法发现 Skill，核对所选客户端、运行用户和安装目录，再重新加载。不要仅因为安装输出显示成功，就假定当前会话已读取技能。 ## 4. 确认可以开始开发 继续之前，应得到四项明确结果： - AI 工具已读取 `workbench-app-development`，包括实际命令与本地验证契约。 - CLI 返回的企业环境、账号与目标 Team 一致。 - 业务应用目录已确定，新旧项目路径没有混淆。 - 需要使用的资源与管理权限已确认，尚未执行未授权写入。 浏览器中的 Workbench 本地开发登录是下一阶段的独立检查。CLI 已登录，并不代表本地应用浏览器已经有登录会话；后续应使用脚手架提供的开发登录 / JCode 流程，授权后返回业务页面。 ## 常见卡点 | 现象 | 下一步 | | ------------- | -------------------------------------------- | | 找不到 CLI | 检查安装是否成功，以及 AI 终端与安装终端的 PATH 和执行环境是否一致 | | 登录到了其他企业或团队 | 选择正确 Profile 和 Team，再运行 `auth whoami --json` | | Skill 不可见 | 检查客户端安装目标与运行用户，重新加载或新建会话 | | 能登录但不能建表或配置员工 | 请管理员授予明确的装配权限，或由授权人员完成配置 | | 本地应用要求再次登录 | 完成官方脚手架的开发登录；不要手写 token 存储或第二套登录页 | 准备完成后进入[快速开始：构建 CRM 场景方案](https://docs.danqiuos.com/start/quickstart.md)，从应用、数据和员工的分工开始。 --- url: https://docs.danqiuos.com/start/concepts.md --- > 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. # 核心概念 一个数字员工围绕岗位职责工作，需要知识、技能、工具与授权共同支撑。场景应用把这些能力组织成企业可使用、可验收的工作方式。 ## 数字工人与数字员工 **数字工人**可理解为可复用的岗位模板。**数字员工**是进入具体团队后的实例，拥有团队上下文、授权范围、会话与运行记录。同一岗位模板进入不同企业后，需要结合企业知识和规则重新配置。 员工数量并非越多越好。只有职责、数据范围或确认人不同，且确实需要接力时，才拆分为多个岗位。 ## 岗位、技能与工具 | 对象 | 回答的问题 | 示例 | | ----------------- | ---------------------- | ------------------------------- | | 岗位与 promptSpec | 我是谁，为谁工作，边界在哪里 | 面向管理层的经营分析助手 | | Skill | 某类工作按什么方法完成 | 经营简报的输入、步骤与验收规则 | | Skillset | 一个岗位组合哪些技能 | 简报、异常识别、周报 | | Toolset / Toolkit | 按能力组织的工具集合，需核对当前配置标识 | 业务数据使用、文档生成 | | Tool | 运行时调用的具体动作，参数由当前工具契约决定 | `arcubase-cli`、`officecli-docx` | 给员工写了“查询订单”的指令，并不会自动获得订单数据权限。技能、工具授权和数据可见范围必须彼此匹配。 工具集和具体工具可在[能力速查](https://docs.danqiuos.com/reference/overview.md)查找。Skill 定义方法，工具提供动作，资源权限决定能操作哪些对象，这三者需要同时成立。 ## Team、工作区与成果 Team 是场景装配的团队边界；工作区决定任务、内容与成果的协作范围。个人工作区不作为团队共享入口，团队工作区也应分别确认查看和提交权限。能使用数字员工，不代表能打开它处理的所有资料。详见[Team 设计](https://docs.danqiuos.com/build/team-design.md)与[工作区](https://docs.danqiuos.com/platform/workspaces.md)。 ## 数据、知识、本体与记忆 | 类型 | 适合承载 | 不宜替代 | | -------- | ---------------- | ------------ | | Arcubase | 客户、订单、回款等结构化业务记录 | 文件资料的全文说明 | | 知识库 | 产品手册、政策、SOP、参考文档 | 持续更新的交易台账 | | Ontos | 业务对象与对象关系、关系查询 | 业务数据库本身 | | 记忆 | 偏好、稳定事实、方法与经验 | 需要严格一致性的业务账本 | 这些能力可以共同使用。例如简报读取 Arcubase 台账，依据知识库中的统计口径，结合业务关系解释异常。 ## 任务与场景应用 **任务**承载目标、责任人、进度、结果与交接记录。**场景应用**围绕一类业务目标组合数字员工、数据与界面。 交互形态可以从对话开始：需要一次性的结构化确认时使用 A2UI；需要固定入口和长期页面时，考虑 Workbench。不是每个数字员工场景都需要单独开发前端应用。 ## 授权与人工确认 员工使用什么身份、可读取什么数据、能执行什么动作，受组织与权限约束。对外发送、价格承诺、发布、财务例外等动作应在业务设计中明确确认人和停顿点。 下一步阅读[构建方法总览](https://docs.danqiuos.com/build/overview.md)，将这些概念转为具体交付物。 --- url: https://docs.danqiuos.com/start/reading-paths.md --- > 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. # 选择你的阅读路径 从你需要完成的工作开始阅读。所有路线共用同一套产品概念，但关注的交付物不同。 ## 企业业务负责人 目标是确定先做哪个场景、如何判断有效，以及需要投入哪些业务资源。 1. [快速开始](https://docs.danqiuos.com/start/quickstart.md)：跟做 CRM 工作台、数据与销售助理的完整方案。 2. [财务报销](https://docs.danqiuos.com/scenarios/reimbursement.md)或[销售跟进](https://docs.danqiuos.com/scenarios/sales.md)：将路径换成自己的业务。 3. [验收与运行质量](https://docs.danqiuos.com/operations/acceptance.md)：用证据判断工作是否完成。 准备业务样例、工作规则、结果验收人和必须确认的动作清单，比先决定员工名字更重要。 ## 企业开发者 目标是把数字员工能力接入可长期使用的场景应用。 1. [连接 WorkBuddy 或 Codex](https://docs.danqiuos.com/start/connect-ai.md)：准备 CLI、企业身份和 Workbench 开发 Skill。 2. [快速开始](https://docs.danqiuos.com/start/quickstart.md)：先构建应用与数据，再接入数字员工。 3. [数据与权限设计](https://docs.danqiuos.com/build/data.md)：明确业务对象和访问边界。 4. [Workbench 应用开发](https://docs.danqiuos.com/build/workbench.md)：选择应用能力、开发与验收路径。 5. [CLI 使用指南](https://docs.danqiuos.com/build/cli.md)：理解本地身份、团队与配置操作。 先确认部署版本、目标环境和接口范围；页面控件、服务权限与员工身份应保持一致。 ## 实施与交付团队 目标是把非结构化需求转化成可以配置、验证和交接的方案。 1. [构建方法总览](https://docs.danqiuos.com/build/overview.md)与[CRIDO](https://docs.danqiuos.com/build/crido.md)：分析业务闭环。 2. [Team 方案设计](https://docs.danqiuos.com/build/team-design.md)：确定岗位、工作区和资源。 3. [岗位定义](https://docs.danqiuos.com/build/employee.md)与[技能编写](https://docs.danqiuos.com/build/skills.md)：明确职责和执行方法。 4. [装配与交付](https://docs.danqiuos.com/build/delivery.md)：依据已确认方案完成环境配置。 5. [验收](https://docs.danqiuos.com/operations/acceptance.md)与[故障排查](https://docs.danqiuos.com/operations/troubleshooting.md)：闭环问题与运行证据。 ## 运维与管理员 | 工作 | 推荐入口 | | -------- | ----------------------------------------------------------------- | | 团队与资源权限 | [组织权限与安全](https://docs.danqiuos.com/platform/security.md) | | 设备、凭据和内网 | [企业环境访问](https://docs.danqiuos.com/platform/enterprise-access.md) | | 内外部系统连接 | [企业系统连接](https://docs.danqiuos.com/platform/integrations.md) | | 工作区与成果访问 | [工作区与成果](https://docs.danqiuos.com/platform/workspaces.md) | | 工具集配置 | [能力速查](https://docs.danqiuos.com/reference/overview.md) | | 定时和事件驱动 | [计划任务与事件触发](https://docs.danqiuos.com/platform/triggers.md) | | 线上异常定位 | [故障排查](https://docs.danqiuos.com/operations/troubleshooting.md) | ## AI 编码与实施助手 [供 AI 阅读](https://docs.danqiuos.com/operations/for-agents.md)提供文档索引与逐页 Markdown。将需求、目标团队、允许的操作范围与验收标准一起提供给助手；文档本身不构成对真实环境写入的授权。 --- url: https://docs.danqiuos.com/build/overview.md --- > 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 快速开始](https://docs.danqiuos.com/start/quickstart.md)入手：连接 AI 工具，构建 Workbench 和 Arcubase，再装配销售助理。本页进一步解释方案设计方法。 ## 用 CRIDO 定义业务闭环 先完成[CRIDO 场景卡](https://docs.danqiuos.com/build/crido.md)：Cue（触发）、Reference（依据）、Input（本次输入）、Do（执行）、Output（结果）。再围绕[目标 Team](https://docs.danqiuos.com/build/team-design.md)确定岗位和资源。五阶段流程组织实施工作，CRIDO 用来检查每个场景是否从入口连到可验收结果。 ## 五阶段构建流程 | 阶段 | 要回答的问题 | 主要产出 | | ------- | --------------- | ------------------ | | 1. 场景调研 | 谁在什么条件下，要完成什么工作 | 业务目标、角色、流程与边界 | | 2. 团队设计 | 哪个岗位负责，哪些工作需要接力 | 员工职责、协作关系、能力清单 | | 3. 数据地基 | 数据在哪里，谁能读写 | 对象、字段、关系与读写矩阵 | | 4. 技能编写 | 员工如何可靠地执行 | Skill、工具规则、异常分支与用例 | | 5. 装配验收 | 配置是否正确，结果是否可用 | 配置记录、运行证据、验收与交接 | 前一阶段的产出是后一阶段的输入。数据口径尚未确认时，不应让技能自行猜测字段；业务确认点尚未定义时，不应默认自动外发。 ## 从业务动作拆解岗位 以“订单异常提醒”为例，先识别订单、客户、交期和责任人等对象，再决定需要一个履约助手还是跨岗位协作。只在责任边界确实不同的时候拆员工。 一个最小闭环应包含：触发输入、员工读取依据、执行步骤、需要人的节点、最终结果及其回写位置。 ## 选择合适的交互形态 | 需求 | 优先考虑 | | -------------- | ------------------------------------------------------------ | | 发起任务、追问结果 | 对话与消息渠道 | | 当前任务需要结构化选择或确认 | [A2UI](https://docs.danqiuos.com/platform/a2ui.md) | | 团队反复查看和操作固定页面 | [Workbench](https://docs.danqiuos.com/platform/workbench.md) | 应用界面与数字员工可以读写同一份业务数据，但需要分别检查用户身份和员工身份的权限。前端显示“已完成”不能替代后端任务和数据验证。 ## 明确参与者与责任 - 业务负责人：确认流程、口径、例外与结果标准。 - 开发或实施人员：完成装配、系统接入和样例验证。 - 管理员：授权团队资源，维护账号与连接。 - 验收人员：核对任务、数据变化和交付物。 ## 下一步 从[CRIDO 场景分析](https://docs.danqiuos.com/build/crido.md)和[Team 方案设计](https://docs.danqiuos.com/build/team-design.md)开始，再完成[岗位定义](https://docs.danqiuos.com/build/employee.md)。如果业务目标还不清楚，先用[场景实践](https://docs.danqiuos.com/scenarios/operations.md)中的输入、输出和验收结构补齐需求。 --- url: https://docs.danqiuos.com/build/crido.md --- > 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. # CRIDO 场景分析 CRIDO 把“希望数字员工帮忙”拆成一条可验证的工作链。它不是工具清单，而是选择员工、能力和交付方式之前的业务分析方法。 ```text Cue → Reference → Input → Do → Output 触发 → 执行依据 → 本次输入 → 实际动作 → 可核验结果 ``` ## 五个环节分别回答什么 | 环节 | 必须回答 | 常见承载方式 | | ------------ | ------------------ | ----------------------------- | | Cue：触发 | 谁在什么事件或时间点让员工开始？ | 对话、Taskboard、计划任务、Webhook、邮件 | | Reference：依据 | 员工遵守什么规则、口径和流程？ | Skill、知识库、业务文档、WebSkill、数据结构 | | Input：输入 | 本次实际收到哪些字段、文件和上下文？ | 文本、任务字段、邮件、事件 payload、业务记录、身份 | | Do：执行 | 员工通过什么能力完成动作？ | 已授权系统连接、浏览器、桌面、业务数据、应用开发 | | Output：输出 | 最终结果在哪里，谁能看到，如何核对？ | 任务进展、数据回写、文件成果、消息、应用、网页状态 | **Reference 与 Input 不同。** 交期计算规则是依据；某笔订单的日期是本次输入。**Cue 与 Do 不同。** 每天早上是触发条件，读取业务台账才是执行动作。Calendar Sources 为计划任务提供工作日、节假日或排班上下文；WebSkill 属于浏览器执行流程的复用经验。 ## 示例：每日经营简报 这是用于设计方案的示例，需接入企业真实数据并试跑后验收。 | 环节 | 本场景的填写结果 | | --------- | ------------------------- | | Cue | 工作日早上由计划任务触发，首次验收先人工执行 | | Reference | 简报 Skill、指标口径、异常判定规则 | | Input | 当前团队授权的销售、订单、回款和异常任务记录 | | Do | 查询并核对业务数据，生成简报，按规则创建异常任务 | | Output | 负责人可打开的内部简报、可追踪的异常任务与送达证据 | 如果业务记录尚不可访问，不能把“自动理解所有经营情况”写成 Input。如果简报已生成但未送达，只能记录生成成功，不能认定完整闭环通过。完整方案见[经营分析](https://docs.danqiuos.com/scenarios/operations.md)。 ## 可复制的场景卡 ```text 场景名称 / 业务目标： 服务对象 / 目标 Team： Cue（谁、何时、从哪里启动）： Reference（规则、Skill、资料与版本）： Input（实际可读取的字段、文件与身份）： Do（所需能力、动作和人工确认点）： Output（结果落点、接收人和证据）： 依赖能力与准备负责人： 当前状态（待验证 / 试点 / 已完成本场景验收）： 最小验证路径： 不做范围： ``` 状态是方案记录方式，不代表平台提供同名状态字段。填写时标出尚未验证的依赖，避免把可选能力写成承诺。 ## 从场景卡进入装配 1. 用业务样例检查五个环节是否都有实际对象和负责人。 2. 按[Team 方案设计](https://docs.danqiuos.com/build/team-design.md)确定岗位、协作者和资源范围。 3. 用[工具集速查](https://docs.danqiuos.com/reference/overview.md)选择最小能力组合，补齐连接与授权。 4. 为每个 Output 写[验收用例](https://docs.danqiuos.com/operations/acceptance.md)，包含失败与权限不足路径。 同一业务目标可以由单个员工完成，也可以通过任务接力。不以工具数量或员工数量代替业务闭环质量。 --- url: https://docs.danqiuos.com/build/team-design.md --- > 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. # Team 内方案设计 数字员工在具体 Team 内工作。成员、数据、设备、Secret、知识、计划任务与业务系统都需要围绕该团队确定访问范围。企业专属装配版提供这些共同能力，FDE 将它们装配成可运行的业务方案。 ## 先业务，再岗位，再能力 1. **业务闭环：** 用[CRIDO](https://docs.danqiuos.com/build/crido.md)写清触发到结果的完整路径。 2. **服务对象：** 谁发起、谁接收成果、谁处理异常。 3. **岗位责任：** 每个员工承担一个清晰的岗位结果，必要时才拆分。 4. **能力组合：** 为这个结果选择工具集、连接、知识与数据授权。 5. **验证路径：** 使用真实参与者身份检查整个流程和成果访问。 不要先把所有能力都开给员工，再让它自行判断能做什么。具体岗位写法见[定义数字员工岗位](https://docs.danqiuos.com/build/employee.md)。 ## 员工设计卡 | 项目 | 填写要求 | | ----------------------- | -------------------- | | 名称与职责 | 使用业务岗位名，说明应交付什么结果 | | 服务对象与不做范围 | 哪些成员或角色可使用；哪些决策交给人 | | Cue / Reference / Input | 工作入口、执行依据、实际输入及权限上下文 | | Do / Output | 能力、关键动作、确认点与结果落点 | | 协作与汇报 | 交给谁、交付哪些上下文、如何追踪结果 | | 能力状态 | 已在类似场景使用，还是需要本次先试点验证 | 岗位卡之外，还要配置[技能](https://docs.danqiuos.com/build/skills.md)、工具和资源授权；一张描述完整的卡片不等于装配已经完成。 ## 团队资源准备表 | 资源 | 方案中必须确认 | | --------------- | ------------------- | | 成员、角色与员工 | 谁配置、谁使用、谁确认异常 | | 工作区与任务项目 | 任务放在哪里，谁查看内容，谁提交成果 | | 数据与知识库 | 来源、结构、更新责任，读取和修改范围 | | 计划任务、Webhook、邮箱 | 触发条件、目标员工、输入契约、运行证据 | | 系统连接与 MCP | 授权身份、具体业务动作、失效维护人 | | 设备、Secret 与内网服务 | 可用设备和网络、凭据引用、失败恢复 | | 浏览器与 WebSkill | 登录状态、网页流程、复用与维护方式 | | Workbench | 是否需要应用、所选能力、使用者与维护人 | 各资源只配置本场景所需部分。首次交付可以从单个场景、单个员工和一份可核对的数据开始。 ## 选择工作区和成果落点 个人工作区用于本人资料；团队工作区承接多人协作。内容查看范围和成果提交范围应分别确认。能调用员工不代表能查看它处理过的全部资料，管理员能配置权限也不等于能阅读他人的私人内容。 至少使用发起人、协作者和未授权成员三种实际身份验证：前两者能完成各自工作，后者不能读取受限成果。计划任务和员工之间的交接需单独试跑。详见[工作区与成果](https://docs.danqiuos.com/platform/workspaces.md)。 ## 交付四份设计材料 - **场景 CRIDO 表：** 从业务问题到输出证据。 - **员工设计卡：** 职责、输入、边界与协作。 - **能力组合表：** 所选工具集、连接和资源，以及准备负责人。 - **最小验证用例：** 环境、参与者、步骤、观察结果与未通过项。 在[装配与交付](https://docs.danqiuos.com/build/delivery.md)中记录最终配置和验收结果。尚未跑通的依赖保留为试点项，不因工具已列在目录中就标记业务可交付。 --- url: https://docs.danqiuos.com/build/employee.md --- > 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. # 定义数字员工岗位 岗位定义说明数字员工为谁工作、负责什么、如何协作，以及哪些事项必须交给人。它决定员工在业务中的责任边界。 ## 一张岗位卡需要什么 | 项目 | 示例：经营分析助手 | | ---- | -------------------- | | 服务对象 | 企业管理层与获授权的业务负责人 | | 核心职责 | 汇总经营信息、识别异常、整理建议 | | 不做范围 | 不承诺价格，不审批付款，不自动对客户外发 | | 输入 | 指定业务台账、统计口径、时间范围 | | 产出 | 带来源依据的简报与待跟进清单 | | 人工节点 | 关键结论复核、外发确认、权限不足处理 | 只有岗位需要跨职责协作时，再设计汇报线和委派关系。不要把销售、履约、财务和内容发布全部交给一个没有边界的员工。 ## 区分三类配置 - **promptSpec：** 常驻的身份、风格、权限边界、红线与技能路由。 - **skillset：** 岗位要执行哪些具体业务方法。 - **toolkitKeys：** 岗位可以调用哪些工具能力。 这些配置需要与实际部署目录核对。不要把本文中的概念示例当成可直接提交的 API 请求体。 ## 编写常驻规则 规则至少覆盖身份、服务对象、执行原则、红线与技能路由。示例： ```text 岗位：经营分析助手。 服务对象：当前团队中获授权的管理人员。 执行原则：使用已授权业务台账；结论注明来源；缺失数据明确说明。 红线：不修改付款状态；不擅自对外发送；不扩大数据访问范围。 路由：收到经营情况、简报或周报任务时，使用对应经营简报技能。 ``` 详细字段、计算与异常规则放在 Skill 中，避免把所有任务步骤混进常驻身份说明。 ## 进入目标团队 模板进入团队后，还要检查数据权限、技能绑定、工具授权、协作对象和接收人。能出现在员工花名册中，只代表员工实例存在，不代表业务已经装配完成。 ## 验证岗位边界 分别测试岗位内任务、信息不足任务、越权请求和跨岗位任务。检查员工能否执行职责内工作，在信息不足时明确提问，并把需要人确认的事项交给正确负责人。 下一步：[编写岗位技能](https://docs.danqiuos.com/build/skills.md)。 ## 把岗位卡接回场景 补齐每个岗位的 Cue、Reference、Input、Do、Output，以及能力当前是否已通过场景验证。由[Team 方案设计](https://docs.danqiuos.com/build/team-design.md)统一记录成员、设备、Secret、数据、知识和工作区依赖。技能决定怎么做，工具集决定有哪些动作；使用[能力速查](https://docs.danqiuos.com/reference/overview.md)核对精确标识，避免把业务岗位默认配置成管理员。 --- url: https://docs.danqiuos.com/build/skills.md --- > 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. # 编写岗位技能 Skill 是数字员工完成一类工作的执行方法。有效技能应让另一个实施人员或员工也能理解何时触发、如何操作、何时停下以及如何证明完成。 ## 一个技能只负责一类结果 “经营简报”可以负责读取数据、汇总变化、形成简报。客户建档、报价、订单交接和催款属于不同业务动作，宜按职责拆分。 技能描述应覆盖真实业务表达。例如“老板询问经营状况、经营简报或周报时使用”，比“综合经营智能能力”更容易触发。 ## 推荐结构 | 部分 | 必须讲清楚的内容 | | ----- | ---------------- | | 触发场景 | 典型请求与不适用情况 | | 前置条件 | 当前身份、权限、必需数据 | | 输入与输出 | 字段、时间范围、交付格式 | | 工作步骤 | 数据来源、工具、判断规则与回写 | | 人工确认 | 停顿条件、确认人和后续动作 | | 错误处理 | 数据缺失、权限失败、外部系统异常 | | 验收样例 | 正常、异常、权限和确认用例 | ## 示例：经营简报技能骨架 下面是编写结构示例，不是已经绑定真实数据表的可直接上线技能。 ```markdown # 经营简报 ## 何时使用 用户要求查看指定时间范围的经营情况，或简报任务被触发时。 ## 前置条件 确认请求人权限、统计时间与数据来源；缺少必要项时询问，不猜测。 ## 工作步骤 1. 读取已授权台账，按企业确认的统计口径汇总。 2. 核对数据完整性，标记缺失项与口径冲突。 3. 整理经营变化、异常事项、来源依据和跟进建议。 4. 生成内部简报，回写约定的交付位置。 ## 边界 不修改原始交易记录；对外发送必须取得明确确认。 ## 验收 汇总值与样例台账一致；结论可追溯；缺失数据被明确标注。 ``` ## 绑定与调试 技能写好后，需要绑定到岗位使用的 skillset，并授予与工作步骤匹配的工具和数据权限。仅上传文件，不代表员工已经能使用。 用不同话术测试同一任务，再测试相近但不应触发的请求。出现误触发时，先检查职责重叠、描述和常驻路由，再调整文本长度。 ## 版本与复用 业务字段、状态枚举、计算口径或外部系统发生变化时，应同步更新技能并重跑用例。复用时保留通用方法，将企业数据映射和授权范围作为需要核对的配置，避免把旧企业的标识带入新环境。 相关文档：[数据与权限](https://docs.danqiuos.com/build/data.md)、[装配交付](https://docs.danqiuos.com/build/delivery.md)。 ## 将 CRIDO 写进执行方法 [CRIDO](https://docs.danqiuos.com/build/crido.md)中的 Reference 包括本 Skill、规则文档和网页操作经验；Input 是本次收到的字段、文件和身份。步骤中应明确先查哪些依据，再用哪些工具处理哪些输入，最后将结果交付到哪里。 密钥、密码或 token 不写入技能。需要登录或访问私有服务时，说明应引用哪个用途的团队 Secret，并验证账号和资源范围。工具集标识与调用能力见[能力速查](https://docs.danqiuos.com/reference/overview.md)。 --- url: https://docs.danqiuos.com/build/data.md --- > 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. # 设计数据与权限 数据地基是业务契约：除了存放记录，还需要确定字段含义、状态口径、读写责任、数据可见性与确认节点。 ## 先判断是否需要业务台账 | 需求 | 可考虑的承载方式 | | -------------- | ----------------- | | 少量稳定事实、偏好或工作经验 | 记忆 | | 手册、政策、说明和流程资料 | 知识库 | | 多员工共享客户、订单等对象 | Arcubase 等结构化业务数据 | | 定时巡检、派生指标、状态回写 | 有明确字段和权限的结构化台账 | 既有系统是业务真值来源时，先确认应直接接入还是同步到台账，不要无意间建立另一份相互矛盾的账本。 ## 明确业务对象与字段 以订单协同为例，可先列出订单、客户、应收记录与负责人。每个字段写清名称、稳定标识、类型、来源、可空条件和修改责任。 | 字段示例 | 含义 | 关键规则 | | ---- | ---------- | ------------ | | 订单编号 | 对应一笔业务订单 | 唯一且可回到原始来源 | | 约定交期 | 企业与客户确认的日期 | 变更需要来源依据 | | 履约状态 | 当前业务阶段 | 使用明确的状态集合 | | 负责人 | 需要处理该事项的人 | 必须可解析到真实协作对象 | 这些是概念示例，具体字段 key 和表标识应从企业最终结构回读，不按示例名称猜测。 ## 建立读写权责矩阵 | 角色 | 读取 | 写入 | 人工确认 | | ---- | -------- | --------- | --------- | | 履约助手 | 授权订单与进度 | 巡检结果、风险建议 | 交期承诺、例外放行 | | 销售人员 | 负责的客户与订单 | 跟进记录 | 对客户发送承诺 | | 财务人员 | 授权应收与回款 | 核实后的回款记录 | 账务处理按企业流程 | 字段允许写入不意味着任何场景都可以写。技能还需要说明写入时机、证据和冲突处理方式。 ## 选择新建还是复用 在创建或修改应用前，确认是新建专属应用、复用已有应用，还是扩展共享应用。复用时先回读表结构与权限；扩展共享表前评估对既有员工和应用的影响。 ## 验证真值与权限 用获授权和未获授权的身份分别验证可见范围。执行写入后，独立回读记录检查字段与状态；员工回复“已更新”不能作为数据已经改变的证据。 更多能力见[Arcubase](https://docs.danqiuos.com/platform/arcubase.md)与[组织权限](https://docs.danqiuos.com/platform/security.md)。 ## 区分资料、原文与索引 执行依据不等于操作对象：交期规则属于 Reference，订单记录属于业务数据。知识库中的查看、修改和索引维护应分别授权；资料已同步，不代表语义检索已可用。业务对象关系复杂到表和文档无法稳定表达时，再评估本体建模，无需每个场景都从本体开始。 [数据与知识工具](https://docs.danqiuos.com/reference/data.md)区分使用类与管理类能力。准备阶段确认索引状态，验收时检查引用、更新后检索、原文修改权限和未授权访问。 --- url: https://docs.danqiuos.com/build/workbench.md --- > 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. # 开发 Workbench 应用 Workbench 为企业场景提供固定入口和持续维护的页面。它适合列表、筛选、表单、任务处理和多人反复使用的业务操作。一次性报告或低频操作可以先用现有界面；临时结构化确认可用 [A2UI](https://docs.danqiuos.com/platform/a2ui.md)。 第一次构建完整场景时，从[快速开始](https://docs.danqiuos.com/start/quickstart.md)跟做 CRM 工作台与销售助理；环境准备见[连接 WorkBuddy 或 Codex](https://docs.danqiuos.com/start/connect-ai.md)。 ## 使用官方维护的开发入口 开发团队已将创建、扩展、验收与发布流程统一维护在 [Workbench App Development Skill](https://github.com/syngy-ai/workbench-app-development-skill)。它支持 Codex、Claude Code 和 WorkBuddy。按该仓库首页安装后，开始新会话或重新加载技能，再使用 `workbench-app-development`。 原 `workbench-vibe-coding-flow` 仅保留迁移说明，已不再维护开发步骤。本站说明业务准备与交付要求；执行时阅读官方 [SKILL.md](https://github.com/syngy-ai/workbench-app-development-skill/blob/main/skills/workbench-app-development/SKILL.md) 及其引用的命令契约，避免从多个版本拼接命令。 ## 选择需要的能力 | 业务需求 | 所选 Feature | 判断依据 | | ------------------- | ----------- | ----------------------------- | | 仅需要登录后的应用界面 | 空 | 认证由官方脚手架保留，不因业务 Feature 为空而关闭 | | 团队、成员、员工、会话、文件等平台能力 | `octopus` | 需要调用平台用户 API；仅展示已登录用户不需要额外选择 | | 查询和处理项目、任务 | `taskboard` | 页面要读写真实任务与项目 | | 持久、共享、可查询的业务记录 | `arcubase` | 使用真实数据应用及生成的强类型客户端 | 不是每个应用都需要 Arcubase，本地对象和静态素材不构成创建数据库的理由。使用 Arcubase 时，先明确复用已有应用还是新建：前者核对应用标识、结构和稳定字段 key；后者先确认字段、关系和访问模型。不得静默创建存储或按名称猜标识。 ## 开发前准备 用[CRIDO](https://docs.danqiuos.com/build/crido.md)写清页面的业务入口、规则、输入、动作和结果，再确定： - 当前账号、Profile、Host 与目标 Team。 - 用户查看和操作哪些业务对象，数字员工承担哪部分任务。 - 哪些资源已有，哪些需要创建，谁负责授权和确认。 - 页面清单、正常及失败状态、维护责任人。 创建新应用使用官方 React 脚手架；已有项目先检查当前工程与改动，不覆盖重建。保留 `@syngy/workbench-auth` 和生成的认证访问层，不自行增加另一套 token 存储或登录系统。 ## 本地验证必须接到真实业务 按官方 Skill 启动项目声明的开发服务，完成本地 Workbench 登录。团队范围的资源发现以及外部写入前，都要用 CLI 核对身份和团队；不匹配时先纠正环境。 检查页面展示的数据来自选定后端。确实没有记录时显示真实空状态，不用演示记录冒充接入成功。可见的搜索、筛选、创建和修改控件应实际生效；写入后独立回读记录验证。涉及 Arcubase 的业务数据通过其生成的强类型客户端访问。 本地验收记录应包含本地 URL、所选 Feature、数据应用标识（如有）、已验证账号和团队、操作证据及未解决问题。发布前按官方流程向开发负责人展示结果并取得明确确认。 ## 发布与交付证据 本地验收通过后，按项目声明执行必要检查和生产构建，确认产物再使用 `octopus-cli` 创建或选择 Workbench 项目、发布并跟踪任务。具体命令以官方命令契约与当前 CLI 帮助为准。 | 发布状态或证据 | 应如何判断 | | --------------------------- | ------------------------------ | | `queued` / `processing` | 仍在进行，继续有界地跟踪 | | `failed` | 停止，记录 `errorMessage` 和可执行的处理方法 | | `active` 且返回 `workbenchUrl` | 发布任务成功，继续验证最终页面和业务操作 | | 创建请求结果不确定 | 先查询项目以消除不确定性，不重复创建 | 交付记录保留 `projectId`、`taskId`、`status=active`、`workbenchUrl` 以及已核验的 Profile、Host、Team。Arcubase 的 `appId` 是数据应用标识，不能替代 Workbench 项目或发布任务标识。 ## 应用设置与访问范围 应用信息和访问域名可在应用设置中维护，变更后重新检查真实入口与登录。需要公开页面时明确列出公开路径，并分别验收访客和登录用户：访客可打开指定页面，不代表能读取团队数据或调用受限操作。 第三方凭据由受控配置管理，不写入前端源码或构建产物。最终验收要覆盖直接打开业务路由、刷新、真实数据读写、权限不足、任务交接和公开页隔离。参考[Workbench 场景方案](https://docs.danqiuos.com/scenarios/workbench.md)及[验收标准](https://docs.danqiuos.com/operations/acceptance.md)。 --- url: https://docs.danqiuos.com/build/cli.md --- > 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. # CLI 使用指南 `octopus-cli` 以登录用户的身份在当前团队内操作，适用于批量装配、重复交付和脚本化验收。CLI 与 Portal 使用相同权限边界。 :::info 历史命令基线：0.1.13 本页基础命令来自产品构建指南的 CLI 0.1.13 历史实测记录。新 FDE Toolkit 未重新验证这些全部命令，以下内容不能当作当前版本保证。它不是所有版本的完整 API 参考。使用前通过 `--version` 和对应命令的 `--help` 核对当前版本，避免直接执行不匹配的参数。 ::: ## 安装与登录 ```bash npm install -g @syngy/octopus-cli octopus-cli --version octopus-cli --help ``` 使用企业提供的真实 Portal 地址，完成授权后选择团队： ```bash octopus-cli auth login --web-url https://<企业Portal域名> octopus-cli configure team use octopus-cli auth whoami --json ``` 操作前核对 Profile、主机、账号与团队。交付多个企业环境时，使用独立的命名 Profile，避免将配置写入错误团队。 ## 先预览，再写入 配置命令按对象组织在 `configure` 下。请求体通常通过 `--body-json` 或 `--body-file` 传入；实际字段以当前命令与接口定义为准。 对支持的写操作，先使用全局 `--dryrun` 检查目标接口、团队和请求体。请求体未出现在预览结果中时，不应继续假设写操作会按预期生效。 :::warning 不猜测标识 团队、员工、技能、数据应用和项目标识应从已确认环境回读取得。示例中的占位值不能直接执行；不要按名字推断另一个对象的标识。 ::: ## 常用命令领域 | 领域 | 作用 | | ----------------------------- | -------------------- | | `configure` | 员工、技能、计划任务、集成与知识库等配置 | | `conversation` | 发起会话并获取运行记录 | | `task` | 查询任务状态和活动记录 | | `arcubase` / `arcubase-admin` | 业务数据与应用管理 | | `services` / `ontology` | 企业连接器与业务本体 | | `coding` | Workbench 项目、发布与部署跟踪 | 这是一份使用导览；每个领域的具体子命令应以本机帮助为准。 ## 通过运行记录验收 ```bash octopus-cli conversation send --digi-employee-id --content "<验收输入>" --watch octopus-cli conversation history ``` 除会话外，还应核对任务、真实数据变化和交付物。不要仅依据文本中的“已完成”判断操作成功。 ## 凭据与交接 凭据保留在本地授权配置中，不写进交付脚本或代码库。测试数据与运行证据按企业约定保存。临时交付访问结束后，按约定登出或回收访问权限。 具体应用构建流程见[Workbench 应用开发](https://docs.danqiuos.com/build/workbench.md)，以其指定的官方 Skill 和当前命令契约为准。资料来源及适用范围见[文档基线](https://docs.danqiuos.com/operations/doc-baseline.md)。 ## 0.1.13 记录中的已知限制 以下限制来自同一版本的实测记录，不能只靠命令是否出现在 `--help` 中判断可用： - `configure skill set add` 命令存在，但当时的 dry-run 显示请求体未被转发。手工创建 skillset 使用 Portal；常规装配可使用启用技能装配的流程自动生成。 - 多文件 Skill 包接口要求表单上传，而当时的 CLI 以 JSON 发送。该版本的多文件包应在 Portal 上传。 - 市场包装、权益和资源限制等运营后台配置，不属于用户 CLI 的操作范围。 升级后应重新核对 dry-run 与实际小范围验证结果，不将旧版限制直接视为已修复，也不将它们认定为所有后续版本的现状。 --- url: https://docs.danqiuos.com/build/delivery.md --- > 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. # 装配与交付 装配阶段把已确认的方案配置到目标企业团队。交付完成意味着员工能在授权范围内完成任务，并有可核验的运行结果。 ## 开始前检查 | 设计产物 | 核对重点 | | ------ | ---------------------------------------------------------------- | | 场景模型 | [CRIDO](https://docs.danqiuos.com/build/crido.md) 五个环节、业务目标与不做范围 | | 岗位清单 | 职责、接力与确认人 | | 数据设计 | 应用、表字段、状态口径与读写权限 | | 技能与工具 | 技能自包含，工具授权与职责一致 | | 触发与渠道 | 时间、日历条件、接收人与失败处理 | | 工作区与成果 | 查看范围、提交范围和真实接收人验证 | | 企业执行环境 | 设备、Secret、网络、系统连接与恢复责任 | | 验收用例 | 主流程、异常、权限与人工确认 | 业务负责人和实施负责人应确认这些产物。对真实环境的写入、系统接入和发布，需要明确的操作范围与责任。 ## 按依赖顺序配置 1. 核对当前账号、环境和目标团队。 2. 准备或确认数据应用、表结构和角色权限。 3. 上传与启用岗位 Skill，组合对应 skillset。 4. 准备员工模板，进入目标团队，绑定工具和技能。 5. 配置协作关系、消息接收人与必要的外部连接。 6. 先人工试跑，再配置计划任务和事件触发。 7. 需要场景界面时，接上 Workbench 应用并进行联合验收。 仅配置本场景需要的能力。高权限管理工具不应为了调试方便永久留在业务岗位上。 ## 回读配置与真实结果 检查员工是否进入正确团队、技能是否绑定、工具是否可调用、数据是否可见。配置成功后执行用例，再独立检查任务状态、数据记录、消息送达和交付物。 配置请求没有报错，不等于最终状态符合设计。涉及外部系统时还要检查对应系统的实际结果。 ## 交付清单 - 场景 CRIDO 表、员工设计卡、能力组合表与最小验证用例。 - 员工和岗位职责、技能与授权范围。 - 数据应用、字段口径和读写责任。 - 计划任务、事件入口和接收人。 - 应用地址、项目标识、部署记录与维护人（如有）。 - 验收结论、运行证据、已知限制与遗留问题。 - 凭据与权限回收安排、后续变更流程。 ## 交付后持续维护 业务规则、表结构、系统接口或模型配置变化后，应评估技能和应用受影响的范围。将线上问题变成回归用例，定期复核高权限授权、任务运行和交付质量。 验收标准见[运行质量](https://docs.danqiuos.com/operations/acceptance.md)，问题定位见[故障排查](https://docs.danqiuos.com/operations/troubleshooting.md)。 --- url: https://docs.danqiuos.com/platform/taskboard.md --- > 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. # Taskboard 任务协作 ## 让工作有责任人与结果 Taskboard 是人与数字员工共享的任务协作层。它把目标、执行人、状态、优先级、截止时间、活动记录和交付物放在同一个工作对象中，让团队能够检查工作推进到哪里、为什么阻塞、还需要谁确认。 企业专属装配版可以围绕自己的业务流程配置任务协作。适合进入任务板的工作包括跨岗位交接、等待资料、人工审批、线下动作和持续跟踪。一次性问答可以留在会话中；需要承接责任的工作，应有可追踪的任务对象。 ## 设计任务与交接规则 先写清任务目标和完成条件，再决定执行人。将“处理订单”细化为“核对订单要素、登记交付日期并提交缺项清单”，能让下一位工作者知道接手什么。缺资料时应保留阻塞原因，确认通过后应有继续执行的路径。 任务板可以承接人给数字员工派活、数字员工之间接力，以及数字员工请求人类判断。运行内的短程委派另有汇报线约束，并以被委派员工的权限执行；不应把委派已受理当成任务已完成。 ## 配置项目状态与工作区 任务项目可按业务配置状态和允许的流转。以订单异常为例，可设计「受理 → 处理 → 复核 → 完成」，并允许复核退回处理。每个状态先明确责任人、进入条件和完成证据，再配置允许的转换；不能把所有状态都当成可任意跳转的标签。 按负责人组织的看板可以固定展示指定人员或数字员工，即使暂时没有任务，也能看到岗位分工。固定展示是视图安排，任务是否被处理仍要检查实际指派和活动记录。 开始前，确认项目属于哪个 team 和工作区、参与者能否访问项目、接收人能否打开成果。员工之间的交接和计划任务自动创建的事项需要单独试跑，不能用发起人的成功替代接收人的权限验证。参见 [工作区与成果](https://docs.danqiuos.com/platform/workspaces.md) 和 [Team 方案设计](https://docs.danqiuos.com/build/team-design.md)。 ## 示例：成交后的履约交接 | 环节 | 责任方 | 需要保留的证据 | | ------ | ------ | ------------ | | 提交赢单信息 | 销售助理 | 客户、报价依据、交付要求 | | 核对订单要素 | 履约回款助理 | 完整字段或缺项清单 | | 补充缺失资料 | 业务人员 | 补充结果与确认记录 | | 完成交接 | 履约回款助理 | 订单记录和后续任务 | 订单业务事实保存在 [Arcubase](https://docs.danqiuos.com/platform/arcubase.md)，任务保存责任、活动和结果关联。两者配合后，销售可以看到交接进展，履约岗位也能回到同一订单核对数据。 ## 边界与验收 任务状态不能代替业务真值。员工说“已完成”时，还应查验对应数据写入、文件或确认记录。涉及价格承诺、催款外发等动作，要把授权人的确认作为流程条件。 验收至少覆盖正常完成、资料缺失、非法跳步和人工拒绝四条路径：执行人是否正确，阻塞是否可见，补充信息后是否继续，拒绝后是否停止，完成后是否有可打开的交付物或可核对的数据。再尝试一次项目规则不允许的状态跳转，确认被阻止；检查空任务岗位仍按配置展示。具体检查方法见 [验收](https://docs.danqiuos.com/operations/acceptance.md)，相关工具见 [任务与编排速查](https://docs.danqiuos.com/reference/orchestration.md)。 --- url: https://docs.danqiuos.com/platform/arcubase.md --- > 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. # Arcubase 业务数据 ## 将业务事实变成共享数据 Arcubase 用应用、表、字段和关系承载客户、商机、订单、应收、情报等业务对象。数字员工可以查询、登记、巡检和回写这些数据，人类员工也能围绕同一套业务事实查看与确认。 它适合企业核心系统之外的敏捷流程，也适合从个人表格和聊天记录中建立共享台账。已有 ERP、MES 或 CRM 的企业，可以让主干系统继续承担原有职责，由 Arcubase 承接长尾流程和数字员工协作数据。少量稳定偏好则可先放在 [记忆](https://docs.danqiuos.com/platform/knowledge-memory.md) 中。 ## 先设计对象与写入责任 表结构应围绕业务对象及其生命周期设计。客户与订单应分别记录，通过关系字段连接；状态字段应有明确枚举，金额与日期应使用适合的类型。不要把所有内容堆进长文本，也不要机械复制原有表格。 每张表应明确主写、回写、只读和确认角色。会被多处复用的派生指标，例如逾期天数和交期风险，应定义口径与责任员工，由巡检流程回写，避免多个员工各自计算出不同结果。 ## 示例：订单与应收的数据分工 | 数据对象 | 主写角色 | 其他角色如何使用 | | ----- | ------ | ------------- | | 客户与商机 | 销售助理 | 履约岗位读取客户及成交信息 | | 订单与发货 | 履约回款助理 | 销售查看相关订单进度 | | 应收与回款 | 履约回款助理 | 财务确认，业务管家汇总 | | 经营简报 | 业务管家 | 管理层查看与追溯 | 在新建或复用应用前，先明确目标应用和共享范围。修改已有字段、状态或表结构会影响其他使用者，应检查依赖并确认变更范围。 ## 权限边界与验收 业务数字员工通常需要使用权限，结构和权限管理能力应限制给授权装配角色。数据访问规则与会话中的业务过滤是不同层次：销售归属过滤需要在技能中明确，但不能替代底层权限控制。 验收应直接检查表中真值：新增记录是否在正确表中，关系是否指向正确对象，状态和派生字段是否符合口径。还要用不同角色验证可见范围，并测试权限不足时能否正确停止。关闭或作废优先通过状态留痕，避免删除后丢失业务依据。 --- url: https://docs.danqiuos.com/platform/ontos.md --- > 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. # Ontos 业务本体 ## 理解对象之间的业务关系 Ontos 用于组织客户、订单、合同、库存、工单、供应商和回款等对象之间的关系。数字员工不仅查找某个字段，还能沿关系分析一项变化会影响哪些业务环节，并据此准备处理建议、任务和确认材料。 它适合对象关联紧密、需要跨表追踪影响、多个部门对同一对象口径不一致的场景。若当前需求只是登记客户或汇总订单，先建立清晰的 [Arcubase 数据地基](https://docs.danqiuos.com/platform/arcubase.md) 即可，不必从第一天就构建完整本体。 ## 从一条关键业务链开始 建模前先定义对象是什么、来自哪里、用什么标识，以及状态由谁维护。再定义关系的业务含义，避免只连上数据却说不清关系。例如“供应商提供物料”和“订单消耗物料”是两种关系，对影响分析的作用不同。 每条分析链还应明确可执行动作、负责岗位和人工确认点。发现风险之后，是创建任务、请人补充资料，还是准备客户通知，需要由企业流程决定；关系推理本身不会授予修改业务系统的权限。 ## 示例：供应商延期影响分析 | 追踪环节 | 要回答的问题 | 后续处理 | | ------ | ----------- | ------------ | | 供应商到物料 | 哪些物料可能延期？ | 核对最新供货信息 | | 物料到订单 | 哪些订单依赖这些物料？ | 形成受影响订单清单 | | 订单到客户 | 哪些交付承诺受影响？ | 交给责任人评估方案 | | 订单到应收 | 回款节奏是否需要复核？ | 提交财务和业务负责人确认 | 这是建模示例，具体关系与判断依据需要企业配置。分析结果可进入 [Taskboard](https://docs.danqiuos.com/platform/taskboard.md)，由相关岗位继续跟踪并回写处理结果。 ## 边界与验收 本体不能弥补缺失或过期的源数据。对于没有建立的关系、未核实的日期和无法访问的对象，员工应说明缺口，避免将推测当成确定的影响范围。 验收可选一条已知业务链，人工准备预期受影响对象，与员工结果逐项比对。检查来源标识、关系方向和状态是否正确，越权对象是否被限制，人工拒绝后是否停止后续动作。最后确认任务处理结果能回到对应业务对象，形成可追溯的闭环。 --- url: https://docs.danqiuos.com/platform/knowledge-memory.md --- > 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. # 知识库与记忆 ## 为不同上下文选择合适位置 知识库保存产品资料、制度、SOP、合同模板和培训材料，帮助数字员工按需检索并引用来源。记忆用于沉淀企业事实、工作方法、用户偏好、风险经验和待验证的灵感，让员工不必每次从头了解业务。 两者适合长期服务企业的数字员工，但不应承担所有数据职责。订单金额、应收状态等持续变化的业务事实应进入结构化数据；具体执行步骤应写入技能。清晰的分工有助于定位错误来自资料、数据还是流程。 ## 配置来源与维护责任 知识库应明确资料范围、同步来源、更新责任人和可见范围。检索能力与索引管理能力不同，业务员工按需读取资料，维护派生索引的能力应留给管理角色。回答重要问题时，应给出命中文档、相关依据和更新时间。 记忆也需要来源与边界。用户表达的格式偏好可以记录，但一次任务中的临时假设不应直接变成长期事实。资料更新或用户纠正后，应检查旧记忆是否仍适用，使经验能够被修正。 ## 将资料权限与检索准备分开 一个 team 可按产品、项目或制度等业务范围组织多个知识库。对每个知识库分别确认资料来源、更新方式、查看范围、修改范围和维护人。员工能回答问题，不代表可以修改知识原文；维护索引也不等于修改原文。 | 层次 | 需要确认的条件 | 验证方式 | | ------- | ---------------- | -------------------- | | 查看资料 | 当前员工有目标知识库的读取权限 | 读取一份获授权资料，拒绝读取一份受限资料 | | 修改原文 | 维护角色具有单独的修改授权 | 只读员工修改被拒绝，维护人更新可核对 | | 语义检索与索引 | 已启用检索，资料处理和索引已完成 | 用真实问题命中文档，再核对引用原文 | 已上传或同步不代表已可检索。`kb_query` 用于检索相关资料、引用和反向链接；`kb_index_admin` 维护文档转换结果、反向链接和语义索引，不用于修改知识库原文。使用前还需核对员工启用的工具集与资源授权，见 [数据与知识工具](https://docs.danqiuos.com/reference/data.md)。 上述知识库能力来自当前开发指南；本页的记忆分类是既有装配建议，该指南未给出记忆工具契约或自动更新保证。记忆是否可用、如何维护，应以实际租户能力验证，不能用长期记忆代替原始资料或业务记录。 ## 示例：经营简报的上下文分工 | 内容 | 建议位置 | 使用方式 | | ---------- | -------- | --------- | | 企业指标定义与制度 | 知识库 | 检索并引用对应资料 | | 本月订单与回款 | Arcubase | 读取最新业务记录 | | 负责人偏好的简报结构 | 记忆 | 调整呈现形式 | | 汇总与异常处理步骤 | 技能 | 按流程执行和检查 | | 待验证的指标改进想法 | 灵感记忆 | 标明假设，后续评估 | 这类分工可让企业逐步装配自己的知识体系。资料很多时，先从核心岗位真正需要的文档开始，避免将无维护责任的历史材料全部视为有效依据。 ## 边界与验收 检索到资料不代表资料仍然有效；记忆中的经验也不能覆盖最新业务数据或授权边界。不同资料发生冲突时，应说明差异并交由责任人判断，不应无依据地选一个作为定论。 验收时准备有明确答案的资料问题，检查是否命中正确文档、引用能否支持结论、无资料时是否承认缺口。再由维护人更新一份资料，完成必要的索引处理后，核对检索是否采用新依据；另测只读员工不能修改、未授权员工不能读取。无命中时检查来源、权限和索引状态，不能把检索缺口解释成业务事实不存在。记忆启用时，再修改一项已知偏好，核对后续回答是否采用新依据。涉及客户、订单等实时状态时，还应检查是否真正读取了 [业务数据](https://docs.danqiuos.com/platform/arcubase.md)。 --- url: https://docs.danqiuos.com/platform/integrations.md --- > 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. # 企业连接与集成 ## 让数字员工进入真实业务入口 企业连接层将协作平台、外部系统、资料来源和业务事件接入数字员工的工作流程。当前开发指南覆盖飞书、企业微信、钉钉、微信等外部消息渠道；具体机器人或嵌入方式应以实际租户支持的入口为准。邮件通过入站能力接入。渠道会话与系统业务连接分别配置，参见 [外部消息渠道](https://docs.danqiuos.com/platform/channels.md)。 连接的目的在于完成一个具体闭环：从哪里收到工作、读取什么依据、向哪里回写结果、通知谁。企业可按自身系统和授权条件逐步装配，无需先接完全部系统。 ## 选择连接方式 | 业务条件 | 优先考虑 | 配置重点 | | --------- | ------------- | ------------- | | 已有标准连接器 | 系统集成连接器 | 管理员配置凭据与可用工具 | | 企业已有或自建服务 | MCP | 注册服务并授权所需方法 | | 系统产生状态事件 | Webhook 或邮件入站 | 来源、字段、员工与异常处理 | | 只有网页入口 | 浏览器工作台 | 登录态、页面流程与人工接管 | | 企业资料留在本地 | 资料同步能力 | 同步范围、更新与访问边界 | MCP 让员工发现并调用已授权的服务、工具和资源；系统集成连接器由平台托管凭据与运行器。两种方式都需要验证实际环境中的服务是否可用，不能因为平台具备连接机制，就假定某个企业系统已接通。 ## 从发现能力到真实操作 先确定目标 team、业务系统、连接账号、配置责任人和允许使用的员工，再按目标动作发现能力。系统集成通过 `services_search` 查找团队已连接的服务和工具，通过 `services_execute` 执行；MCP 先用 `mcp_list_servers`、`mcp_list_tools` 发现服务和工具，再使用 `mcp_call_tool`。需要资料时，`mcp_list_resources` 和 `mcp_read_resource` 用于发现与读取资源。 连接后的具体工具、参数和资源以实际发现结果为准。本页不预设某个 CRM、ERP 或数据库已经接通。先让目标员工完成一次真实查询；需要写入时，再执行一次已授权业务操作，并回到目标系统核对记录。连接成功只证明连接条件满足，不能证明所有业务方法均可用。 企业私有服务还需要验证 [设备、网络和 Secret](https://docs.danqiuos.com/platform/enterprise-access.md)，资料同步后的可检索性则要检查 [知识库权限与索引](https://docs.danqiuos.com/platform/knowledge-memory.md)。完整入口见 [能力速查](https://docs.danqiuos.com/reference/overview.md)。 ## 示例：接入一条客户线索 先约定表单或邮件携带的姓名、联系信息、来源和需求，再把事件交给销售助理。员工按 [技能](https://docs.danqiuos.com/build/skills.md) 核对必填信息，在业务台账中建档或提出疑似重复项，并创建后续跟进任务。 设计时同时约定缺字段、来源不可信和连接失败的处理方式。若结果需要发给业务人员，还要单独配置接收人解析、渠道绑定与送达检查；事件触发成功不等于消息已送达。 ## 权限边界与验收 MCP 授权可以细化到方法，员工只应使用完成岗位所需的部分。凭据由受控配置管理，不应写入提示词、普通文档或对话。外部用户能进入聊天，也不意味着已经拥有内部数据访问权。 验收应检查调用的服务与方法、输入、返回结果、业务回写以及通知结果。写操作结果不明确时，不应直接重复调用，以免产生重复记录或业务动作。至少测试一次无权限、缺少绑定或连接失败的路径，并确认能留下可诊断记录。 --- url: https://docs.danqiuos.com/platform/browser.md --- > 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. # 浏览器与 WebSkill ## 在网页业务现场执行任务 浏览器工作台让数字员工进入真实网页系统，执行观察页面、点击、填写、下载和等待等操作。它适合供应商门户、业务后台等没有开放接口或暂时不适合集成的场景。公开网页的正文提取通常可用网页读取；需要登录、表单和页面状态交互时，再使用浏览器。 企业专属装配版需要将浏览器环境、登录身份和岗位职责一起设计。若目标系统已有稳定的连接器或 MCP，应先评估 [结构化连接](https://docs.danqiuos.com/platform/integrations.md)，减少对页面布局的依赖。 ## 配置稳定环境与操作流程 明确员工使用哪个浏览器配置、访问哪些网站、允许读写哪些业务对象，以及登录失效后由谁接管。复杂流程应拆出核对、填写、提交和结果检查等步骤，保留关键页面状态与下载文件。 WebSkill 用于把网站操作经验沉淀为团队可复用工具。成功探索后的操作需要测试和维护，网站改版或账号权限变化后也应重新验证，不能把一次成功当成长期稳定。 ## 前置条件与能力组合 先确认目标 team、执行员工、允许访问的网站与账号，再启用所需浏览器能力。需要凭据时通过 [Secret](https://docs.danqiuos.com/platform/security.md) 引用；依赖用户侧浏览器或私有网络时，先验证 [设备与内网服务](https://docs.danqiuos.com/platform/enterprise-access.md)。`browser_use` 可操作网页、截图、使用登录凭据，并支持人工接管及 WebSkill 的查找、执行和沉淀。 WebSkill 是浏览器能力下的可复用网页操作经验。每条流程应记录目标网站、触发场景、前置登录态、步骤、失效表现和重新沉淀方式。复用前核对页面和账号条件；页面改版或元素不再匹配时，回到真实页面重新验证，不能盲目重复提交。相关工具见 [执行能力速查](https://docs.danqiuos.com/reference/execution.md)。 ## 示例：从门户下载交付资料 | 阶段 | 员工动作 | 核查点 | | ---- | ---------- | ------------ | | 进入门户 | 使用授权的浏览器环境 | 账号与目标企业是否正确 | | 定位订单 | 按订单标识查询 | 页面订单与任务是否一致 | | 下载文件 | 获取指定交付资料 | 文件名称、内容及可打开性 | | 回传结果 | 关联文件并更新任务 | 任务中可追溯到来源 | 当前开发指南已明确云浏览器支持导入 Cookie，可将已有登录态用于云浏览器；也可以直接在目标浏览器完成登录。落地前仍需核对实际租户的入口、权限与可用性。导入后必须打开实际业务页面，确认账号、所属企业、访问范围和登录状态，而不只检查首页是否打开。 登录态由授权人员维护，可能过期。试跑一次重新登录或更新登录态后的恢复路径，并确认恢复后仍处理同一任务对象。不能把导入成功等同于所有业务操作都可用。 ## 边界与验收 浏览器能力不用于绕过验证码、网站风控或二次确认。遇到这类情况，应转为人工接管或明确的确认步骤。清除配置、退出会话与清除既有登录状态也不能混为同一动作，应按环境实际行为核实。 验收需查看执行记录、最终页面状态、下载产物及任务更新，并测试登录失效和目标不存在的情况。涉及提交、发布等高影响动作时，应先展示待操作对象和内容，经授权确认后执行，再核查业务系统中的实际结果。 --- url: https://docs.danqiuos.com/platform/a2ui.md --- > 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. # A2UI 动态交互 ## 把需要操作的信息变成界面 A2UI 让数字员工按当前任务生成声明式界面蓝图，由企业端受信组件渲染。它适合动态表单、审批卡片、方案比较、数据选择和异常处理面板，帮助用户一次看清相关信息并完成操作。 如果用户只是阅读结果，普通回复或文档通常足够；当用户需要补齐多项字段、从多个对象中选择、比较方案或确认动作时，结构化界面能减少反复打字和误解。 ## 先定义操作，再定义界面 设计时先写明用户必须作出的决定，以及决定需要哪些依据。采集表单要明确必填项与字段含义；方案比较要使用一致口径；审批卡片应包含背景、证据、风险、建议动作和可能后果。 A2UI 通过员工承接后续数据读写，因此界面中的按钮需要有清楚的业务含义和处理规则。确认、取消、补充资料等结果应分别对应后续流程，不能让一个模糊的“继续”掩盖实际业务动作。 ## 示例：确认一条催款草稿 | 界面内容 | 目的 | | ------------ | ----------- | | 客户与应收记录 | 确认操作对象 | | 到期日期、未收金额与来源 | 核对催款依据 | | 待发送草稿与接收人 | 让确认人看到完整内容 | | 确认、修改或取消 | 表达明确处理意图 | | 执行结果 | 回传发送与业务记录情况 | 这一界面只组织当前任务的确认过程。客户、应收和消息结果仍需在对应业务数据或任务记录中保留，便于之后追溯。 ## 边界与验收 A2UI 不是让模型任意运行前端代码；企业仍控制组件、主题、权限和审计边界。界面呈现也不构成授权，确认人的身份和权限必须符合业务要求，取消后不得继续执行敏感动作。 验收检查表单字段是否与业务口径一致，选择对象是否正确，确认后是否发生约定的数据变化，拒绝或缺项时是否停止。需要固定地址、多人反复使用或常驻看板的场景，应考虑 [Workbench](https://docs.danqiuos.com/platform/workbench.md)；一次会话内的临时采集与确认更适合 A2UI。 --- url: https://docs.danqiuos.com/platform/workbench.md --- > 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. # Workbench 场景工作台 ## 给业务一个可反复打开的入口 Workbench 是团队托管的 Web 应用层，适合固定流程、多人协作、看板、控制台和现场投屏。企业可以围绕自己的业务装配或开发应用，让人类在界面中操作，让数字员工承接后台工作。 应用与数字员工共享业务数据、任务对象和组织上下文。人在界面上登记信息，员工可以读取并处理；员工回写业务结果后，应用再展示对应状态。这个闭环需要开发者明确设计数据和交接规则。 ## 选择交互形态与构建路径 | 需求 | 适合方式 | 使用特点 | | ----------- | ----------------- | ----------------- | | 当前会话临时采集或确认 | A2UI | 由员工按任务生成界面 | | 固定入口与持续业务流程 | Workbench | 构建并发布常驻应用 | | 业务人员驱动的小应用 | 员工 Vibe Coding 路径 | 需授予相应构建能力 | | 需要持续开发维护的应用 | 开发者本地构建路径 | 使用官方脚手架、SDK 与发布工具 | 开发者路径提供 React 脚手架和认证支持，可按需要选择平台对象、Taskboard 与 Arcubase 能力。涉及业务数据时，应明确目标应用并生成对应类型，避免猜测字段和标识。详细流程见 [构建 Workbench](https://docs.danqiuos.com/build/workbench.md)。 ## 官方开发入口与能力选择 创建、扩展和发布应用统一使用 [Workbench App Development Skill](https://github.com/syngy-ai/workbench-app-development-skill)，具体命令、验收和排错以仓库中的 [SKILL.md](https://github.com/syngy-ai/workbench-app-development-skill/blob/main/skills/workbench-app-development/SKILL.md) 及引用文档为准。它支持 Codex、Claude Code 和 WorkBuddy；这里说明团队业务准备，不另造一套发布命令。 开发前确认目标 team、账号、使用者、业务对象、数据来源和维护人。需要团队、成员、员工、会话或文件时选择 Octopus 客户端；处理任务和项目时选择 Taskboard 客户端；需要持久化业务记录时选择 Arcubase 及生成的强类型客户端。不是每个应用都必须接入 Arcubase；使用已有应用时先核对结构，新建时先确定字段、关系和访问范围。 已有应用先检查现状，新应用使用官方脚手架。接入选定的真实数据后，本地验证登录、页面和业务操作；向交付负责人展示本地结果并确认后再构建、发布。发布任务的发起与完成分别记录，最终还要在发布地址重验业务闭环。 ## 示例：销售跟进工作台 工作台展示客户、商机和待跟进任务，业务人员选择目标并补充跟进信息。销售助理读取同一组数据、检查必填字段、更新商机状态并创建后续任务；管理人员查看汇总与异常。 设计前应明确四件事：用户反复查看和操作什么，应用读写哪些表，哪位员工承接任务，以及谁长期维护应用。表与任务都应使用同一业务标识，避免界面和员工各自保存一份状态。 ## 权限、发布与验收 应用默认需要登录，使用平台账号体系。应用设置可维护应用信息与访问域名，修改后应重新打开实际业务页面并验证登录流程。可以明确指定公开页面，例如活动入口；公开页面可访问，不代表访客能访问团队数据或执行受限操作。公开页和登录后的业务页面应分别设计与验收。第三方密钥通过团队受控配置绑定，不写进源代码或构建产物；SDK 中存在方法也不代表当前用户有调用权限。 发布是异步过程，提交构建产物后仍需确认部署已生效。验收应核对用户身份、数据读写、任务交接、权限失败与最终应用地址，同时验证界面显示与业务表一致。验收中应直接打开并刷新业务路由，确认登录后回到目标页面；搜索、筛选、创建和修改必须真实生效，写入后可重新查询。页面应展示真实记录或真实空状态，不能用演示数据冒充接入结果。另用访客测试指定公开页可打开、受保护页和团队数据不可访问。 交付记录保留目标 team、选用能力、本地验收结果、项目与发布任务标识、最终地址及发布后验证结果。企业获得的是可开发和托管场景应用的底座，具体功能、数据与维护责任需随项目确定。参见 [Workbench 示例方案](https://docs.danqiuos.com/scenarios/workbench.md)、[执行与应用工具](https://docs.danqiuos.com/reference/execution.md) 和 [文档依据与边界](https://docs.danqiuos.com/operations/doc-baseline.md)。 --- url: https://docs.danqiuos.com/platform/triggers.md --- > 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. # 计划任务与事件触发 ## 让工作按时间或事件开始 数字员工除了响应对话，也可以由计划任务、Webhook 和邮件入站等入口启动工作。计划任务适合每日简报、周期巡检和定期提醒；事件触发适合表单提交、业务状态变化或客户邮件到达后的处理。 触发机制只负责启动工作。完整方案还需要指定执行员工、技能、数据来源、输出位置和失败处理。企业可以围绕自己的节奏装配这些流程，不应将“已保存触发配置”当成业务已自动完成。 ## 写清时间与事件契约 | 配置项 | 需要回答的问题 | | ---- | ------------------ | | 触发条件 | 按什么频率、时区或事件启动？ | | 执行责任 | 由哪个员工执行哪项技能？ | | 输入条件 | 数据是否已准备好，事件包含什么字段？ | | 输出位置 | 结果写到业务表、任务还是文件？ | | 通知对象 | 如何解析接收人，是否完成渠道绑定？ | | 失败处理 | 谁接收异常，何时可以重试？ | 涉及“今天”“本周”和逾期判断的流程，应先获取目标时区的当前时间。事件入口则应检查来源可信度、字段结构与异常处理规则，避免让不完整输入直接进入敏感操作。 ## 计划任务与 Calendar Sources Calendar Sources 归入计划任务，用节假日、工作日、排班或业务日历上下文决定何时执行，并不是独立的业务执行能力。需要「工作日早上发日报」时，先确认日历来源与时间规则，再绑定目标员工及简报流程。 在 team 内创建计划任务，绑定员工和任务描述，设置时间或日历条件后，先手动执行一次，再验证实际时间触发。`manage_scheduled_tasks` 支持管理计划任务、手动执行和查看运行记录；若选择已有会话承接结果，可用 `list_digiemployee_conversations` 查找目标员工会话。存在前后依赖的工作，要在流程中明确交接条件，并测试前序失败时后序如何处理。 ## Webhook 与邮件入站 Webhook 接收外部事件，需约定来源、字段、目标员工和后续结果。`manage_webhook_endpoints` 管理事件入口；入口能接收事件后，还要验证员工读取了哪些字段、执行了什么业务动作。 邮件入站应确认入口地址、路由、正文和附件的处理方式。`manage_email_ingress_addresses` 管理接收邮件并触发处理的邮箱入口，不能据此推断它也能对外发送邮件。出站邮件或其他渠道通知，需要另行确认已授权的发送能力、收件人和实际送达结果。 用一封真实测试邮件或一条测试事件贯穿入口、解析、任务或数据写回及成果交付；附件要由实际接收人打开检查。缺字段、附件不可读、路由错误或重复事件应进入约定的异常处理，避免重复创建记录。工具边界见 [任务与编排](https://docs.danqiuos.com/reference/orchestration.md)。 ## 示例：每日经营简报 先由销售与履约岗位完成业务巡检，更新停滞天数、交期风险和应收状态，再由业务管家读取这些字段生成简报。这里的顺序需要在方案中明确，不能假设两个独立计划天然存在依赖关系。 生成后，将简报归档并通过配置的渠道发送给已绑定的负责人。若接收人无法解析或消息发送失败，应记录未触达情况；员工不能仅凭报告已生成就声称负责人已收到。 ## 边界与验收 计划任务与消息投递是两种能力，Webhook 也只是入口，不等于完整业务流程。对外发送或高风险写入仍需遵循 [人工确认与权限](https://docs.danqiuos.com/platform/security.md) 规则。 上线前必须试跑，检查真实触发时间、执行记录、数据变化、生成内容和送达结果。再测试缺字段、权限不足和接收人未绑定的情况，确认异常可见。重试前应核查上次动作是否已生效，尤其是记录新增与消息发送，避免把结果未知直接当成执行失败。 --- url: https://docs.danqiuos.com/platform/security.md --- > 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. # 身份、权限与审计 ## 把责任边界写进方案 数字员工进入真实业务前，需要明确谁触发、以什么身份执行、能访问哪些数据，以及哪些动作由谁决定。人类成员、数字员工、外部用户、管理员和服务账号承担不同职责，不能因为处于同一会话就共享权限。 安全设计贯穿岗位、技能、工具、数据和验收。企业应按照完成工作所需的最小范围授权，并给高风险动作设置明确的人类确认点，而不是在上线后依靠口头提醒补救。 ## 区分权限控制与业务过滤 | 层次 | 设计内容 | 示例 | | ----- | ----------- | -------------- | | 工具授权 | 员工可用的工具和方法 | 读取订单不附带管理表结构能力 | | 数据访问 | 账号和角色能访问的资源 | 业务员工仅使用相关应用 | | 对话可见性 | 按当前用户过滤业务结果 | 销售只看到本人归属客户 | | 人工确认 | 敏感动作的决策责任 | 财务确认催款外发 | | 审计证据 | 动作与责任的追踪依据 | 记录调用、确认与最终结果 | 会话中的过滤规则不能替代底层访问权限。普通业务员工不应默认拥有组织管理、系统管理或数据结构管理能力，装配期所需的高权限也应按交付安排复核。 ## Team、工作区与管理权限 方案的运行边界是 team：员工、成员、设备、Secret、知识、计划任务和业务系统都应放回对应团队配置中核对。能使用某位员工，不代表能查看它处理过的全部资料。个人工作区用于本人资料与成果；团队工作区分别配置内容查看范围和成果提交范围。 管理员能维护权限和员工配置，不代表能查看其他人的私人内容。不要以管理员账号通过的测试替代真实参与者测试。使用发起人、协作者和未授权成员分别检查任务、成果和业务资源；定时执行以及员工交接也要验证执行身份。详见 [工作区与成果](https://docs.danqiuos.com/platform/workspaces.md) 与 [管理能力速查](https://docs.danqiuos.com/reference/administration.md)。 ## 外部身份与凭据使用 外部用户通过微信、企微或飞书进入会话时，不能仅凭昵称或自报身份放行业务查询。应检查渠道用户与内部成员或客户档案的绑定关系；没有绑定时，只处理允许公开的信息并引导完成既定绑定流程。 当前开发指南未给出独立身份核验工具契约，不能用假定存在的核验工具替代真实绑定流程。外部系统凭据由 team 内授权成员配置到 Secret / 保险箱，员工通过能力引用，不把账号、密码、token 或私钥写入 skill、文档正文、对话或代码。`team_vault_catalog` 仅查询可用凭据的名称和用途，不返回真实秘密值。 验证时，先确认员工可发现所需凭据，再通过获授权能力完成一次真实操作并核对结果；不要以打印秘密值作为验收方式。缺少授权、凭据失效时，应停止对应动作并交给配置责任人处理。MCP 调用也应按所需方法授权，具体执行组合见 [企业环境访问](https://docs.danqiuos.com/platform/enterprise-access.md)。 ## 验收越权与拒绝路径 除正常流程外，应专门测试外部用户未绑定、用户查询他人数据、工具权限不足以及确认被拒绝的情况。期待结果是正确限制访问、说明原因并保留处理记录，而不是尝试绕开限制。 价格承诺、合同动作、对外发布、敏感通知和财务例外需要展示依据并等待授权人判断。验收应关联触发人、执行员工、工具与数据操作、确认人和最终结果，确认拒绝后动作停止、批准后按已确认内容执行。完整方法见 [验收](https://docs.danqiuos.com/operations/acceptance.md)。 --- url: https://docs.danqiuos.com/platform/workspaces.md --- > 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. # 工作区与成果交付 ## 为任务和成果确定位置 工作区决定任务和成果放在哪里、谁能查看、谁能处理以及谁能提交结果。方案仍以 team 为运行边界，但同一个 team 中的内容并非天然对所有成员开放。企业专属装配时，应将工作区与员工、项目、业务资源一起设计，参见 [Team 方案设计](https://docs.danqiuos.com/build/team-design.md)。 个人工作区用于本人资料与成果，不作为团队共享入口。团队工作区用于多人协作，内容查看范围和成果提交范围需要分别确认。能使用某位数字员工，不代表能查看它处理过的全部资料；管理员能配置权限，也不代表能查看其他人的私人内容。 ## 配置前置条件 | 配置对象 | 需要确定的事项 | | ---- | ----------------------- | | 参与者 | 发起人、执行员工、协作者、成果接收人和维护人 | | 任务位置 | 项目所属工作区，以及处理任务所需的访问权限 | | 内容查看 | 哪些成员能打开任务、附件、页面和成果 | | 成果提交 | 哪些成员或员工可向目标工作区交付结果 | | 业务资源 | 所引用的数据表、知识、外部页面是否另有授权要求 | 工作区可见性不能替代业务系统自身的权限。成果中引用的文件或外部页面，也应由实际接收人打开验证，不能仅以发起人的账号能打开为依据。 ## 从执行结果到可接收成果 先让员工完成一个小任务并生成文件或业务页面，再确认目标工作区和接收范围。启用成果登记能力并获授权后，`register_artifact` 可将文件或外部页面登记为工作区成果。登记后在任务中关联结果，使协作者能从任务找到交付物，并核对文件内容或页面状态。相关工具见 [触发与协作工具](https://docs.danqiuos.com/reference/orchestration.md)。 计划任务和员工间交接要重复这条路径：自动执行时能否读取输入、能否提交到指定位置、下一个员工和最终接收人能否打开成果。对话中出现链接仅是一个交付入口，不等于访问权限已经成立。 ## 结果证据与失败测试 用真实参与者账号验证完整流程：发起人能使用指定员工，执行员工能处理任务并提交成果，协作者能打开任务和结果。保留任务记录、成果入口和接收人访问结果，避免将任务状态当成唯一证据。 再用未授权成员测试受限内容不可查看，用仅有查看权限的角色测试不能越权提交或修改。出现无权访问时，应检查工作区、成果和底层资源各自的授权，交给配置责任人处理，不通过复制私人内容来绕开限制。更多检查见 [身份、权限与审计](https://docs.danqiuos.com/platform/security.md) 与 [验收](https://docs.danqiuos.com/operations/acceptance.md)。 --- url: https://docs.danqiuos.com/platform/enterprise-access.md --- > 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. # 企业环境访问与执行 ## 先确认员工能到达业务现场 企业环境访问解决员工用哪个账号、从什么设备和网络进入业务系统，以及执行结果如何交付的问题。它是企业专属装配底座的一部分，具体设备、私有服务和访问范围由目标 team 配置，不能由平台存在某项能力推断客户系统已接通。 企业系统有可用接口或 MCP 时，先评估 [系统集成](https://docs.danqiuos.com/platform/integrations.md)；主要依赖网页时选择 [浏览器与 WebSkill](https://docs.danqiuos.com/platform/browser.md)；需要桌面软件、较长执行过程或文件环境时，再试跑 `compute_use`。选择依据见 [CRIDO](https://docs.danqiuos.com/build/crido.md)。 ## 设备、凭据与网络的前置条件 | 组成 | 需要确认 | 预期证据 | | ------------ | --------------------- | ----------------- | | Team 设备 | 设备入口、状态、绑定关系、在线要求和责任人 | 目标设备状态可见，实际执行能使用 | | Secret / 保险箱 | 授权成员完成配置，员工能引用所需凭据 | 获授权操作成功，记录不包含秘密值 | | 内网服务 | 服务部署位置、可访问设备或网络、发现入口 | 找到目标服务，并读取预期业务信息 | | 执行环境 | 浏览器或桌面环境适合目标操作 | 业务页面、保存文件或计算结果可核对 | | 交付位置 | 任务、业务表或工作区及接收范围 | 接收人能打开结果或重新查询数据 | 设备可与浏览器、云电脑或内网服务组合。配置时要写清离线或绑定失效会如何呈现，避免把设备管理界面的在线状态当成业务动作已成功。 ## 使用 Secret 而不传播秘密 授权成员在 team 内维护 Secret，员工通过对应能力引用。`team_vault_catalog` 只查询可用凭据的名称和用途，不返回秘密值。账号、密码、token 和私钥不写入 skill、文档正文、对话或交付文件。需要认证的 HTTP 服务可按已启用能力使用 `http_request_with_secret_header`，但仍须核对目标服务和账号的授权范围。 凭据不可用时，由配置责任人修复后重试业务动作；无需展示真实秘密来证明配置成功。权限及失败处理见 [身份、权限与审计](https://docs.danqiuos.com/platform/security.md)。 ## 内网服务的最小闭环 先明确私有服务部署在哪里，以及哪个 team 设备或网络环境能够访问。具备对应能力和权限时，`list_private_services` 用于发现可用私有服务；选择目标后，按实际发现的入口完成一次读取，核对返回的业务对象，再把结果写入任务、报告或业务数据。 发现列表中有服务，不等于已具备所有操作权限。还需分别确认网络可达、凭据有效、目标业务动作可用。写入场景应执行一次授权的样例动作，并回查实际记录。工具职责见 [执行能力速查](https://docs.danqiuos.com/reference/execution.md)。 ## 云电脑先试跑再承诺 `compute_use` 提供桌面计算环境，可启动应用、操作界面、截图和处理文件。它适合复杂文件、本地目录、桌面软件、较长执行或隔离环境需求，也可与设备、Secret 和内网服务组合。 是否适合客户场景需要实际试跑。没有完成从输入、操作到结果交付的闭环前，只把它作为试点执行环境，不承诺具体效果。选择一份真实样例文件，运行目标处理步骤，检查实际保存位置和文件内容，再由接收人打开；仅有截图不构成交付完成。 ## 结果证据与失败测试 至少保留执行员工、设备或环境、目标服务、业务对象及最终结果。分别测试设备离线、网络不可达、凭据失效、权限不足和文件未保存，确认异常能被看到并归给责任人。 恢复后应重新核对账号和目标对象。上次提交结果未知时，先查询业务系统，确认是否已生效再决定重试，避免重复写入。交付判断遵循 [验收](https://docs.danqiuos.com/operations/acceptance.md)，能力口径见 [文档依据与边界](https://docs.danqiuos.com/operations/doc-baseline.md)。 --- url: https://docs.danqiuos.com/platform/channels.md --- > 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. # 外部消息渠道 ## 让员工进入团队日常沟通入口 飞书、企业微信、钉钉、微信等外部渠道可作为用户对话入口。实际可用的接入方式取决于客户环境、账号、租户配置和授权，应先确认对应入口、接收消息的员工及使用者身份。外部消息渠道承接沟通，系统集成承接业务系统操作，两者不能相互替代。 企业可先选一个常用渠道和一位目标员工试点，跑通用户发起、员工读取资料、生成结果、回复原会话的完整路径。需要持续跟踪的事项进入 [任务看板](https://docs.danqiuos.com/platform/taskboard.md)，不让进展只留在聊天中。 ## 身份与资源授权的前置条件 | 前置条件 | 配置时要回答的问题 | | ----- | --------------------- | | 接入方式 | 当前客户环境实际支持哪种入口，谁维护连接？ | | 员工绑定 | 该入口由哪个 team 的哪位员工接收？ | | 用户身份 | 渠道联系人是否已按既定流程确认身份或绑定？ | | 业务访问 | 员工与使用者分别获准访问哪些资料和记录？ | | 回复与文件 | 回复应到哪个会话，接收人能否打开结果文件？ | 不能仅凭昵称、自报身份或能发消息，就授权内部数据访问。绑定完成也不代表可以读取所有业务资源；工作区、数据表和知识库仍要分别验证。未绑定、身份未确认或员工无权读取资料时，先处理相应前置条件。详见 [身份与权限](https://docs.danqiuos.com/platform/security.md)。 ## 输入、处理与回复的最小闭环 从真实渠道发送一条消息，再发送一份测试附件，确认目标员工收到正确的文本和文件。员工依照岗位 skill 处理，在权限范围内查询数据或创建任务，把结果回复到原会话。最后由实际接收人查看回复并打开附件或成果链接，核对内容与输入相符。 外部联系人工具在已启用且获授权时提供独立动作：`list_external_users` 查询联系人，`dispatch_external_user_turn` 向联系人对应会话提交输入并触发员工处理，`send_external_user_message` 经对应渠道发送消息。触发员工处理和直接发送消息的职责不同，发送前要确认对象、内容及授权范围，参见 [任务与编排速查](https://docs.danqiuos.com/reference/orchestration.md)。 邮件入站及 Webhook 属于事件入口，配置和验证见 [计划任务与事件触发](https://docs.danqiuos.com/platform/triggers.md)。邮件入站地址不能视为已具备出站邮件发送能力。 ## 结果证据与失败测试 验收保留真实渠道输入、员工执行记录、回复所在会话、接收人查看结果，以及附件或成果可打开的证据。员工生成了内容、工具返回已受理、或任务标成完成，都不能单独证明消息已送达。 测试绑定未完成、无资料权限、附件不可读、连接失效和发送结果不明确的情况。应返回可处理的缺口，保留未完成状态，并由连接或业务责任人处理。消息结果未知时先核查实际会话，不能盲目重复发送。涉及内部成果的外发，还应检查 [工作区与成果](https://docs.danqiuos.com/platform/workspaces.md) 的访问边界。 --- url: https://docs.danqiuos.com/reference/overview.md --- > 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. # 工具集与能力速查 先用[CRIDO](https://docs.danqiuos.com/build/crido.md)确定工作，再为 Do 环节选择工具。工具集（Toolset）把一组相关工具组织为可配置能力；Tool 是员工实际调用的动作。Skill 规定工作方法，不能代替工具或数据授权。 ## 按你要完成的工作查找 | 工作 | 参考入口 | 典型能力 | | ---------------- | ---------------------------------------------------------------- | -------------------------------- | | 查资料、做报告和视觉素材 | [内容与资料工具](https://docs.danqiuos.com/reference/content.md) | Office、网页搜索/读取、图像和视频 | | 进入业务系统、执行代码或开发应用 | [系统与执行工具](https://docs.danqiuos.com/reference/execution.md) | 浏览器、云电脑、集成、MCP、Shell、Vibe Coding | | 启动、分派、交付和跟踪工作 | [触发与协作工具](https://docs.danqiuos.com/reference/orchestration.md) | 时间、任务、计划、Webhook、渠道消息、成果 | | 查询业务记录、知识与对象关系 | [数据与知识工具](https://docs.danqiuos.com/reference/data.md) | Arcubase、本体、知识库索引 | | 配置员工和团队资源 | [组织与装配工具](https://docs.danqiuos.com/reference/administration.md) | 组织管理、系统管理、初始化 | ## 如何读工具表 每张表列出上游记录中的**精确工具标识、用途与典型场景**。工具名不是可直接在终端执行的命令，也不是完整 HTTP API；参数和子命令须以当前会话发现结果或对应工具帮助为准。 - `feat.*` 是源资料中的工具集标识；不要据此猜测配置请求体。 - 同一 Tool 可属于多个 Toolset。例如 `team_vault_catalog` 被多个执行入口复用，查询目录不返回秘密值。 - 能力可用性同时取决于员工启用的工具集、账号连接、资源授权和部署环境。 - 外部系统与 MCP 的具体工具以连接后的发现结果为准，不计入内置清单。 - 未归入工具集的工具单独列在[协作工具补充](https://docs.danqiuos.com/reference/orchestration.md)，不能把该栏目当作可选择的 Toolset。 ## 文档基线与使用边界 本次速查覆盖开发团队 FDE Toolkit `22cb8dc`（2026-10-28）记录的 **33 个工具集、76 个去重后的内置工具**。这是该提交的文档快照，不是所有企业环境默认开放的数量，也不代表本次已对这些工具执行运行认证。 本文不展开参数契约，不猜测未提供的 API。来源与后续核对方式见[文档版本与适用范围](https://docs.danqiuos.com/operations/doc-baseline.md)。选择能力后，应继续核对[企业环境](https://docs.danqiuos.com/platform/enterprise-access.md)和[验收证据](https://docs.danqiuos.com/operations/acceptance.md)。 --- url: https://docs.danqiuos.com/reference/content.md --- > 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. # 内容与资料工具 查阅资料、制作文档和视觉素材时所需的工具集。 工具表按开发团队资料整理，标识保留原样。参数和实际可用性以当前环境为准；先阅读[工具集使用说明](https://docs.danqiuos.com/reference/overview.md)。 ## Office 套件 工具集：`feat.office_suite`。 用于把业务资料整理成可交付的 Word 文档、Excel 工作簿和 PowerPoint 演示文稿，也可以读取和修改已有文件。适合项目建议书、数据汇总表、经营汇报等需要持续编辑和交付的场景。 | Tool | 能力 | 典型场景 | | ---------------- | ---------------------------- | ----------------- | | `officecli-docx` | 读取、创建、修改和校验 Word 文档。 | 根据客户需求生成项目建议书。 | | `officecli-pptx` | 读取、创建、修改和校验 PowerPoint 演示文稿。 | 将经营分析整理成月度汇报演示文稿。 | | `officecli-xlsx` | 读取、创建、修改和校验 Excel 工作簿。 | 整理销售明细并生成汇总表。 | ## 图像生成 工具集：`feat.image_generation`。 用于从描述或参考图片生成视觉素材，并对已有图片进行调整。适合宣传配图、产品概念图和素材加工；工具集同时提供生成进度查询与取消能力，便于把图片制作接入完整交付流程。 | Tool | 能力 | 典型场景 | | ------------------------------ | ---------------------------------- | ------------------- | | `generate_image` | 根据描述及参考图片发起图片生成任务。 | 生成活动宣传图或产品概念图。 | | `process_image` | 对图片进行去背景、修复、裁剪、扩图、格式转换、缩放、锐化或文字识别。 | 将产品照片去背景并调整为商城所需尺寸。 | | `get_image_generation_task` | 查询图片生成任务状态和结果。 | 查看宣传图是否已生成并获取结果。 | | `watch_image_generation_task` | 等待图片生成完成、失败或取消。 | 等待配图生成后继续排版报告。 | | `cancel_image_generation_task` | 在服务支持取消时取消图片生成任务。 | 用户更换设计方向后取消旧任务。 | ## 图像识别 工具集：`feat.image_recognize`。 用于理解已有图片中的内容，提取文字、对象和指定细节。适合读取设备铭牌、理解业务截图或检查产品照片，识别结果可作为后续查询、整理和处理的输入。 | Tool | 能力 | 典型场景 | | ---------------------- | -------------------- | ----------------- | | `feat.image_recognize` | 识别图片中的文字、物体、场景和指定细节。 | 阅读设备铭牌照片，提取型号和编号。 | ## 视频生成 工具集：`feat.video_generation`。 用于从文字、图片或参考素材制作视频，并管理可复用素材及数字人。适合产品展示、活动宣传和培训短片，覆盖素材准备、发起生成、跟踪进度和获取结果。 | Tool | 能力 | 典型场景 | | --------------------------------- | --------------------- | ------------------ | | `generate_video` | 根据文字、图片或参考素材发起视频生成任务。 | 将产品图片制作成展示短片。 | | `get_video_generation_task` | 查询视频生成任务状态和结果。 | 查看宣传短片是否生成完成。 | | `watch_video_generation_task` | 等待视频生成完成、失败或取消。 | 等待短片完成后交付给市场团队。 | | `cancel_video_generation_task` | 取消视频生成任务。 | 用户取消活动后停止制作宣传视频。 | | `list_video_assets` | 查找可复用的视频生成素材。 | 查找已经登记的品牌或产品素材。 | | `get_video_asset` | 查看指定视频素材的详细信息。 | 确认某份素材是否适合本次视频制作。 | | `list_digital_humans` | 查找可用于视频生成的数字人素材。 | 为培训视频选择数字人讲解形象。 | | `get_digital_human` | 查看指定数字人素材的详细信息。 | 制作前核对所选数字人的信息。 | | `create_video_asset_registration` | 发起视频素材登记流程。 | 将新素材登记为后续可复用的视频资产。 | | `get_video_asset_registration` | 查询素材登记进度和结果。 | 确认新素材是否已完成登记。 | | `cancel_video_asset_registration` | 取消素材登记流程。 | 发现提交了错误素材后取消登记。 | ## 网页搜索 工具集：`feat.web_search`。 用于从互联网查找尚未确定来源的信息。适合行业调研、竞品跟踪和资料搜集；搜索结果提供线索，需要阅读全文时可结合网页读取能力。 | Tool | 能力 | 典型场景 | | ------------ | --------------- | ---------------- | | `web_search` | 搜索互联网信息，返回网页结果。 | 收集竞争对手近期发布的产品信息。 | ## 网页读取 工具集：`feat.web_fetch`。 用于读取已经确定地址的网页或 HTTP 服务内容，支持在需要时引用保险箱凭据。适合阅读政策原文、提取产品说明或查询受认证保护的服务；需要点击、填表等交互时应使用浏览器会话。 | Tool | 能力 | 典型场景 | | --------------------------------- | ----------------------- | ------------------- | | `http_request_with_secret_header` | 使用保险箱凭据访问需要认证的 HTTP 服务。 | 调用需要 API 凭据的订单查询服务。 | | `team_vault_catalog` | 查询可用凭据的名称和用途，不返回秘密值。 | 查找登录供应商后台应使用的凭据。 | | `web_fetch` | 读取公开网页，提取正文和相关链接。 | 阅读指定政策公告并整理重点。 | ## 装配与验证 搜索发现线索后读取原文核对；生成文件后检查可打开性和内容，再交付到授权工作区。图像与视频生成应跟踪实际任务结果，受理或等待结束不能代替成品检查。取消能力按服务实际支持验证。 来源版本及限制见[文档基线](https://docs.danqiuos.com/operations/doc-baseline.md)。 --- url: https://docs.danqiuos.com/reference/execution.md --- > 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. # 系统与执行工具 通过浏览器、桌面、系统接口和代码执行完成业务动作。 工具表按开发团队资料整理，标识保留原样。参数和实际可用性以当前环境为准；先阅读[工具集使用说明](https://docs.danqiuos.com/reference/overview.md)。 ## 浏览器会话 工具集：`feat.browser_use`。 让数字员工进入网页系统，完成查询、下载、填写和提交等业务操作。适合依赖网页后台或需要保留登录态的场景；反复执行的网页流程可以沉淀为 WebSkill，遇到需要人工处理的步骤时可由用户接管。 | Tool | 能力 | 典型场景 | | -------------------- | ----------------------------------------- | ------------------------------ | | `browser_use` | 操作网页、截图、使用登录凭据、支持人工接管，并查找、执行和沉淀 WebSkill。 | 登录供应商后台下载报表，将重复流程沉淀为 WebSkill。 | | `team_vault_catalog` | 查询可用凭据的名称和用途，不返回秘密值。 | 查找登录供应商后台应使用的凭据。 | ## 云电脑会话 工具集：`feat.compute_use`。 提供可操作的桌面计算环境，让员工通过应用界面处理任务和文件。适合需要桌面软件、完整工作环境或较长执行过程的场景，交付时应核对实际保存的文件和操作结果。 | Tool | 能力 | 典型场景 | | ------------- | --------------------------- | --------------------- | | `compute_use` | 使用桌面计算环境，启动应用、操作界面、截图及处理文件。 | 在桌面软件中打开业务文件，完成编辑并保存。 | ## 系统集成 工具集：`feat.services`。 用于通过团队已连接的业务系统查询信息或执行操作。适合 CRM 客户跟进、订单查询等接口驱动的工作，先发现可用服务和工具，再使用已授权账号执行目标动作。 | Tool | 能力 | 典型场景 | | ------------------ | ------------------ | ------------------ | | `services_execute` | 使用已连接账号执行系统集成工具。 | 在 CRM 中创建客户跟进记录。 | | `services_search` | 查找团队已连接的系统集成服务和工具。 | 查找 CRM 是否提供客户搜索能力。 | ## MCP 工具集：`feat.mcp`。 用于发现和调用团队已授权的 MCP 服务，并读取服务提供的资源。适合接入提供 MCP 能力的业务系统；具体能完成哪些工作，取决于所连接服务提供的工具和资源。 | Tool | 能力 | 典型场景 | | -------------------- | -------------------- | ----------------- | | `mcp_list_servers` | 列出当前获授权的 MCP 服务。 | 确认团队已连接哪些业务系统。 | | `mcp_list_tools` | 查看指定 MCP 服务提供的工具。 | 查找项目管理系统是否支持创建工单。 | | `mcp_call_tool` | 调用指定 MCP 服务提供的工具。 | 在已连接的项目系统中创建异常工单。 | | `mcp_list_resources` | 查找 MCP 服务提供的资源和资源模板。 | 查找服务公开的业务资料目录。 | | `mcp_read_resource` | 读取 MCP 服务中的指定资源。 | 读取已发现的产品说明资料。 | ## 飞书 CLI 工具集：`feat.lark_cli`。 用于在授权范围内处理飞书中的日常业务工作。适合围绕消息、文档、表格和日程组织协作，使用前需确认所需账号和业务能力已经授权。 | Tool | 能力 | 典型场景 | | ---------- | --------------- | ------------------- | | `lark-cli` | 在授权范围内执行飞书业务操作。 | 查询会议安排、整理文档或发送工作消息。 | ## Shell 执行 工具集：`feat.shell_exec`。 用于运行命令和脚本、修改文件，以及访问执行环境可用的私有服务。适合批量数据处理、计算和开发辅助，也可为运行中的 Web 服务提供临时预览入口；操作范围受执行环境和资源权限约束。 | Tool | 能力 | 典型场景 | | ------------------------------ | ------------------------ | ------------------- | | `apply_patch` | 通过补丁创建、修改或删除获授权的文件。 | 修改业务应用中的页面代码。 | | `create_runtime_port_exposure` | 为本地 Web 服务创建临时访问地址。 | 将开发中的应用交给用户预览。 | | `exec_command` | 在获授权的环境中运行命令、脚本、计算和构建任务。 | 批量清洗 CSV 数据或构建业务应用。 | | `list_private_services` | 查找团队可访问的内网或私有服务。 | 找到企业内网部署的库存查询服务。 | | `write_stdin` | 向已启动的命令会话发送输入，继续读取输出。 | 跟踪尚未结束的数据处理脚本。 | ## Vibe Coding 工具集：`feat.vibe_coding`。 用于创建、编辑、构建和发布应用项目，并跟踪发布结果。适合将重复的业务操作做成团队可使用的工作台，开发过程应接入所需的真实数据，完成本地验收后再发布。 | Tool | 能力 | 典型场景 | | ---------------------------- | ------------------------ | ------------------- | | `apply_patch` | 通过补丁创建、修改或删除获授权的文件。 | 修改业务应用中的页面代码。 | | `exec_command` | 在获授权的环境中运行命令、脚本、计算和构建任务。 | 批量清洗 CSV 数据或构建业务应用。 | | `team_vault_catalog` | 查询可用凭据的名称和用途，不返回秘密值。 | 查找登录供应商后台应使用的凭据。 | | `write_stdin` | 向已启动的命令会话发送输入，继续读取输出。 | 跟踪尚未结束的数据处理脚本。 | | `vibe_coding.create_project` | 创建应用开发项目，可从模板开始。 | 创建用于订单跟踪的应用项目。 | | `vibe_coding.list_templates` | 查找可用的应用模板。 | 创建业务工作台前选择合适模板。 | | `vibe_coding.publish` | 构建并发布应用项目。 | 将验收通过的业务应用发布给团队使用。 | | `vibe_coding.watch` | 跟踪 Workbench 发布任务并查看结果。 | 确认应用发布完成并获取访问地址。 | Workbench 应用的实际开发、验收和发布步骤，统一参考 [Workbench App Development Skill](https://github.com/syngy-ai/workbench-app-development-skill)。 ## 装配与验证 先核对团队、账号、设备和连接，再执行最小查询或业务动作。浏览器登录成功不代表目标业务操作成功；云电脑进入方案前先试跑。[企业环境访问](https://docs.danqiuos.com/platform/enterprise-access.md)说明准备方式；Workbench 的开发步骤由[官方 Skill 入口](https://docs.danqiuos.com/build/workbench.md)统一维护。 来源版本及限制见[文档基线](https://docs.danqiuos.com/operations/doc-baseline.md)。 --- url: https://docs.danqiuos.com/reference/orchestration.md --- > 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. # 触发与协作工具 管理时间触发、任务接力、交互确认、渠道消息和成果交付。 工具表按开发团队资料整理，标识保留原样。参数和实际可用性以当前环境为准；先阅读[工具集使用说明](https://docs.danqiuos.com/reference/overview.md)。 ## 时间 工具集：`feat.time`。 为涉及日期、时区和截止时间的工作提供当前时间依据。适合处理“今天”“明天”“本周”等相对时间，或核对跨时区业务安排；定时触发工作则由计划任务管理承接。 | Tool | 能力 | 典型场景 | | ------------------ | ------------ | ---------------- | | `get_current_time` | 获取指定时区的当前时间。 | 判断“明天上午”对应的具体日期。 | ## UI 基础 工具集：`feat.ui_base`。 用于在对话中收集用户选择，并展示可交互的业务内容。适合需求确认、信息补充和表单式操作，让需要用户参与的步骤有清晰入口。 | Tool | 能力 | 典型场景 | | -------------- | --------------------- | ------------------- | | `ask_user` | 向用户提出选择题，收集确认或补充信息。 | 开始生成报告前，让用户选择报告周期。 | | `a2ui_surface` | 在对话中展示可交互的表单、卡片和业务界面。 | 展示订单信息表单，让用户补充交付要求。 | ## 计划任务管理 工具集：`feat.schedule_management`。 用于把重复性工作安排为自动执行的计划任务。适合日报、周期巡检和定时跟进，可以选择已有会话作为跟进位置，并查看运行记录、调整时间或暂停执行。 | Tool | 能力 | 典型场景 | | --------------------------------- | ------------------- | ----------------- | | `list_digiemployee_conversations` | 查找指定数字员工的会话。 | 为定时跟进选择已有的客户沟通会话。 | | `manage_scheduled_tasks` | 管理计划任务，手动执行并查看运行记录。 | 每个工作日早上生成经营简报。 | ## Webhook 管理 工具集：`feat.webhook_management`。 用于为数字员工建立接收外部事件和邮件的入口。适合表单提交后跟进、告警处理和订单邮件整理；入口接通后，还需明确处理规则、执行员工和结果交付位置。 | Tool | 能力 | 典型场景 | | --------------------------------- | --------------------- | ----------------- | | `list_digiemployee_conversations` | 查找指定数字员工的会话。 | 为定时跟进选择已有的客户沟通会话。 | | `manage_email_ingress_addresses` | 管理接收邮件并触发处理的邮箱入口。 | 接收供应商报价邮件并整理附件。 | | `manage_webhook_endpoints` | 管理接收外部事件的 Webhook 入口。 | 收到新线索事件后启动客户跟进。 | | `team_vault_catalog` | 查询可用凭据的名称和用途，不返回秘密值。 | 查找登录供应商后台应使用的凭据。 | ## 任务看板 工具集：`feat.taskboard`。 用于将工作组织成可分配、可跟踪的项目和任务，并查询组织成员以确定负责人。适合人和数字员工协作处理异常、推进项目或持续跟进事项，任务状态和活动记录用于反映进展。 | Tool | 能力 | 典型场景 | | ------------------- | ------------------------- | --------------------- | | `organization-view` | 查询成员、部门、角色及归属关系。 | 查找负责销售工作的成员。 | | `taskboard-cli` | 管理项目和任务，完成创建、查询、分派、流转与协作。 | 将巡检发现的订单异常创建为任务并指派处理。 | ## 外部用户消息 工具集：`feat.external_user_tools`。 用于查找团队的外部联系人，并围绕其所在渠道开展沟通。适合客户通知、客服问题转交和后续跟进，可直接发送消息，也可触发数字员工继续处理对应会话。 | Tool | 能力 | 典型场景 | | ----------------------------- | ---------------------- | ------------------- | | `dispatch_external_user_turn` | 向外部联系人对应会话提交输入，触发员工处理。 | 将客服转交的客户问题交给数字员工处理。 | | `list_external_users` | 查询客户、外部联系人和渠道联系人。 | 查找需要接收交付通知的客户。 | | `send_external_user_message` | 通过外部联系人对应的渠道发送消息。 | 向客户发送订单处理进度。 | ## 组织汇报关系 工具集：`feat.organization_reporting`。 用于了解员工的直接汇报关系。适合确定工作应向谁汇报、由哪些直属下级承接；实际委派工作还需要使用数字员工协作工具。 | Tool | 能力 | 典型场景 | | -------------------------- | ------------- | ----------------- | | `list_reporting_neighbors` | 查看员工的上级和直属下级。 | 确定任务应该向谁汇报或交给谁处理。 | ## 成果登记 工具集：`feat.artifact_artifact`。 用于把文件或外部页面正式登记为工作区成果。适合交付报告、表格、演示文稿和业务页面，让有权限的协作者从工作区找到结果，而不只在对话中收到一条回复。 | Tool | 能力 | 典型场景 | | ------------------- | ----------------- | ----------------- | | `register_artifact` | 将文件或外部页面登记为工作区成果。 | 将生成的分析报告交付到项目工作区。 | ## 补充：未归入上述 Toolset 的工具 以下工具未归入上述工具集，本节仅补齐工具清单，不代表一个可选择的 Toolset。具体可用性以当前会话为准。 | Tool | 能力 | 典型场景 | | -------------------------------- | ------------------- | -------------------- | | `open_external_url` | 为用户打开外部页面。 | 打开业务系统的账号授权页面。 | | `update_plan` | 展示和更新任务计划及步骤状态。 | 展示调研、分析、报告撰写的进度。 | | `compact_context` | 压缩较长的对话上下文，支持继续执行。 | 长时间调研后整理已有信息，继续完成报告。 | | `subagent.list_available_agents` | 查找当前可以委派工作的已有数字员工。 | 找到可以协助完成财务分析的员工。 | | `subagent.start` | 将任务委派给符合条件的数字员工。 | 把经营报告中的销售分析交给销售员工。 | | `subagent.watch` | 查看委派任务进展，等待完成并获取结果。 | 等各岗位提交分析结果后汇总报告。 | | `subagent.steer` | 向执行中的委派任务补充指令或纠正方向。 | 要求分析员工补充上季度的对比数据。 | | `subagent.cancel` | 请求停止正在执行的委派任务。 | 用户取消报告后，停止相关分析工作。 | | `read_skill` | 读取可见的技能说明和配套参考文件。 | 处理客户投诉前读取标准作业流程。 | ## 装配与验证 触发成功、员工执行、结果登记与消息送达分别验收。[任务看板](https://docs.danqiuos.com/platform/taskboard.md)承接持续工作；[工作区](https://docs.danqiuos.com/platform/workspaces.md)控制成果访问。补充工具没有可选择的统一工具集，其中已有数字员工的委派应以当前可委派对象和授权范围为准。 来源版本及限制见[文档基线](https://docs.danqiuos.com/operations/doc-baseline.md)。 --- url: https://docs.danqiuos.com/reference/data.md --- > 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. # 数据与知识工具 区分业务数据使用、结构管理、本体查询和知识检索维护。 工具表按开发团队资料整理，标识保留原样。参数和实际可用性以当前环境为准；先阅读[工具集使用说明](https://docs.danqiuos.com/reference/overview.md)。 ## Arcubase 管理 工具集：`feat.arcubase_admin`。 用于搭建和维护结构化业务数据应用，覆盖表结构、仪表盘、访问规则和工作流，也包含日常数据操作能力。适合 FDE 建立客户、订单等业务数据基础，并验证不同岗位的访问范围。 | Tool | 能力 | 典型场景 | | -------------------- | ----------------------------- | --------------------- | | `arcubase-admin-cli` | 管理数据应用、表结构、仪表盘、访问规则和工作流。 | 搭建客户跟进数据应用，并配置岗位访问范围。 | | `arcubase-cli` | 在用户权限内维护业务记录、查看仪表盘、上传文件及处理审批。 | 更新商机进展，查询本月销售数据。 | ## Arcubase 使用 工具集：`feat.arcubase_user`。 用于在已有授权范围内使用业务数据应用。适合查询客户、更新商机、查看统计和处理审批；重点是日常业务操作，应用结构和访问规则由管理工具集维护。 | Tool | 能力 | 典型场景 | | -------------- | ----------------------------- | ---------------- | | `arcubase-cli` | 在用户权限内维护业务记录、查看仪表盘、上传文件及处理审批。 | 更新商机进展，查询本月销售数据。 | ## 本体管理 工具集：`feat.ontology_admin`。 用于建立和维护业务对象及其关系模型。适合客户、订单、物料、供应商等对象存在复杂关联的场景，将业务关系整理为可校验、可发布和持续更新的模型。 | Tool | 能力 | 典型场景 | | ---------------- | ------------------------ | ---------------------- | | `ontology_admin` | 创建、更新、导入、校验和发布业务对象及关系模型。 | 建立客户、订单、物料和供应商之间的关系模型。 | ## 本体使用 工具集：`feat.ontology_use`。 用于读取业务关系模型，查询对象、关联关系和路径。适合分析订单受哪些物料影响、追溯对象之间的联系；使用前需要已有可查询的业务关系模型。 | Tool | 能力 | 典型场景 | | -------------- | ---------------- | ---------------- | | `ontology_use` | 查询业务对象、关系图和关联路径。 | 从延期订单追溯关联物料和供应商。 | ## 知识库索引维护 工具集：`feat.kb_index_admin`。 用于维护知识资料的检索准备工作，包括文档转换结果、反向链接和语义索引。适合资料批量更新后的索引刷新或检索维护，不用于修改知识库原文。 | Tool | 能力 | 典型场景 | | ---------------- | ------------------------ | ---------------- | | `kb_index_admin` | 维护知识库文档转换结果、反向链接和语义检索索引。 | 更新一批产品资料后刷新检索索引。 | ## 知识库索引查询 工具集：`feat.kb_query`。 用于从可访问的知识库中查找相关内容、文档引用和关联资料。适合产品问答、制度查询和项目资料检索；检索效果依赖资料内容及对应索引的准备情况。 | Tool | 能力 | 典型场景 | | ---------- | ------------------------- | ------------------- | | `kb_query` | 检索知识库，查询语义相关资料、反向链接和文档引用。 | 根据客户问题查找产品手册中的对应说明。 | ## 装配与验证 业务岗位优先使用使用类工具集，结构、权限和索引维护交给授权角色。知识库索引维护不修改原文；资料已上传不代表索引完成。操作后独立回读真实记录，并测试未授权身份。 来源版本及限制见[文档基线](https://docs.danqiuos.com/operations/doc-baseline.md)。 --- url: https://docs.danqiuos.com/reference/administration.md --- > 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. # 组织与装配工具 按授权配置团队、成员、数字员工和岗位能力。 工具表按开发团队资料整理，标识保留原样。参数和实际可用性以当前环境为准；先阅读[工具集使用说明](https://docs.danqiuos.com/reference/overview.md)。 ## 团队引导 工具集：`feat.team_bootstrap`。 用于引导用户创建新的协作团队。适合首次使用或新业务小组启动时，由员工发起创建流程，再由用户完成必要确认。 | Tool | 能力 | 典型场景 | | ------------- | ----------------- | ------------- | | `create_team` | 发起团队创建流程，由用户完成确认。 | 为新业务小组创建协作团队。 | ## 系统管理 工具集：`feat.system_admin`。 用于由具备管理权限的人员维护数字员工配置和团队资源。适合技能安装、能力配置和日常管理操作；员工能够执行管理动作，不代表可以访问团队中的所有业务内容。 | Tool | 能力 | 典型场景 | | -------------- | ------------------------ | ------------------- | | `apply_patch` | 通过补丁创建、修改或删除获授权的文件。 | 修改业务应用中的页面代码。 | | `exec_command` | 在获授权的环境中运行命令、脚本、计算和构建任务。 | 批量清洗 CSV 数据或构建业务应用。 | | `system-admin` | 在授权范围内管理数字员工配置和团队资源。 | 为数字员工安装团队需要的技能。 | | `write_stdin` | 向已启动的命令会话发送输入，继续读取输出。 | 跟踪尚未结束的数据处理脚本。 | ## 数字员工初始化 工具集：`feat.digiemployee_init`。 用于记录数字员工入职准备的进度和状态。适合初始化流程中汇报已完成的准备工作，让用户了解员工是否仍在配置阶段。 | Tool | 能力 | 典型场景 | | -------------------- | --------------- | ---------------- | | `update_init_status` | 更新数字员工初始化进度和状态。 | 员工完成入职配置后更新准备状态。 | ## 组织管理 工具集：`feat.organization`。 提供组织信息查询和管理能力，覆盖成员、部门、角色及分配关系。适合同时需要了解组织现状并维护人员安排的管理工作，例如新成员入职和岗位调整。 | Tool | 能力 | 典型场景 | | -------------------- | ------------------- | ------------------ | | `organization-view` | 查询成员、部门、角色及归属关系。 | 查找负责销售工作的成员。 | | `organization-admin` | 管理成员、邀请、部门、角色和分配关系。 | 邀请新同事，并分配到指定部门和岗位。 | ## 组织查看 工具集：`feat.organization_view`。 提供组织信息的只读查询能力。适合查找负责人、确认部门归属和了解成员角色，不需要修改组织信息的员工可使用这一工具集。 | Tool | 能力 | 典型场景 | | ------------------- | ---------------- | ------------ | | `organization-view` | 查询成员、部门、角色及归属关系。 | 查找负责销售工作的成员。 | ## 组织管理操作 工具集：`feat.organization_admin`。 提供组织信息查询及修改能力，支持成员邀请、状态调整、部门和角色维护。适合管理员处理入离职和组织调整，执行变更前可先查询现有成员及关系。 | Tool | 能力 | 典型场景 | | -------------------- | ------------------- | ------------------ | | `organization-view` | 查询成员、部门、角色及归属关系。 | 查找负责销售工作的成员。 | | `organization-admin` | 管理成员、邀请、部门、角色和分配关系。 | 邀请新同事，并分配到指定部门和岗位。 | ## 装配与验证 创建团队由用户完成必要确认。配置能力与业务内容访问是不同权限，管理员也不能因此读取私人内容。按[Team 方案设计](https://docs.danqiuos.com/build/team-design.md)准备资源，装配后复核临时高权限，并用实际岗位身份验证。 来源版本及限制见[文档基线](https://docs.danqiuos.com/operations/doc-baseline.md)。 --- url: https://docs.danqiuos.com/scenarios/operations.md --- > 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. # 经营协同示例方案 > 本页是待按企业实际环境配置与验证的示例设计，不代表已经部署或验收通过的客户成功案例。 ## 场景目标与输入 本页是企业可自主装配的示例方案，用业务管家汇总销售、订单与回款信息，形成每日经营简报，并把异常转为可追踪任务。它适合管理者需要跨岗位掌握经营状态、现有信息分散在台账和聊天中的场景。 输入包括统计周期、销售与订单记录、应收回款数据、指标定义、负责人及消息接收渠道。企业应先统一金额、状态和时间口径，再确定简报频率与展示形式；这不是底座默认交付的固定报表。 ## CRIDO：从触发到结果 按 [CRIDO 场景分析](https://docs.danqiuos.com/build/crido.md) 区分执行依据、当次输入与实际动作，避免把工具清单当成业务闭环。 | 环节 | 本方案设计 | | --------- | --------------------------------------------- | | Cue | team 内计划任务在工作日早上触发；Calendar Sources 提供工作日判断依据 | | Reference | 经营简报 skill、指标定义、异常升级规则和已确认的统计口径 | | Input | 指定周期内客户、商机、订单、应收、回款及任务异常记录 | | Do | 各岗位先完成巡检回写，业务管家再查询汇总、归档简报并按授权创建异常任务和通知 | | Output | 可打开且关联来源的简报、明确责任人的异常任务及实际送达记录 | ## Team、前置条件与能力组合 在同一目标 team 中明确管理者、业务管家、销售与履约岗位，并指定异常的人工负责人。先准备一个统计周期的样例记录、指标文档和至少一项已知异常；确认员工有数据读取或对应字段写入权限，指标资料能检索，项目及简报工作区对接收人可见。 能力组合为计划任务、Calendar Sources、业务数据源、Taskboard、知识库及结果消息渠道。先按 [Team 方案设计](https://docs.danqiuos.com/build/team-design.md) 分配职责，再检查 [工作区](https://docs.danqiuos.com/platform/workspaces.md) 和 [渠道](https://docs.danqiuos.com/platform/channels.md)。计划创建、巡检完成、简报生成和消息送达分别留证；任一前序缺失时说明数据截止时间与缺口。 ## 岗位、技能与数据装配 | 组成 | 示例配置 | | ------ | ------------------- | | 业务管家 | 汇总经营简报、归口异常、派发协调任务 | | 销售助理 | 更新商机停滞与待跟进信息 | | 履约回款助理 | 更新交期风险、应收与回款状态 | | 技能 | 数据巡检、经营汇总、异常处理与消息通知 | | 数据 | 客户、商机、订单、应收、回款及简报归档 | 使用 [Arcubase](https://docs.danqiuos.com/platform/arcubase.md) 保存结构化事实，各岗位按责任回写；指标说明进入知识库，管理者偏好的简报格式可进入记忆。业务管家以读取和汇总为主，避免与各主责岗位重复修改数据。 ## 执行、人工确认与输出 先安排业务巡检，再生成简报。简报可包含销售进展、停滞商机、交付风险、逾期应收和待拍板事项，并关联来源记录。需要协调的事项进入 [Taskboard](https://docs.danqiuos.com/platform/taskboard.md)，注明责任人和完成条件。 对于款到发货例外、价格承诺或敏感客户通知，员工整理背景、金额、影响和建议，由授权负责人确认。输出包括归档简报、异常任务、确认材料以及实际发送结果。确认尚未完成时，应保留待处理状态。 ## 边界与验收 试点可先覆盖一条业务链和一个统计周期，不要求一次接入所有系统。源数据未更新时，应明确统计截止时间和缺口，不能用推测补成完整经营结论。 验收要把简报金额、订单状态和逾期判断与业务表逐项核对；确认任务已交给正确岗位，消息实际送达。异常用例应覆盖数据缺失、接收人未绑定和负责人拒绝确认。验收通过的依据是数据、任务、文件与确认记录，而不是简报文字看起来完整。 --- url: https://docs.danqiuos.com/scenarios/sales.md --- > 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 快速开始](https://docs.danqiuos.com/start/quickstart.md)：用 WorkBuddy 或 Codex 构建工作台与 Arcubase，再配置销售助理从对话录入同一份线索数据。本页在此基础上扩展跟进、报价和赢单交接。 ## 场景目标与输入 本页是销售助理的示例方案，帮助企业把线索、客户资料和跟进过程沉淀到共享数据中，并在成交后移交给履约岗位。适合客户资料分散、跟进容易遗漏、报价与订单交接依赖人工转发的团队。 输入包括线索来源、客户与联系人资料、需求、归属销售、跟进时间和报价依据。线索可来自人工提交或已配置的事件入口；接入方式、所需授权和数据质量应在项目开始时核对，不能假定所有渠道天然可用。 ## CRIDO：从触发到结果 按 [CRIDO 场景分析](https://docs.danqiuos.com/build/crido.md) 区分执行依据、当次输入与实际动作，避免把工具清单当成业务闭环。 | 环节 | 本方案设计 | | --------- | ------------------------------------- | | Cue | team 成员提交线索，或已配置的 Webhook / 邮件入站触发 | | Reference | 客户建档、查重、报价和赢单交接 skill，产品资料及价格审批规则 | | Input | 线索来源、客户与联系人、需求、归属销售、跟进日期及报价依据 | | Do | 查询并核对客户记录，按授权建档和更新商机，生成报价草稿，批准后交接履约任务 | | Output | 客户与跟进记录、报价文件、待跟进清单，以及履约岗位实际接收的任务 | ## Team、前置条件与能力组合 以销售所在 team 为边界，指定销售助理、归属销售、价格审批人和履约接收岗位。准备一条完整线索、一条重复线索和一份缺少负责人信息的样例；先确认客户表、报价依据、任务项目与交付工作区的访问范围，不能依靠对话中的过滤替代数据权限。 能力组合为已授权的系统集成或 Arcubase、Taskboard、知识库和按需启用的 Webhook / 邮件入站；若需要通知外部联系人，再单独验证 [外部渠道](https://docs.danqiuos.com/platform/channels.md)。查看 [企业连接](https://docs.danqiuos.com/platform/integrations.md) 的真实查询与写入要求，并按 [Team 方案设计](https://docs.danqiuos.com/build/team-design.md) 明确每次交接的完成条件。 ## 岗位、技能与数据装配 | 组成 | 示例配置 | | ---- | ------------------- | | 销售助理 | 线索建档、客户查重、跟进记录与商机维护 | | 协作岗位 | 履约回款助理承接成交后的订单要素 | | 技能 | 客户建档、商机跟进、报价管理、赢单交接 | | 主数据 | 客户、联系人、归属销售 | | 业务记录 | 线索、跟进、商机、报价与后续任务 | 表中应明确商机阶段、下次跟进时间和报价有效期。定期巡检可维护停滞天数与待跟进清单，员工按归属销售过滤查询结果。岗位需要的工具与数据权限按最小范围配置，参见 [身份与权限](https://docs.danqiuos.com/platform/security.md)。 ## 执行、人工确认与输出 收到线索后，员工检查必填信息并查找可能重复的客户；资料不完整时请求补充，疑似合并时交由责任人确认。跟进完成后记录结果和下一步动作，按明确规则更新商机状态。 报价由员工整理依据与草稿，价格承诺仍由授权人员确认。赢单后，将客户、成交依据、交付要求等必要信息形成交接任务，由履约岗位核对接收。输出包括客户档案、跟进记录、报价文件、今日应跟清单与真实的交接任务。 ## 边界与验收 客户合并、标记流失和重要商业承诺不能仅靠模型推断。企业需要为这些动作定义人工确认条件，保留原因和依据。员工也不能因为收到一个昵称或自报身份，就向外部用户披露内部客户资料。 验收用例可从一条新线索推进到赢单交接，检查查重、字段回写、商机状态和任务责任人。还应测试重复线索、缺少归属销售、报价未获批准和越权查询。最后由履约岗位实际接收并继续处理，证明交接已发生，而不只是在聊天中宣布完成。 --- url: https://docs.danqiuos.com/scenarios/reimbursement.md --- > 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. # 财务报销示例方案 本方案沿用[快速开始](https://docs.danqiuos.com/start/quickstart.md)的顺序：**先建工作台与数据基座，再装配报销助理，最后验证两种入口共享同一业务记录。** 它是需按企业制度配置和验证的示例，不代表已部署的财务系统。 员工在工作台查看自己的报销单、补充材料和跟踪状态，也可以在与报销助理的对话中上传发票并说明用途。助理将信息整理为待确认的草稿，财务或审批人继续在获授权的流程中复核。 ## 先确认业务范围 第一版可以只做报销草稿整理和人工复核，不接银行付款、自动记账或自动审批。开始前准备企业费用分类、必填字段、凭证要求、审批角色和可用于测试的发票样例。 发票识别只是提取资料，不等同于税务查验、真伪认证、审批通过或实际付款。需要这些能力时应另行确认接口、权限、业务规则和验收范围。 ## 用 WorkBuddy 或 Codex 构建应用 先完成[AI 工具连接](https://docs.danqiuos.com/start/connect-ai.md)，加载官方 `workbench-app-development` Skill。向开发助手说明目标 Team 和业务流程： ```text 请使用 workbench-app-development Skill，构建企业财务报销场景。 第一版使用 Workbench 做“我的报销、报销详情、费用明细、附件、人工复核”页面， 使用 Arcubase 保存业务数据。后续由报销助理读取对话和发票，写入同一数据应用。 先核对企业、账号与 Team，确认我选择复用已有 App 还是新建。 请提出表结构、费用分类、状态流转、角色权限及样例验收方案，暂不写入或发布。 普通员工只能访问获授权的报销；财务与审批人按确认范围复核。 本版不自动审批、不记账、不付款。缺少企业制度时请询问，不自行确定报销标准。 ``` 确认结构和操作范围后，再让助手按 Skill 实施。业务数据选择 `arcubase`；若需读取成员、对话或文件等平台资源，再按实际功能选择 `octopus`。审批待办确实需要项目和任务时再选 `taskboard`，不能把任务状态直接当作完整财务审批制度。 ## 建议的数据结构 | 对象 | 方案字段示例 | 设计要点 | | --------- | ------------------------- | -------------------- | | 报销单 | 申请人、部门、用途、币种、汇总金额、状态、提交时间 | 申请人来自确认的身份，汇总与明细一致 | | 费用明细 | 所属报销单、费用日期、分类、金额、商户、备注 | 不把不同币种直接相加；金额和必填项需核对 | | 发票与附件 | 关联明细、源文件引用、发票信息、识别待核对项 | 保留授权可访问的原文件，不只保留模型摘要 | | 复核记录（如需要） | 报销单、处理人、处理时间、结论、意见 | 状态变更有真实责任人与证据 | 字段、关系和状态由企业确认后实现。例如可设计“草稿 → 待复核 → 退回补充 / 已复核”，但这不是平台预置的报销状态机。复用已有财务数据应用时，以既有结构和规则为准。 应用用户、报销助理、财务和审批人的权限分别配置。普通员工不能读取他人报销，助理不因有录入权限就拥有批准或付款权限。附件本身也必须按业务范围控制访问。 ## 工作台先通过本地验收 让 AI 实施真实列表、详情、草稿编辑和当前范围内的复核操作，使用生成的 Arcubase 强类型客户端。按脚手架开发登录流程进入本地应用，检查真实记录或真实空状态。 经授权使用测试记录验证新增、修改、附件打开、状态流转和错误反馈；保存后回读实际数据。记录 App ID、表标识、字段 key、状态、关系与权限，下一步交给助理复用。先在本地验证，不以页面完成为由提前发布。 ## 配置报销助理 可以让开发助手先准备岗位、Skill 和授权方案，再由已支持的 CLI 配置能力或管理员 Portal 完成装配： ```text 请为刚才的报销工作台设计并配置“报销助理”，复用同一个 Arcubase App。 先提出岗位说明、发票整理 Skill、字段映射、文件读取能力和最小数据授权。 不要新建另一份报销库，也不要授予审批或付款权限。 工作流程：核对当前申请人和 Team；读取获授权上传的发票及对话说明； 提取日期、商户、金额、币种等可辨认字段，并保留原文件引用； 标记低置信度或缺失信息；检查可能重复的发票及已有草稿； 展示费用明细和汇总，补齐用途等必填项，经人确认后创建或更新草稿。 写入后回读真实记录，返回报销单标识和结果摘要。 不能辨认或访问的资料请明确说明；不猜金额、用途或申请人。 发现疑似重复时先请人核对，不自动删单或合并。 先展示方案，经确认再装配，并报告实际员工标识和验证结果。 ``` 发票为图片时，确认员工启用并获准使用图像识别；PDF、扫描件或其他附件，应按当前环境实际支持的读取能力单独验证。文件上传成功并不代表已能读取其内容。所需能力包括 Arcubase 使用类工具及适用的文件/图像读取能力，参见[内容与资料工具](https://docs.danqiuos.com/reference/content.md)。 ## CRIDO：从上传到报销草稿 | 环节 | 本方案设计 | | --------- | ---------------------------------------------- | | Cue | 员工在报销助理会话中上传发票并提出报销请求 | | Reference | 企业报销制度、费用分类、字段结构、发票整理 Skill 和重复检查规则 | | Input | 已确认申请人、获授权附件、费用用途、日期与其他实际提供的信息 | | Do | 读取资料、整理明细、核对缺项和疑似重复、请求确认、写入同一 Arcubase App 并回读 | | Output | 工作台可查询的报销草稿、明细、原始附件引用和待补充事项 | ## 验证应用与助理的协作 使用已授权的测试发票，在报销助理会话中发送： ```text 请根据我上传的测试发票整理一份报销草稿，用途是【填写用途】， 归属【填写已确认的业务项目或部门】。先列出你识别的明细、金额和待补充信息， 等我确认后再保存，不提交审批，也不进行付款。 ``` 1. 对照原票核对日期、商户、金额和币种；模糊字段应明确待核对。 2. 人确认后，工作台能找到同一报销单，金额与明细一致，附件可由获授权人员打开。 3. 在工作台按权限补充用途或退回原因，助理再次查询时能读到最新结果。 4. 测试重复上传、无法读取的附件、缺失用途、取消确认和其他员工越权访问。 5. 如果纳入审批流程，单独验证各角色允许的状态迁移和记录；草稿保存不代表审批通过。 本地联合验收通过并明确批准发布后，按[Workbench 开发流程](https://docs.danqiuos.com/build/workbench.md)发布应用，再用最终地址复验。交付保留数据标识、员工与 Skill、角色权限、样例证据、业务规则版本和维护责任人。 --- url: https://docs.danqiuos.com/scenarios/intelligence.md --- > 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. # 行业情报示例方案 > 本页是待按企业实际环境配置与验证的示例设计，不代表已经部署或验收通过的客户成功案例。 ## 场景目标与输入 本页是行业情报助理的示例方案，围绕企业关注的行业、政策、价格与竞品变化，持续收集公开资料并形成可追溯的摘要和周报。它适合缺少专职情报人员、希望定期获得相关信息而不是重复搜索的团队。 输入包括关注主题、行业关键词、地区、时间范围、重点来源和接收人。企业还需说明哪些变化值得升级为经营事项，例如涉及主要产品或供应链的政策变化。关注范围越明确，越容易控制噪声与验收质量。 ## CRIDO：从触发到结果 按 [CRIDO 场景分析](https://docs.danqiuos.com/build/crido.md) 区分执行依据、当次输入与实际动作，避免把工具清单当成业务闭环。 | 环节 | 本方案设计 | | --------- | --------------------------------- | | Cue | team 内计划任务按约定周期触发，或成员提出指定主题的调研任务 | | Reference | 情报监测 skill、关注主题、来源质量规则和重要变化升级标准 | | Input | 行业关键词、地区、时间窗口、重点来源、企业背景与结果接收人 | | Do | 搜索并读取来源原文，区分事实与解读，归档条目并为需评估事项创建任务 | | Output | 带来源和时间的情报清单、可打开的周报、待核实项与影响评估任务 | ## Team、前置条件与能力组合 在目标 team 中由行业情报助理整理来源，业务管家或指定业务负责人判断影响。准备一个主题、明确时间窗口、若干可核对的来源和接收人；验证知识库企业背景的读取范围、归档数据表及成果工作区权限。 能力组合为计划任务、`web_search`、`web_fetch`、业务台账、文档成果与 Taskboard；搜索线索需要读取原文后再引用。需要消息通知时独立验证送达。工具见 [内容与资料工具](https://docs.danqiuos.com/reference/content.md) 与 [任务及成果协作](https://docs.danqiuos.com/reference/orchestration.md)，团队责任见 [Team 方案设计](https://docs.danqiuos.com/build/team-design.md)。 ## 岗位、技能与数据装配 | 组成 | 示例配置 | | ------ | -------------------- | | 行业情报助理 | 检索公开资料、核对来源、整理摘要 | | 业务管家 | 接收重要变化并组织影响评估 | | 技能 | 每日行业监测、每周周报、重要变化上报 | | 工具 | 网页搜索、网页读取、业务数据和文档能力 | | 数据 | 原始链接、发布时间、主题、摘要、处理状态 | 企业稳定背景可进入知识库，情报条目则进入结构化台账。每条结论应保留来源和时间；业务解读与原文事实应区分记录，避免后续引用时失去证据边界。 ## 执行、人工确认与输出 按配置周期检索关注主题，读取相关页面并判断与企业的关联程度。员工将资料摘要及来源归档，形成周报，对重要变化创建评估任务。公开信息与内部业务数据结合时，只读取已授权的部分。 人工确认用于判断业务影响、决定是否调整经营策略，以及审核对外引用或发布内容。输出可包括带来源的情报清单、行业周报、待核实事项和重要变化任务。未经核实的消息应标明不确定性，不应被写成既定事实。 ## 边界与验收 搜索结果是信息线索，不能直接代替高风险决策依据。发布时间与事件发生时间可能不同，转载也不等于新的独立证据；员工应核对重要来源，并说明无法访问或无法确认的部分。 验收可选定一个主题和时间窗口，检查结果相关性、链接可追溯性、摘要是否忠于原文，以及重要变化是否进入任务。异常用例包括网页不可读、资料互相冲突和没有足够信息。计划运行与消息投递应分别验证，具体配置参见 [计划任务与事件触发](https://docs.danqiuos.com/platform/triggers.md)。 --- url: https://docs.danqiuos.com/scenarios/delivery.md --- > 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. # 履约回款示例方案 > 本页是待按企业实际环境配置与验证的示例设计，不代表已经部署或验收通过的客户成功案例。 ## 场景目标与输入 本页是履约回款助理的示例方案，承接销售赢单后的订单要素，持续跟踪发货、签收、应收和回款，并把异常交给责任人处理。适合订单与收款信息分散、交期风险发现晚或催款依靠个人记忆的团队。 输入包括客户、成交依据、订单金额、交付要求、应收计划、发货与回款记录。来源可以是共享业务表或企业已接入的系统，装配时必须明确哪个来源是各字段的事实依据。 ## CRIDO：从触发到结果 按 [CRIDO 场景分析](https://docs.danqiuos.com/build/crido.md) 区分执行依据、当次输入与实际动作，避免把工具清单当成业务闭环。 | 环节 | 本方案设计 | | --------- | ------------------------------------------ | | Cue | 销售赢单交接任务、业务人员补充记录，或 team 内周期巡检 | | Reference | 订单核对、发货、回款登记及催款 skill，交付条款和财务确认规则 | | Input | 客户、成交依据、订单金额、交期、发货记录、应收计划和真实回款记录 | | Do | 核对交接，按授权维护订单和应收状态，识别异常并创建任务，外发或例外动作交由授权人决定 | | Output | 可回查的订单与应收记录、风险清单、催款草稿、跟进任务和经确认的实际执行结果 | ## Team、前置条件与能力组合 在目标 team 中明确履约回款助理、销售、财务、仓管和业务负责人。选一笔可追溯订单，准备发货、部分回款及应收计划样例；为每个字段指定事实来源，核对金额和日期口径，并确认相关员工的读写范围。 能力组合为已授权业务系统或 Arcubase、Taskboard、计划任务、财务规则知识和按需使用的消息渠道。任务项目先定义「受理 → 处理 → 复核 → 完成」等业务状态及允许流转，复核退回应有明确责任人；工作区保证接收人能打开依据和结果。详见 [Team 方案设计](https://docs.danqiuos.com/build/team-design.md)、[任务看板](https://docs.danqiuos.com/platform/taskboard.md) 与 [工作区](https://docs.danqiuos.com/platform/workspaces.md)。 ## 岗位、技能与数据装配 | 组成 | 示例配置 | | -------- | -------------------- | | 履约回款助理 | 维护订单、发货、应收与回款链路 | | 销售助理 | 提交客户与成交信息，补充交接缺项 | | 财务与业务负责人 | 核对回款、确认催款及业务例外 | | 技能 | 订单跟踪、物流跟踪、回款登记、应收提醒 | | 数据 | 订单、发货记录、回款记录、应收及确认记录 | 将交期风险、逾期天数和应收状态定义为可复用字段，指定责任员工巡检回写。一个岗位负责订单到回款的主链可以减少交接断点，但仍需明确财务、仓管与业务人员的实际责任。 ## 执行、人工确认与输出 员工接收订单交接任务后核对关键要素，缺项时请求补充。运行中按约定口径识别交期与回款风险，创建跟进任务并准备提醒材料。催款外发前，向财务或授权负责人展示客户、金额、依据、接收人与草稿。 款到发货例外应暂停并提交背景、客户承诺和风险说明，由授权人决定。输出包括更新后的订单与应收数据、风险清单、催款草稿、跟进任务和确认后的执行结果。数据与任务协同方式见 [Taskboard](https://docs.danqiuos.com/platform/taskboard.md)。 ## 边界与验收 数字员工不应凭聊天中的模糊表述认定已收款，也不应自行改变付款条件或作出交付承诺。涉及财务判断和例外放行时，需保留人工决策与对应依据。 验收选择一笔订单贯穿交接、发货、应收和回款，直接核对金额、日期、关联记录与状态变化。再测试缺失发货记录、部分回款、逾期、催款被拒绝和例外未批准的情形。要求异常可追踪、拒绝后动作停止、批准后按确认内容执行，任务完成时能找到相应业务证据。 --- url: https://docs.danqiuos.com/scenarios/browser-inspection.md --- > 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. # 网页后台巡检示例方案 > 本页是待按企业实际环境配置与验证的示例设计，不代表已经部署或验收通过的客户成功案例。 ## 场景目标与输入 供应商或电商后台尚无稳定接口时，可装配一位订单巡检员工，按约定日期进入后台、下载订单报表、按规则识别异常并交给责任人处理。目标是留下可追踪的订单异常，而不是仅证明员工能打开网页。 输入包括后台地址、目标日期、订单范围、异常规则、凭据引用和结果接收人。试点先选择一个后台、一类报表和一个明确异常；涉及外部提交或更改订单时，另行确定授权人与确认条件。 ## CRIDO：从触发到结果 | 环节 | 本方案设计 | | --------- | ---------------------------------------------------- | | Cue | team 内计划任务或成员对话启动指定日期的订单巡检 | | Reference | 巡检 skill、订单异常规则、后台操作说明与已验证的 WebSkill | | Input | 后台地址、目标日期、订单范围、Secret 引用及接收人 | | Do | 使用 browser_use 核对账号、进入业务页、查询或下载报表，再识别异常并按授权创建任务或写入数据 | | Output | 可打开的报表、带来源订单标识的异常清单、责任明确的任务或可回查的数据更新 | 拆解方式见 [CRIDO](https://docs.danqiuos.com/build/crido.md)。Secret 是受控引用，方案和任务中不保存真实密码或 token。 ## Team、前置条件与能力组合 在目标 team 中配置巡检员工、后台账号维护人和异常处理负责人。确定任务项目与成果工作区，确保负责人可打开原始报表和异常清单。员工只能查询本次授权的业务范围，不能因账号能看到其他业务就扩展巡检目标。 组合 [浏览器与 WebSkill](https://docs.danqiuos.com/platform/browser.md)、[Secret 与设备](https://docs.danqiuos.com/platform/enterprise-access.md)、[计划任务](https://docs.danqiuos.com/platform/triggers.md)、[Taskboard](https://docs.danqiuos.com/platform/taskboard.md) 以及可选业务台账。后台仅内网可达时，先确认设备或网络和私有服务可用。团队角色与交付范围按 [Team 方案设计](https://docs.danqiuos.com/build/team-design.md) 明确。 云浏览器支持导入 Cookie，也可以直接登录。实际租户中先确认入口可用，导入或登录后打开业务页面，核对账号、企业和访问范围。WebSkill 位于浏览器能力下，只沉淀已验证且会重复使用的页面流程，不将其视为独立业务域。 ## 执行与结果证据 1. 确认目标日期和订单范围，打开后台并检查登录身份。 2. 进入真实订单页，按业务标识定位记录或下载报表。 3. 核对文件可打开、日期范围正确，并按明确规则生成异常清单。 4. 为需要处理的异常创建任务，关联订单、证据和负责人；若写入业务表，回查写入结果。 5. 把成果放入指定工作区，由接收人实际打开并确认能接续处理。 保留关键页面状态、原始报表、异常判定依据、任务活动及数据变化。周期触发要单独验证实际运行记录；有通知时还要验证消息送达。仅有截图或一句「巡检完成」不足以验收。 ## 失败测试与试点结论 用已知异常订单验证识别结果，再测试登录过期、错误账号、订单不存在、下载文件为空、页面改版和接收人无权查看。登录失效应由授权人员接管或更新登录态后恢复；页面流程变化应重新验证并维护 WebSkill，不能盲目重放提交步骤。 测试非法状态跳转被阻止、异常任务交给正确负责人，以及权限不足时不会读取受限订单。网页提交结果未知时先回查后台，再决定重试。试点记录实际通过的步骤、未通过的条件和责任人；通过前不承诺无人值守运行。工具范围见 [执行能力速查](https://docs.danqiuos.com/reference/execution.md)，交付标准见 [验收](https://docs.danqiuos.com/operations/acceptance.md)。 --- url: https://docs.danqiuos.com/scenarios/workbench.md --- > 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. # Workbench 业务应用示例方案 > 本页是待按企业实际环境配置与验证的示例设计，不代表已经部署或验收通过的客户成功案例。 ## 场景目标与输入 为销售或履约 team 创建一个可反复使用的业务工作台，让成员查看客户、商机或订单，筛选待处理事项，提交业务记录并交接数字员工任务。具体功能由企业流程确定，平台提供应用开发和托管底座。 开始前准备目标团队、账号、使用角色、已有数据结构、业务流程和维护人。一次性报告或已有页面的低频操作通常无需另建应用；先确认界面确实能改善反复发生的业务操作。 ## CRIDO：从需求到应用交付 | 环节 | 本方案设计 | | --------- | ------------------------------------------ | | Cue | team 提出工作台需求，交付后用户从 Workbench 应用进入业务流程 | | Reference | 应用需求、业务权限规则、选定的数据结构和官方开发 skill | | Input | 目标 team、当前用户、获授权的真实记录、页面与操作要求 | | Do | 按开发 skill 创建或扩展应用，接入所需客户端，完成本地验收与交付确认后构建发布 | | Output | 可访问的 Workbench 应用，以及真实数据操作、任务交接和发布后验证记录 | 此表描述应用交付闭环；应用内每项业务操作还应按 [CRIDO](https://docs.danqiuos.com/build/crido.md) 分清触发、输入、执行与结果，不能用「应用已发布」代替全部业务验收。 ## Team、前置条件与能力组合 在目标 team 中明确业务负责人、开发与维护人、使用成员及承接任务的数字员工。准备各角色的测试账号和真实样例记录，确认任务项目、业务表和成果工作区的访问权限。员工可用范围与应用使用者的访问范围分别验证，具体见 [Team 方案设计](https://docs.danqiuos.com/build/team-design.md)。 使用 [Workbench App Development Skill](https://github.com/syngy-ai/workbench-app-development-skill)，执行步骤以其 [SKILL.md](https://github.com/syngy-ai/workbench-app-development-skill/blob/main/skills/workbench-app-development/SKILL.md) 为准。它支持 Codex、Claude Code 和 WorkBuddy，方案组合 Vibe Coding、octopus-cli 和实际需要的客户端，不另造命令或参数。 | 需求 | 能力选择 | | -------------- | ------------------- | | 登录后的业务界面 | 基础 Workbench 应用 | | 团队、成员、员工、会话或文件 | Octopus 客户端 | | 项目与任务查询、处理 | Taskboard 客户端 | | 持久化、共享与查询业务记录 | Arcubase 及生成的强类型客户端 | 不是每个应用都需要 Arcubase。已有数据应用先核对结构，新建时先明确字段、关系和访问范围；未接入真实数据前，演示数据只能用于界面讨论，不能作为业务已接通的证据。 ## 开发、确认与发布 1. 确认业务范围、团队、账号和数据来源；已有应用先检查当前实现。 2. 新应用使用官方脚手架；已有应用保留现有工程与改动，仅补充必要客户端和功能，再接入真实记录。 3. 在本地验证登录后返回业务页面、列表数据、搜索筛选及新增修改。 4. 将本地结果展示给交付负责人，确认后按开发 skill 构建并发布。 5. 检查发布状态，在最终地址直接打开并刷新业务路由，再次完成真实业务操作。 以新增一条客户跟进为例：页面提交后重新查询该记录，员工能读取并处理关联任务，成员返回工作台可看到一致结果。任务责任、状态与业务记录使用可关联的标识，避免出现页面完成而后台没有变化。 应用设置可维护信息与访问域名，调整后重验入口和登录。需要公开活动入口时，显式确定公开页面；公开页可打开，不代表访客可以访问团队数据或受保护操作。公开页面与登录后的业务页面分开验收。 ## 验收证据与失败测试 交付记录保留目标 team、选用能力、本地验收结果、项目和发布任务标识、最终地址及发布后验证结果。检查真实记录或真实空状态、写入后的回查、任务接收人及应用页面的一致性。仅有代码、截图或发布任务已提交，不构成交付完成。 测试未登录访问、用户越权、数据为空、写入失败、任务接收人无权限和发布失败；界面应如实呈现结果，不能在操作失败后显示成功。对公开页，用访客账号验证指定页面可打开，同时确认受保护页面和团队数据不可访问。详见 [Workbench 平台能力](https://docs.danqiuos.com/platform/workbench.md)、[构建 Workbench](https://docs.danqiuos.com/build/workbench.md) 与 [验收](https://docs.danqiuos.com/operations/acceptance.md)。 --- url: https://docs.danqiuos.com/operations/acceptance.md --- > 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. # 验收与运行质量 可验收的数字员工应能说明做了什么、依据是什么、结果在哪里。一次对话回答流畅，不代表业务工作已经完成。 ## 最小验收单位是完整场景 按[CRIDO](https://docs.danqiuos.com/build/crido.md)记录谁触发、哪个员工处理、依据什么规则、读取哪些输入、调用哪些能力、输出在哪里以及接收人能否打开。只看到截图、代码、包名或一句完成回复，都不足以证明业务闭环跑通。 ## 验收至少覆盖四类用例 | 用例 | 检查内容 | 通过表现 | | ---- | -------------- | ------------ | | 正常流程 | 输入完整、权限正确 | 结果与业务口径一致 | | 异常输入 | 数据缺失、状态冲突、系统失败 | 明确标记问题，不编造结果 | | 权限边界 | 未授权用户或超范围请求 | 拒绝或交由合适人员处理 | | 人工确认 | 必须审批的关键动作 | 先暂停并请求确认，再推进 | ## 经营简报验收示例 准备一份人工可核对的订单与回款样例，包含正常记录、缺失字段与一条异常。要求员工生成指定时间段的简报。 1. 对照原始台账核对汇总值和时间范围。 2. 确认异常有数据依据，缺失字段被明确说明。 3. 检查简报保存位置与可访问权限。 4. 确认未擅自更改交易记录或对外发送。 场景示例可参考[经营分析](https://docs.danqiuos.com/scenarios/operations.md)。 ## 保留独立证据 | 证据 | 解决的问题 | | ------- | ------------ | | 工具轨迹 | 是否真的调用了所需能力 | | 数据回读 | 记录是否按规则改变 | | 任务与活动记录 | 责任、状态和交接是否完整 | | 消息送达记录 | 是否到达正确接收人 | | 交付物 | 文件、报告或页面是否可用 | 重要结论应与业务真值核对，而不是用员工自己的完成声明验证自己。 ## 按能力补齐验证 | 能力 | 必须核对的结果 | | ------------- | ------------------------------ | | Taskboard | 创建、指派、业务状态与允许流转；不允许的跳步被阻止 | | 工作区与成果 | 接收人可打开，未授权者不可见；查看与提交分开验证 | | 系统集成与 MCP | 目标员工真实查询或经授权的业务操作成功 | | 计划任务与日历 | 正确时间或日历条件、目标员工、运行记录与结果 | | Webhook 与邮件 | 事件或邮件进入、字段与附件处理、结果落点 | | 外部消息渠道 | 来自真实渠道的输入被处理，回复回到原会话，接收人能打开成果 | | 浏览器与 WebSkill | 正确账号、页面状态、流程复用、登录过期与页面变化后的恢复 | | Secret、设备与内网 | 凭据不暴露；设备可用、私有服务可达，业务结果可验证 | | 知识库 | 索引就绪、引用准确、更新可检索，查看与修改分别受控 | | compute_use | 用实际场景试跑，保存的文件和操作结果可观察 | | Workbench | 本地真实数据、发布状态、最终业务路由、公开与保护页面分别验证 | | CLI | 命令完成目标动作，输出能支撑下一步，并独立回读结果 | 未验证的依赖应记录为试点或待验证项。单点成功后，仍要检查与上下游的组合，不以工具数量作为成熟度指标。 ## 上线条件 核心用例通过，未通过项有明确影响说明和责任人；数据与权限经过确认；运行失败有可观察记录；关键动作有人工节点；维护人与问题处理路径明确。 对于自动触发任务，还应核对时间与时区、重试行为、重复执行和接收人，防止人工试跑通过但后台运行失败。 ## 验收记录模板 ```text 场景 / 员工： 环境 / 团队 / 版本： 业务故事 / Cue： Reference / Input： Do / Output： 涉及能力与前置条件： 预期结果： 实际任务、数据与交付物： 人工确认过程： 证据位置： 结论与遗留问题： 验收人 / 日期： ``` 将失败样例加入回归集合；技能、数据结构或系统连接发生变化后，优先重跑相关用例。 --- url: https://docs.danqiuos.com/operations/doc-baseline.md --- > 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. # 文档版本与适用范围 产品文档说明能力、装配方法与验收要求。实际能力是否可用，仍需核对企业部署、员工授权、账号连接与目标业务场景。 ## 本次内容基线 | 资料 | 版本与用途 | | ------------------------------- | ------------------------------------------------------ | | 开发团队 Octopus FDE Toolkit | 2026-10-28，提交 `22cb8dc`；CRIDO、Team 方案、企业环境、工具集和验收的主要依据 | | Workbench App Development Skill | Toolkit 指定的独立维护源；开发步骤、命令及发布契约以该仓库当前版本为准 | | 平台技术白皮书与 FDE 构建指南 v0.3 | 补充岗位、技能、业务数据设计和既有场景背景；与新指南冲突处按新来源校准 | | CLI 0.1.13 验证记录 | 保留为历史操作参考，不代表当前 CLI 全量命令或现行缺陷清单 | 可查看[本次 FDE Toolkit 来源快照](https://github.com/syngy-ai/octotpus-fde-toolkit/tree/22cb8dc00f55f7da0ca6a501ae2e2dce2820a815/guide)和[Workbench 官方维护仓库](https://github.com/syngy-ai/workbench-app-development-skill)。本站的来源映射随源码维护，文档索引由构建自动生成。 ## 本次校准的重要事项 - 增加 CRIDO、Team 设计、工作区访问、企业环境准备和分组工具速查。 - 依据新指南说明云浏览器 Cookie 导入能力；旧资料的“实现完成、待发布”不再作为当前通用结论。交付时仍检查目标环境入口及实际登录状态。 - Calendar Sources 作为计划任务的日历上下文；WebSkill 作为浏览器可复用操作流程。 - Workbench 开发入口迁到 `workbench-app-development`；原 `workbench-vibe-coding-flow` 停止维护。 - 工作区内容查看、成果提交、知识资料修改与索引维护分别说明，避免将管理权限等同于全部内容访问。 ## 如何理解能力状态 | 你已经验证的事实 | 能说明什么 | 还需要什么 | | --------- | ------------ | ------------ | | 文档列出能力或工具 | 资料中有该能力说明 | 环境、授权与连接检查 | | 入口可见、配置成功 | 对象或连接已配置 | 真实业务操作验证 | | 单点操作成功 | 该动作在本次条件下可用 | 从触发到结果的全流程验收 | | 完整场景通过用例 | 该场景在记录环境下可交付 | 版本或业务变化后的回归 | 场景实践均是可供装配的示例方案，不是已发布的客户案例或即开即用应用承诺。工具数量是来源快照统计，不应作为授权套餐或实时可用性说明。 ## 开发和交付前的核对顺序 1. 确认企业 Portal、当前账号与目标 Team。 2. 核对部署版本、所需工具集、账号连接和资源权限。 3. CLI 操作检查当前 `--version` 与对应命令 `--help`；Workbench 阅读官方 Skill 及引用契约。 4. 用可核对的业务样例执行最小闭环，保存实际结果和失败证据。 5. 对未跑通的能力明确标记试点或待验证，不扩展承诺。 验收方法见[运行质量](https://docs.danqiuos.com/operations/acceptance.md)，排障时附上本页所列版本和运行环境信息。 --- url: https://docs.danqiuos.com/operations/for-agents.md --- > 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. # 供 AI 阅读 文档站同时提供人类阅读界面与 Markdown 内容。AI 编码助手可以先读取索引，再按任务选择相关页面，减少无关上下文。 ## 文档入口 | 入口 | 用途 | | ------------------------------------------ | ------------------- | | llms.txt | 按文档导航组织的标题与页面索引 | | llms-full.txt | 全站文档的完整 Markdown 内容 | | 页面上的“复制 Markdown” | 复制当前文档内容 | | 产品介绍 Markdown | 逐页 Markdown 示例 | 逐页 Markdown 由文档构建生成。例如本页对应 `/operations/for-agents.md`。默认先读取索引和相关页面；需要全站审阅时再使用完整文件。 ## 推荐提供的任务上下文 ```text 业务目标：需要数字员工完成什么工作？ 目标环境：哪个 Portal、账号与团队？ 数据来源：使用哪个已确认的业务应用或系统？ 允许动作：哪些可以读取，哪些可以修改？ 人工节点：哪些事项必须先确认？ 验收标准：结果在哪里，如何独立核对？ ``` ## 按任务选择页面 - 设计数字员工：读取[岗位定义](https://docs.danqiuos.com/build/employee.md)、[技能编写](https://docs.danqiuos.com/build/skills.md)与[数据权限](https://docs.danqiuos.com/build/data.md)。 - 开发场景界面：读取[Workbench 开发](https://docs.danqiuos.com/build/workbench.md)与[验收](https://docs.danqiuos.com/operations/acceptance.md)。 - 定位故障：读取[排障](https://docs.danqiuos.com/operations/troubleshooting.md)，结合实际运行记录。 ## 使用边界 文档描述能力和方法，不代表对真实企业环境的操作授权。具体命令、字段和接口以当前部署版本为准。目标团队、资源标识和权限范围需要回读核对，不根据文档示例推断真实值。 当资料未覆盖具体 API、安装配置或版本行为时，先查询该环境提供的帮助或官方契约，不补造接口路径和参数。 ## 场景构建教程 [AI 工具连接](https://docs.danqiuos.com/start/connect-ai.md)说明 CLI 登录与 Skill 准备；[CRM 快速开始](https://docs.danqiuos.com/start/quickstart.md)提供应用、数据、员工装配及双向验收提示词；[财务报销](https://docs.danqiuos.com/scenarios/reimbursement.md)将该方法迁移到发票与报销草稿。示例字段是待确认方案，不是固定 API，不能据此猜测实际资源标识。 ## FDE 方案与工具查询路径 理解[CRIDO](https://docs.danqiuos.com/build/crido.md)后，读取[Team 方案设计](https://docs.danqiuos.com/build/team-design.md)，再按 Do 环节从[工具集速查](https://docs.danqiuos.com/reference/overview.md)选择所需能力。工具表保留精确标识，但不包含参数契约；不要将工具名直接拼成 CLI 或 HTTP 请求。 Workbench 开发读取[官方 Skill 入口](https://docs.danqiuos.com/build/workbench.md)，不继续使用已停止维护的旧流程。[文档基线](https://docs.danqiuos.com/operations/doc-baseline.md)区分新指南、历史 CLI 记录和实际运行认证。输出实施方案时，明确工作区、资源授权、Output 证据与尚未验证的依赖。 --- url: https://docs.danqiuos.com/operations/glossary.md --- > 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. # 术语表 这里列出产品与构建指南中的常用词。字段名和工具标识需要结合具体部署版本核对。 ## 产品与组织 | 术语 | 含义 | | --------------- | ---------------------------- | | 企业专属装配版 / Dock | 企业数字员工开发、装配、运行与治理的产品底座 | | 数字工人 | 可复用的岗位模板 | | 数字员工 | 进入具体团队、具备上下文与权限的岗位实例 | | 团队 / Team | 场景装配的团队边界，成员、员工、资源与授权围绕它设计 | | 工作区 / Workspace | 任务、内容和成果的个人或团队协作范围；查看与提交分别授权 | | 汇报线 | 约束员工协作和委派的组织关系 | | 场景应用 | 面向具体业务目标，组合员工、数据、流程与界面的应用 | ## 装配与能力 | 术语 | 含义 | | ----------------- | --------------------------------------------- | | promptSpec | 常驻身份、执行原则、边界与技能路由 | | Skill | 一类业务工作的执行方法 | | Skillset | 岗位使用的一组技能 | | Toolset / Toolkit | 按能力组织的工具集合，配置标识以当前目录为准 | | Tool | 实际调用的具体动作；不是天然可在终端执行的命令 | | CRIDO | Cue、Reference、Input、Do、Output，即触发、依据、输入、执行、输出 | | toolkitKeys | 配置中用于指明工具箱的标识集合 | | FDE | 将业务场景转化为平台能力配置并负责构建交付的实施角色 | ## 数据与交互 | 术语 | 含义 | 进一步阅读 | | --------- | --------------- | ------------------------------------------------------- | | Arcubase | 结构化业务数据与应用底座 | [业务数据](https://docs.danqiuos.com/platform/arcubase.md) | | Ontos | 业务对象与关系的语义表达 | [业务本体](https://docs.danqiuos.com/platform/ontos.md) | | Taskboard | 承载任务、责任、状态和交接记录 | [任务协作](https://docs.danqiuos.com/platform/taskboard.md) | | A2UI | 任务中的结构化交互界面 | [交互界面](https://docs.danqiuos.com/platform/a2ui.md) | | Workbench | 固定入口的企业场景工作台 | [应用开发](https://docs.danqiuos.com/build/workbench.md) | | WebSkill | 沉淀网站操作经验的可复用能力 | [浏览器](https://docs.danqiuos.com/platform/browser.md) | ## 运行与连接 | 术语 | 含义 | | ---------------- | ---------------------- | | 人在环路 | 在关键流程中设置人工判断、确认与交接 | | MCP | 连接外部工具与资源的一种协议方式 | | Webhook | 外部事件触发平台工作的入口 | | Calendar Sources | 计划任务的日历上下文，如工作日、节假日和排班 | | Secret / 保险箱 | 受控管理凭据；凭据目录不返回真实秘密值 | | compute_use | 通过桌面计算环境操作应用和文件的执行能力 | | Station | 数字员工连接外部交互渠道的相关配置概念 | | Profile | CLI 本地保存的环境与身份配置 | | 交付物 / Artifact | 任务产出的文件、报告或其他可验收结果 | 理解概念之间的关系可从[核心概念](https://docs.danqiuos.com/start/concepts.md)开始。 --- url: https://docs.danqiuos.com/operations/troubleshooting.md --- > 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. # 常见问题与排障 先定位失败环节，再修改配置。常见运行链路是：触发 → 身份 → 上下文 → 技能 → 工具 → 数据或系统 → 人工确认 → 输出与留痕。 ## 员工只回答，没有执行 依次检查岗位是否应该承担该任务、Skill 是否启用并绑定、对应 Toolkit 是否授权、必需输入是否齐全，以及当前请求是否匹配技能触发条件。 用一个更明确的最小任务复现，例如“读取指定订单台账，列出约定交期已过且尚未完成的记录”。检查是否出现对应工具轨迹，而不是只给 prompt 增加“主动调用工具”。 ## 技能未触发或选择错误 检查多个 Skill 是否职责重叠、描述是否贴近业务动作、常驻规则是否定义了路由。用不同真实话术测试同一意图，并加入相近但不该触发的反例。 ## 常见问题对照 | 症状 | 优先检查 | 修复后验证 | | ---------- | ------------------------- | ----------------------- | | 数据不存在或字段错误 | 应用/表标识、字段 key、当前身份权限 | 独立回读实际记录 | | 计划任务不执行 | 启用状态、时区、触发时间、目标员工 | 人工试跑和下一次触发记录 | | 消息未送达 | 接收人绑定、渠道连接、发送权限 | 实际送达记录与接收端 | | 浏览器操作失败 | 登录状态、页面变化、风控与人工接管 | 重新执行最小网页操作 | | 交付物打不开 | 文件生成、工作区查看与成果提交范围 | 用实际接收人打开；未授权者不可见 | | 资料上传后搜不到 | 目标知识库、处理进度、语义索引、查询权限 | 用已知问题检索并核对引用 | | 任务不能流转 | 项目允许的状态迁移、角色与工作区范围 | 合法路径成功，非法跳步被阻止 | | 内网查询失败 | 设备在线、目标网络、服务发现、Secret 引用 | 用目标员工完成真实查询 | | 网页已登录但操作失败 | 账号权限、页面改版、登录态过期 | 恢复正确登录态后验证业务结果 | | 应用只显示演示数据 | 目标账号与 Team、Feature、真实后端连接 | 真实记录或真实空状态，写入可回读 | | 应用发布未完成 | 发布任务状态和错误信息 | active 与最终地址、直接打开及刷新业务页 | | CLI 参数报错 | 本机版本、该命令当前帮助、来源版本 | 按当前契约小范围验证，不猜旧别名 | | 任务卡住 | 是否等待人工、依赖任务或外部系统 | 完成前置条件后的状态推进 | ## 处理权限与连接问题 不要通过临时放大全部权限绕过问题。先确认请求者、员工、团队和资源之间的关系，再检查业务所需的最小范围。涉及验证码、重新登录或风险确认时，交给相应人员处理。 ## 记录并复现 保留环境与版本、目标团队、最小输入、预期结果、实际状态、工具轨迹和错误信息。分享排障记录前移除凭据与不必要的业务内容。 修复后重新运行原始失败用例，再核对相关正常用例。如果权限、数据或部署版本不支持该能力，应记录限制，不把未支持能力写成已修复。 相关文档：[验收](https://docs.danqiuos.com/operations/acceptance.md)、[组织权限](https://docs.danqiuos.com/platform/security.md)、[企业连接](https://docs.danqiuos.com/platform/integrations.md)。