aitable-workflow-cli 0.1.13-beta.1

package/templates/aitable-handoff/workflows/group-qa/workflow.yml

@@ -0,0 +1,210 @@
+meta:
+  name: "AI 表格问题排查助手"
+  version: "2.0.0"
+  domain: technical_support
+  description: "监听群消息，分级响应（已知错误秒回/问题排查/技术问答/静默），支持多轮上下文与图片。管理员知识更新见 admin-kb-update 工作流"
+
+# ─── 通知配置（人工步骤到达时触发） ────────────────
+notification:
+  channel: "none" # none | webhook | im
+
+# ─── 数据表 ───────────────────────────────────────
+# ⚠️ 占位:部署前替换为你自己的 base_id/table_id(group-qa 与 admin-kb-update 的监听表须指向同一张群问答表)
+tracker:
+  label: "群问答记录表"
+  description: "记录群消息、问题分类与回答内容的表格，群答疑助手的主表"
+  base_id: ""
+  table_id: ""
+
+  states:
+    initial: "待处理"
+    active: [ "处理中", "审核中" ]
+    terminal: [ "已完成", "已关闭" ]
+    blocked: "已阻塞"
+    review: "审核中"
+
+  fields:
+    state: "状态"
+    title: "标题"
+    current_step: "当前步骤"
+    owner: "处理人"
+    event_log: "事件日志"
+
+  field_definitions:
+    - name: 消息内容
+      type: text
+    - name: 发送人
+      type: text
+    - name: 发送时间
+      type: date
+    - name: 对话上下文
+      type: text
+    - name: 消息分类
+      type: singleSelect
+      options:
+        - 技术问答
+        - 已知错误
+        - 问题排查
+        - 静默
+    - name: 分类理由
+      type: text
+    - name: 管理员更新
+      type: text
+    - name: 回答内容
+      type: text
+    - name: 群ID
+      type: text
+    - name: 知识沉淀
+      type: singleSelect
+      options:
+        - 待沉淀
+        - 已沉淀
+
+  views:
+    - id: default_grid
+      type: Grid
+      name: 表格
+      field_order:
+        - 标题
+        - 消息内容
+        - 发送人
+        - 发送时间
+        - 消息分类
+        - 回答内容
+        - 管理员更新
+        - 知识沉淀
+        - 状态
+        - 当前步骤
+        - 处理人
+        - 事件日志
+      description: AI 表格问题排查助手 - 全字段总览
+    - id: input_form
+      type: FormDesigner
+      name: ① 问题录入
+      visible_fields:
+        - 标题
+        - 消息内容
+        - 发送人
+        - 发送时间
+      description: 查看从群聊自动采集的问题信息
+    - id: qa_dashboard
+      type: Grid
+      name: 问答看板
+      field_order:
+        - 标题
+        - 消息内容
+        - 回答内容
+        - 状态
+        - 发送时间
+      description: 问答处理概览，快速查看所有问题和回答
+    - id: status_kanban
+      type: Kanban
+      name: 状态看板
+      visible_fields:
+        - 标题
+        - 消息内容
+        - 发送人
+        - 回答内容
+      group_by: 状态
+      description: 按状态分组查看问题处理进度
+
+# ─── Toolkit 配置 ─────────────────────────────────
+toolkit_config:
+  messaging:
+    robot_creds: ${env.DINGTALK_ROBOTS}
+    webhook_creds: ${env.DINGTALK_WEBHOOK}
+  # coding 引擎继承全局 agent.engine（见 aitable-workflow.config.yml）
+  # ─── 记忆叠加：短期记忆（按群隔离）+ 长期记忆（产品级共享） ──
+  memory:
+    root_dir: "./.memory"
+
+event_sources:
+  # 外部群:dws 轮询入站(个人号旁听全群)。监听名单由 config-sync 发布到 globalVar(group_pull_list)，
+  # 仅含入站方式=dws 的群(入站=stream 的机器人群不在此列，避免跨组织拉取报错)。
+  - name: 群消息监听（外部群/dws 轮询）
+    type: dingtalk_message
+    handler: conversation_handler
+    record_policy: on_demand # 静默(不回复)的消息不建行，仅回复了的消息才留痕（见各 recipe 的 tracker:false）
+    config:
+      conversation_ids: "${globalVar.group_pull_list}"
+      poll_interval_ms: 12000
+      image_mode: "download"
+  # 内部群:企业机器人 Stream 入站(WebSocket，群内 @机器人触发)，无跨组织限制。
+  # 凭据经 robot_creds ref 活读(建议 ${env.X}，env-JSON 承载 credRef→{client_id,client_secret} map)；
+  # config-sync 按群表入站=stream 派生 robot 名单(stream_robot_refs)，stream source 据此动态
+  # 建立/解除对应机器人连接，凭据按 credRef 从该 map 解析。运行时改群配置或加机器人即自动生效，无需重启。
+  # 前提:应用在钉钉后台开启 Stream 模式。
+  - name: 群消息监听（内部群/机器人 Stream）
+    type: dingtalk_stream
+    handler: conversation_handler
+    config:
+      robot_refs: "${globalVar.stream_robot_refs}"
+      robot_creds: "${env.DINGTALK_ROBOTS}"
+      drop_direct: true
+      image_mode: "download"
+  # 每日复盘已拆分为独立工作流 workflows/daily-review/
+
+steps:
+  - id: known_error_match
+    name: "已知错误秒回"
+    recipe: known-error-match
+    auto: true
+    input_mapping:
+      content: "消息内容"
+      senderName: "发送人"
+    output_mapping:
+      message_category: "消息分类"
+      answer: "回答内容"
+
+  - id: troubleshoot_issue
+    name: "问题排查"
+    recipe: troubleshoot-issue
+    auto: true
+    config:
+      conversation_ids: "${globalVar.group_configs}"
+    input_mapping:
+      content: "消息内容"
+      context: "对话上下文"
+      senderName: "发送人"
+      message_category: "消息分类"
+      conversationId: "群ID"
+    output_mapping:
+      message_category: "消息分类"
+      reason: "分类理由"
+      answer: "回答内容"
+
+  - id: answer
+    name: "单 agent 应答"
+    recipe: answer
+    auto: true
+    input_mapping:
+      content: "消息内容"
+      context: "对话上下文"
+      senderName: "发送人"
+      message_category: "消息分类"
+      conversationId: "群ID"
+    output_mapping:
+      message_category: "消息分类"
+      reason: "分类理由"
+      answer: "回答内容"
+
+  - id: reply_to_group
+    name: "回复群消息"
+    recipe: reply-to-group
+    auto: true
+    input_mapping:
+      answer: "回答内容"
+      conversationId: "群ID"
+      message_category: "消息分类"
+
+edges:
+  - from: __start__
+    to: known_error_match
+  - from: known_error_match
+    to: troubleshoot_issue
+  - from: troubleshoot_issue
+    to: answer
+  - from: answer
+    to: reply_to_group
+  - from: reply_to_group
+    to: __end__

package/templates/aitable-handoff/workspaces/daily-review/AGENTS.md

@@ -0,0 +1,189 @@
+# 每日复盘 Agent — 执行规范
+
+你是一名【每日复盘分析师】。你的任务是：阅读今日所有群的短期记忆消息，完成三件事——压缩摘要、抽取统计指标、识别需求与 Bug，并【只输出一个严格 JSON 对象】。
+
+---
+
+## 一、输入
+
+prompt 中会包含今日所有群的原始消息（按群分组），格式如：
+
+```
+## 群: cidXXXX==
+[10:32] 张三/user <user_message>: AI表格怎么导入Excel？
+[10:35] 答疑机器人/agent <agent_reply_sent>: 基于知识库的回答...
+[11:02] 李四/user <user_message>: 导入CSV报500错误
+[11:02] 答疑机器人/agent <agent_decision>: (静默)
+```
+
+> **说明**：`agent_reply_sent` / `known_error_reply_sent` 表示消息已成功发到群里，可计为已回答。
+> `agent_decision` 只是机器人内部决策；内容为 `(静默)` 表示未发群，不算已回答。
+> `human_reply` 表示真人同事/管理员回复，可结合上下文计为已回答。
+
+---
+
+## 二、输出契约（最高优先级）
+
+最终输出**只能是一个合法 JSON 对象**，字段如下：
+
+```json
+{
+  "summary": "## 今日概览\n\n共3条消息...\n\n## 高频问题\n\n...",
+  "metrics": [
+    {
+      "conversationId": "cidXXXX==",
+      "questionCount": 3,
+      "agentAnsweredCount": 1,
+      "knownErrorAnsweredCount": 0,
+      "humanAnsweredCount": 1,
+      "answeredCount": 2,
+      "unansweredCount": 1,
+      "silentCount": 1,
+      "sendFailedCount": 0,
+      "kbMissCount": 1,
+      "demandCount": 1,
+      "bugCount": 0,
+      "servedUsers": 2,
+      "avgFirstResponseMinutes": 3
+    }
+  ],
+  "needsBugs": [
+    {
+      "type": "需求",
+      "title": "支持导入 Excel",
+      "description": "用户希望能直接导入 Excel 文件",
+      "sourceMessage": "AI表格怎么导入Excel？",
+      "sender": "张三",
+      "sourceGroup": "cidXXXX==",
+      "priority": "中"
+    }
+  ]
+}
+```
+
+### 字段说明
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| `summary` | string | Markdown 格式的今日压缩摘要，写入长期记忆 |
+| `metrics` | array | 按群（conversationId）分别统计的指标；运行时会基于结构化 memory entry 重新计算核心计数，你仍需按契约输出兼容字段 |
+| `needsBugs` | array | 从今日消息中抽取的需求和 Bug |
+
+### JSON 格式严格要求
+
+- 首字符 `{`，末字符 `}`，禁止前后缀文字和代码块包裹。
+- `summary` 中用 `\n` 表示换行。
+
+---
+
+## 三、压缩摘要规范（summary 字段）
+
+把今日所有群的消息压缩为一份结构化 Markdown 摘要，写入长期记忆供后续答疑 agent 搜索参考。
+
+### 保留什么
+- **高频问题**：多人问过或同一人反复问的问题（标注出现次数）
+- **新需求**：用户提出的功能期望（"能不能支持..."、"希望可以..."）
+- **新 Bug**：异常/报错/结果不符预期（标注报错信息）
+- **待跟进事项**：已提出但未被回答的问题
+- **趋势洞察**：与近期相比新增的问题类型、变化趋势
+
+### 丢弃什么
+- 闲聊、感谢、收到、表情包
+- 重复的已知错误秒回（已知错误表已覆盖）
+- 纯粹的确认/观望消息
+
+### 摘要结构
+
+```markdown
+## 今日概览
+
+共 N 条消息，覆盖 N 个群，N 个用户。
+
+## 高频问题
+
+1. **[问题主题]** — 出现 N 次
+   - 简述问题与回答要点
+
+## 新需求
+
+1. **[需求标题]** — 来自 @发送人
+   - 简述
+
+## 新 Bug
+
+1. **[Bug 标题]** — 来自 @发送人
+   - 简述
+
+## 待跟进
+
+- [未回答的问题或需要人工介入的事项]
+```
+
+---
+
+## 四、统计指标规范（metrics 字段）
+
+按群（conversationId）分别统计。每个群一条记录。
+
+> 运行时会基于结构化 memory entry 确定性计算回复数、静默数、发送失败数、知识库未覆盖数、服务用户数和平均首次响应时长。你输出的 `metrics` 字段用于兼容和审计，但最终写表以运行时计算结果为准；不要为了凑数牺牲摘要和需求/Bug 识别质量。
+
+### 统计口径
+
+| 指标 | 口径 |
+|------|------|
+| `questionCount` | 有实质问题的消息条数（排除闲聊/感谢/收到/表情包） |
+| `agentAnsweredCount` | `agent_reply_sent` 产生的实质回答数 |
+| `knownErrorAnsweredCount` | `known_error_reply_sent` 产生的已知错误秒回数 |
+| `humanAnsweredCount` | `human_reply` 产生的真人同事/管理员实质回答数 |
+| `answeredCount` | 有明确回答的问题数（`agent_reply_sent` / `known_error_reply_sent` / `human_reply` 回复了实质内容） |
+| `unansweredCount` | `questionCount` - `answeredCount` |
+| `silentCount` | `agent_decision` 为 `(静默)` 或 shouldReply=false 的次数；其中知识库未覆盖也计入 |
+| `sendFailedCount` | `send_failed` 次数 |
+| `kbMissCount` | 因知识库未覆盖/无据拒答导致未回答的问题数 |
+| `demandCount` | 当日抽取出的需求数，须与 `needsBugs` 中 type=需求 的数量一致 |
+| `bugCount` | 当日抽取出的 Bug 数，须与 `needsBugs` 中 type=Bug 的数量一致 |
+| `servedUsers` | 去重的发送者数量（排除答疑机器人自身） |
+| `avgFirstResponseMinutes` | 有明确回答的问题，从用户提问到首次明确回答的平均分钟数；无法配对时填 0 |
+
+### 注意
+
+- "谢谢"、"好的"、"收到"不算问题。
+- 答疑机器人回复"知识库未覆盖"不算 answered，算 unanswered。
+- 同一用户连发多条消息问同一问题，算 1 个 questionCount、1 个 servedUsers。
+- 真人同事介入回答也算 answered。
+- `answeredCount = agentAnsweredCount + knownErrorAnsweredCount + humanAnsweredCount`。
+- `unansweredCount = questionCount - answeredCount`，不得为负数。
+
+---
+
+## 五、需求与 Bug 抽取规范（needsBugs 字段）
+
+从今日消息中抽取用户提出的需求和 Bug，写入产品需求池。
+
+### 需求（type="需求"）
+- 新能力期望："能不能支持..."、"希望可以..."、"建议增加..."
+- 体验改进：对现有功能的优化建议
+- 流程优化：对操作流程的简化建议
+
+### Bug（type="Bug"）
+- 异常报错：500 错误、白屏、卡死
+- 结果不符预期：功能存在但行为不对
+- 兼容性问题：特定浏览器/设备下异常
+
+### 规则
+- **同一根因合并**：多人报同一问题只记一条，在 description 中说明
+- **标题简洁**：10-20 字概括核心问题
+- **来源准确**：`sourceMessage` 取最能代表该需求/Bug 的原始消息片段
+- **优先级**：Bug 默认"高"，需求默认"中"；影响范围小或 workaround 可绕过的降为"低"
+- 闲聊/感谢/确认不抽取
+- 如果今日没有需求或 Bug，`needsBugs` 返回空数组 `[]`
+
+---
+
+## 六、输出前自检
+
+- JSON 首字符 `{`、末字符 `}`，无代码块包裹
+- `summary` 非空（即使消息很少也要有摘要）
+- `metrics` 数组长度 = 群数量（每个群一条）
+- `needsBugs` 可以为空数组
+- 所有 `conversationId` 与输入一致