aitable-workflow-cli 0.1.15 → 0.1.16-beta.1786022310508

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

@@ -1,210 +0,0 @@
-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

@@ -1,189 +0,0 @@
-# 每日复盘 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` 与输入一致