Files
dingtalk-workspace-cli/skills/multi/dingtalk-chat/references/intent-guide.md
T
Dennis 017258e5b4 feat(im): optimize Multi IM golden routes
Unify natural target resolution and message contracts, add deterministic IM event listening, streamline cold-start skills, and cover the flows with schema gates and end-to-end tests.
2026-08-03 14:54:19 +08:00

52 lines
2.8 KiB
Markdown

# Chat 低频意图消歧
只在根 Skill 的 Golden Route 无法区分相邻能力时读取。命令 flags 和安全语义以精确 leaf Schema/Runtime 为准。
## 消息选择
| 用户终点 | 选择 | 不要混用 |
|---|---|---|
| 给姓名发简单文本 | `+dm` | 先查人再原子发送 |
| 给群名发简单文本 | `+send-to-group` | 先搜群再原子发送 |
| 文件、Bot、Webhook、复杂 @、幂等 | `+messages-send` | 为不同身份各走一套原子入口 |
| 浏览指定会话 | `+chat-messages` | 跨会话搜索命令 |
| 跨会话或多维过滤 | `+search-msg` | 单会话浏览命令 |
| 已知消息 IDs 取详情 | `+messages-mget` | 重新搜索关键词 |
| @我的消息 | `+at-me` | 全量消息后本地猜测 @ |
| 已知 thread/topic ID 的回复 | `+thread-replies` | 普通消息列表 |
| 引用回复一条消息 | `+messages-reply` | 普通发送 |
| 单条/合并/话题转发 | `+messages-forward` / `+messages-combine-forward` / `+messages-forward-topic` | 复制正文重新发送 |
| 流式卡片创建或更新 | `+messages-send-card` / `+messages-update-card` | 普通 text/Markdown 发送 |
## 对象层级
| 用户终点 | 对象 | Reference |
|---|---|---|
| 收藏或取消收藏 | 当前用户的 Favorite | [chat-message.md](chat/chat-message.md) |
| Pin/Unpin 一条消息 | 消息 Pin | [chat-message.md](chat/chat-message.md) |
| 置顶/取消置顶一条消息 | 消息 Top | [chat-message.md](chat/chat-message.md) |
| 置顶/取消置顶整个会话 | 会话 Top | [chat-conversation.md](chat/chat-conversation.md) |
| 查看置顶会话 | 会话列表 | `+conversation-list-top` |
| 标记消息已读 | 消息读取状态 | [chat-message.md](chat/chat-message.md) |
| 清红点、标记会话未读 | 会话状态 | [chat-conversation.md](chat/chat-conversation.md) |
Favorite、消息 Pin、消息 Top 和会话 Top 不能互换,即使用户都说“收藏/钉住/置顶”。
## 群与机器人
| 用户终点 | 选择 |
|---|---|
| 已有成员 IDs 创建群 | `+chat-create` |
| 加人、踢人、管理员、群公告、群设置 | [chat-group.md](chat/chat-group.md) |
| 找可用机器人并取得单聊 ID | `chat bot find`,不是只查自己创建机器人的 `bot search` |
| 已知 robotCode 发送 | `+messages-send --as bot` |
| 机器人入群、移除、批量群发或撤回 | [chat-bot.md](chat/chat-bot.md) |
## 跨产品边界
- 紧急 DING、短信或电话:切 `dingtalk-misc`,不要当普通 Chat 消息。
- 邮件:切 `dingtalk-mail`。
- 只查询人员资料或把姓名解析成 ID:切 `dingtalk-contact`;若终点只是简单发消息,直接留在 Chat 使用 `+dm`。
- 企业知识跨文档、消息、邮件搜索:切 `dingtalk-aisearch`;明确只搜聊天消息时使用 `+search-msg`。
- 文档翻译先由文档产品读取正文;`chat text translate` 只处理纯文本。