意图路由指南

当用户请求难以判断归属哪个产品时，参考本指南。

易混淆场景快速对照表

用户说...	真实意图	应该用	不要用	理由
"搜一下 OAuth2 接入文档"	搜索开发文档	`devdoc`	—	搜索开放平台技术文档，不是钉钉内部内容
"帮我建一个项目跟踪表"	创建数据表格	`aitable`	`todo`	涉及结构化数据/行列操作，不是个人待办
"帮我记一下明天要做的事"	创建个人待办	`todo`	`aitable`	个人待办提醒，非数据表
"帮我建一个明天下午的日程"	日历日程	`calendar`	—	日历日程管理（可含参与者/会议室）
"帮我看看收到的日报"	日志收件箱	`report`	`todo`	钉钉日志系统（日报/周报），不是待办
"帮我创建一个待办提醒"	个人待办	`todo`	`report`	个人任务提醒，不是日志汇报
"帮我提交请假审批"	发起审批	`oa`	—	审批流程，不是待办或日志
"帮我建一个项目群"	创建群聊	`chat group create`	—	群聊管理，不是日历日程
"把张三拉进群"	添加群成员	`chat group members add`	—	先查 userId，再添加
"让机器人在群里发个通知"	机器人群发	`chat message send-by-bot`	`chat message send-by-webhook`	企业内部机器人发消息，需 robotCode
"通过 Webhook 发告警到群里"	Webhook 告警	`chat message send-by-webhook`	`chat message send-by-bot`	自定义机器人 Webhook，需 token
"给张三发一条机器人单聊消息"	机器人单聊	`chat message send-by-bot --users`	—	机器人批量单聊，先查 userId

典型场景详解

1. aitable vs todo — 表格数据 vs 待办任务

用 aitable 的场景：

"创建一个表格记录团队成员信息" — 结构化数据，有行列
"在表格里加一列'状态'字段" — 字段/列操作
"查一下表格里所有优先级为高的记录" — 数据筛选和查询
"用项目管理模板建一个表" — 模板创建
用户提到"多维表"、"Base"、"数据表"、"记录"

用 todo 的场景：

"帮我记一下这周要做的事" — 个人任务管理
"创建一个待办提醒" — 任务提醒

判断关键：有没有行列/字段/记录概念？有→ aitable；个人任务清单 → todo

2. devdoc — 开发文档搜索

用 devdoc 的场景：

"API 调用报错 403 怎么解决" — 开发调试问题
"搜一下 OAuth2 接入文档" — 开放平台技术文档
"CLI 命令出错了怎么办" — CLI 使用错误
用户提到"开发"、"API"、"调用错误"

3. report vs todo — 日志 vs 待办

用 report 的场景：

"帮我看看收到的日报" — 日志收件箱
"帮我写/提交今天的日报（钉钉日志模版）" — 先 report template list / template detail，再 report create
"有什么日志模版" — 查看模版
"看看这个日志的已读统计" — 阅读状态
"我发过的日志有哪些" — 已发送列表 (report sent)
用户提到"日报"、"周报"、"日志"

用 todo 的场景：

"记一下这周要做的事" — 个人任务管理

判断关键：钉钉日志系统(日报/周报模版，含按模版创建汇报)→ report；任务清单→ todo

4. chat 内部 — 两种消息发送方式

用 chat message send-by-bot 的场景：

"让机器人在群里发一条通知" — 机器人身份发群消息
"给张三发一条机器人单聊消息" — 机器人批量单聊

用 chat message send-by-webhook 的场景：

"通过 Webhook 发告警到群里" — 自定义机器人 Webhook
用户有 Webhook Token

判断关键：企业内部机器人→ send-by-bot（需 robotCode）；有 Webhook Token→ send-by-webhook

跨产品工作流路由

以下场景需要多个产品配合完成，注意上下文传递顺序。

创建日程并邀请同事（contact → calendar）

用户说"约张三明天下午开会"：

# 1. 搜索同事 userId
dws contact user search --query "张三" --format json

# 2. 创建日程
dws calendar event create --title "会议" \
  --start "2026-03-15T14:00:00+08:00" --end "2026-03-15T15:00:00+08:00" --format json

# 3. 添加参与者
dws calendar participant add --event <EVENT_ID> --users <USER_ID> --format json

创建待办并指派（contact → todo）

用户说"给张三建个待办"：

# 1. 搜索同事 userId
dws contact user search --query "张三" --format json

# 2. 创建待办
dws todo task create --title "任务内容" --executors <USER_ID> --format json

4.7 KiB Raw Permalink Blame History Unescape Escape