WorkBuddy 使用文档

概述

将 WorkBuddy 接入织信后，可以用自然语言查询业务数据、搭建应用、配置审批流程和维护已有系统。本文提供可直接复制到 WorkBuddy 的示例，并说明每个示例的前提和检查方法。

首次使用请先完成 WorkBuddy 对接。可以通过 SkillHub 安装织信技能，也可以配置织信 MCP 自定义连接器。

示例使用说明

将示例中的应用名称、业务规则和时间范围替换成自己的实际需求。示例描述的是希望 WorkBuddy 完成的任务，实际执行结果取决于当前账号权限、可用工具和应用配置。文中的客户、订单和金额均为演示数据。

第一次使用：确认连接和目标应用

完成接入后，新建一个任务，输入：

请使用织信技能或已连接的织信工具，查询我当前可以访问的应用列表。
列出应用名称和应用 ID，不要创建或修改任何内容。
如果连接不可用，请说明缺少什么配置，不要编造应用列表。

返回列表后，选择要操作的应用。后续对话中尽量同时提供应用名称和应用 ID，避免修改同名应用。

对于已有应用，可以继续输入：

接下来操作应用“客户管理系统”，应用 ID 为 <实际应用ID>。
请读取当前应用结构，列出数据表、关键字段和表间关联。
先说明已有功能，不要修改配置或数据。

检查结果： 应用 ID 应与织信中的目标应用一致，返回的表和字段应能在对应应用中找到。若无法读取设计配置，先检查账号是否拥有应用设计权限。

示例一：从零创建客户管理系统

业务场景

销售团队需要统一管理客户和跟进记录，并查看不同客户等级的分布。建议把需求拆成“方案确认”和“执行创建”两轮对话。

第一步：生成方案

请帮我在织信中搭建一个“客户管理演示”应用，先输出方案，等我确认后再创建。

业务需求：
1. 客户表：客户名称、联系人、联系电话、客户等级、负责人、客户状态。
   客户等级为 A、B、C；客户状态为潜在客户、跟进中、已成交、已流失。
2. 跟进记录表：关联客户、跟进时间、跟进人、跟进内容、下次联系日期。
3. 一个客户可以有多条跟进记录，客户详情中可以查看对应的跟进列表。
4. 提供客户列表、跟进记录列表和客户概览仪表盘。
5. 仪表盘展示客户总数、按客户等级分组的客户数量、按负责人分组的客户数量。

请先查询是否存在同名应用；若存在，列出应用 ID 并让我选择。
方案中说明字段类型、关联关系、页面和统计口径。
本轮只规划，不创建、不导入数据、不发布。

第二步：确认后创建

确认方案符合需求后，再输入：

确认按上面的方案创建“客户管理演示”。
请先检查现有资源，避免重复创建应用、表和字段。
创建后执行配置校验，列出已完成内容、未完成内容及原因。
返回实际应用 ID、设计器地址和需要我检查的配置，暂不发布。

检查结果： 在设计器中检查两张表的字段和关联，确认客户详情能查看跟进列表；检查仪表盘数据源是否指向实际创建的客户表。空表时统计为零或无数据属于正常情况，可在后续添加演示数据后核对。

示例二：把 Excel 台账整理成业务应用

业务场景

已有一个采购台账工作簿，包含供应商、采购订单和订单明细，希望转成可协作的业务系统。先在 WorkBuddy 中添加需要分析的 Excel 文件，再输入以下需求。

第一步：分析工作簿

请分析我上传的采购台账 Excel，先不要连接织信执行写入。

请逐个工作表说明：用途、列名、可能的字段类型、记录数量。
检查供应商编号、订单编号是否存在空值或重复，订单明细能否匹配到订单。
说明页和汇总页不要直接当作业务数据表。

请给出供应商、采购订单、订单明细的建模建议、字段映射和异常数据清单。
保留编号中的前导零；日期和金额格式不明确时先列出问题。
不要修改原文件，也不要凭空补齐缺失数据。

第二步：确认映射后落地

确认使用刚才的字段映射，在织信中新建“采购台账演示”应用。
先检查同名应用；发现同名应用时暂停创建并让我选择。
建立供应商与采购订单、采购订单与订单明细之间的关联。

先创建结构并校验，再导入 3 条订单及其关联供应商、明细进行核对。
报告各表成功数、失败数、异常原因和导入记录的定位信息。
全量导入前等我确认，不发布应用。
再次执行时先检查业务编号，避免重复导入。

检查结果： 将样本与 Excel 逐条比对，重点检查供应商关联、订单明细归属、编号、日期、数量和金额。确认样本后，再明确要求导入剩余数据，并核对各表记录总数及失败记录。

示例三：查询业务数据并生成汇总

业务场景

销售负责人希望了解一个月内新增客户的情况。这类任务可以先从只读查询开始。

请查询织信应用“客户管理系统”（应用 ID：<实际应用ID>）。
先读取客户表结构，确认创建时间、客户等级和负责人对应的真实字段。

统计 2026 年 10 月新增的客户：
1. 时间范围为北京时间 2026-10-01 00:00:00（含）至 2026-11-01 00:00:00（不含）。
2. 列出新增客户总数、各客户等级数量、各负责人数量。
3. 客户等级或负责人为空的记录单独列为“未填写”。
4. 说明使用的应用、数据表、筛选字段、时间范围和查询时间。
5. 数据超过单次查询上限时，请使用统计能力或完整分页，不要只统计第一页。

只读取数据，不修改记录，不发送通知。

检查结果： 用织信列表设置相同时间条件，核对总数。按等级、按负责人分别汇总后的数量都应与总数一致；如果权限限制了可见记录，报告应明确说明统计范围。

示例四：为采购申请配置分级审批

业务场景

采购申请按金额走不同的审批路径。执行前需要明确审批人、金额边界和退回处理方式。

请为“采购管理”应用（应用 ID：<实际应用ID>）规划采购申请审批流程。
先读取现有申请表和流程，优先复用已有配置。

规则：
1. 申请表包含申请人、申请部门、采购说明、申请金额和采购明细。
2. 申请金额必须大于 0；请说明校验放在哪里。
3. 所有申请先由部门负责人审批。
4. 金额小于 10000 元，部门负责人通过后结束。
5. 金额大于或等于 10000 元，部门负责人通过后还需财务审批。
6. 审批人可以通过或退回；退回后申请人可修改并重新提交。

先列出需要补充的字段、审批人来源、节点、分支条件和退回路径。
如果部门负责人或财务审批人无法从现有配置确定，请让我补充，不要随意指定。
方案确认前不保存流程，保存后先校验，不自动发布或发起真实审批。

确认方案并补齐审批人后，可继续要求 WorkBuddy 保存配置。

检查结果： 发布前检查节点表单和操作按钮。在测试环境分别用 9999 元、10000 元和 10001 元验证分支，并验证退回、修改、重新提交是否符合要求。

示例五：创建订单经营看板

业务场景

管理者需要查看订单规模和趋势。先明确统计口径，再创建图表，可以减少看板与业务报表对不上的情况。

请在“订单管理”应用（应用 ID：<实际应用ID>）中创建“订单经营看板”。
先读取订单表、订单明细表和现有仪表盘。

统计要求：
1. 以订单表为统计主体，按下单日期统计，排除已取消订单。
2. 展示订单数量、订单金额合计。
3. 展示按月汇总的订单金额趋势，以及按订单状态分组的数量。
4. 如果订单总金额需要由明细计算，先说明计算方法，避免关联明细后重复累计订单金额。
5. 每个图表说明数据来源、筛选条件、分组字段和金额单位。

先输出字段对应关系和布局方案，确认后再创建。
已有同名看板时先检查并说明如何复用，不要重复创建；完成后校验，不发布。

检查结果： 使用相同筛选条件在订单列表核对订单数和金额合计，抽查一个月份的趋势值。如果看板为空，先检查是否已有符合条件的数据，以及图表是否绑定了正确的数据源。

示例六：为已有应用增加字段并更新数据

第一步：增加客户等级字段

请检查“客户管理系统”（应用 ID：<实际应用ID>）中的客户表。
如果已有“客户等级”字段，返回它的类型和选项，不要重复创建。
如果不存在，请新增单选字段“客户等级”，选项为 A、B、C，允许暂时为空。
保留现有字段和数据，不批量填充历史记录。
完成后说明修改内容，执行配置校验，暂不发布。

检查结果： 确认没有同名重复字段，历史数据仍可读取。新字段发布并生效后，再进行下面的数据维护。

第二步：精确定位后更新

请查询同一应用中客户名称为“示例科技有限公司”的记录。
先返回匹配记录的 ID、客户名称、负责人和当前客户等级，不修改数据。
若匹配多条，请让我指定记录 ID。

确认目标记录后输入：

确认将记录 ID 为 <实际记录ID> 的客户等级更新为 A，只修改这一字段。
先重新读取当前值，如果已经为 A 则无需重复更新。
更新后重新查询，返回记录 ID、修改前后的等级和核对结果。

检查结果： 在织信中打开该条客户记录，确认等级为 A，其他业务字段保持原值。

示例七：配置每日到期跟进提醒

业务场景

每天提醒销售人员处理当天到期的跟进事项。先确定接收人、触发时间和防重复规则，再启用任务。

请为“客户管理系统”（应用 ID：<实际应用ID>）规划每日跟进提醒。
先检查现有表结构、定时任务和通知配置，不要重复创建。

规则：
1. 每天北京时间 09:00 检查当天到期且未完成的跟进事项。
2. 按实际负责人汇总，每人只收到自己负责事项的站内通知。
3. 无到期事项时不发送；负责人为空的记录单独报告。
4. 同一天重复执行时，不重复发送同一事项的提醒。
5. 如果缺少完成状态或发送记录，请说明需要新增哪些字段或记录表。
6. 关键日志记录执行时间、匹配数、发送成功数、失败数和失败原因。

先输出实现方案，明确时区、日期边界、接收人来源和防重复方式。
我确认后再创建配置，测试通知只发给我指定的测试账号。
正式启用和向真实业务人员发送前等我确认。

检查结果： 准备一条今日到期、一条未来到期、一条已完成的测试记录，验证只有今日到期且未完成的事项进入提醒；同一天重复执行，检查是否重复通知。

让 WorkBuddy 更准确地执行需求

一个清楚的需求通常包含以下信息：

信息	示例
目标应用	客户管理系统，应用 ID 为实际查询得到的 ID
业务目标	查询本月新增客户，或新增客户等级字段
操作范围	只读查询、修改配置、更新指定记录
业务规则	时间边界、金额阈值、状态选项、审批人来源
完成标准	返回记录数、配置校验结果、修改前后对比
确认节点	方案确认后创建，样本核对后全量导入，检查后发布

任务执行中断后，可以让 WorkBuddy 先核对实际状态：

请先查询当前应用和相关资源，核对上一轮哪些操作已经成功。
列出已完成、未完成和失败项，并说明判断依据。
只继续未完成部分，不要重复创建或重复导入。

检查与发布

创建或修改应用配置后，先在设计器中检查结构、权限、流程和统计结果，再要求 WorkBuddy 执行发布前校验。校验通过后，确认发布范围，再明确发送发布指令：

确认发布应用“<应用名称>”（应用 ID：<实际应用ID>）当前已检查的配置。
发布前重新校验，如有错误则停止并报告。
成功后返回实际应用访问地址和发布结果。

配置与业务数据的区别

应用配置变更通常需要发布后供用户使用；业务记录写入、通知发送等操作可能在执行时直接生效。不要把“暂不发布”理解为所有操作都不会影响业务数据。

只有工具返回成功并完成必要核对后，才应将任务视为完成。若 WorkBuddy 只输出了方案或因权限、连接问题未执行，应先处理问题，再继续创建或发布。

常见问题

WorkBuddy 只给了方案，没有执行

确认是否仍处于“先规划、等我确认”的阶段；确认方案后明确要求执行。如果提示没有可用工具，检查技能或连接器是否已启用，再按 接入说明 验证连接。

找不到应用或字段

先要求查询应用列表和目标表结构，使用返回的真实 ID。也要检查是否连接了正确的织信环境，以及当前账号是否具有相应权限。

创建后在业务页面看不到新字段

先在设计器中确认字段已保存，再检查是否完成校验和发布，以及当前角色是否有字段查看权限。

汇总数字与手工统计不一致

逐项核对时间范围、时区、取消状态、空值处理、分页和账号可见范围；涉及主子表时，检查是否因为关联明细造成重复计数或重复累计金额。