juhecli-msg 企微消息

使用案例

概述

企微消息 SKILL 提供全面的企业微信消息发送和管理功能，支持多种消息类型： 文本、图片、文件、链接、语音、位置和群@消息。同时支持消息撤回和已读确认。

触发方式

用户可能会这样自然地表达需求：

• "给张三发消息hello"
• "发送图片给李四"
• "撤回消息"
• "在群里@张三"
• "给技术部群发个文件"
• "把这篇文章发给王五"

命令列表

详细命令说明

发送文本消息 (msg send_text)

向指定对话发送文本消息。是最常用的消息发送命令。用户只需告诉 Agent 发给谁、发什么内容。

参数

返回值

• msgid — 消息 ID，Agent 保存此值以备撤回时使用
• 发送状态

发送图片消息 (msg send_image)

向指定对话发送图片。需要先通过上传接口获取 file_id 等参数。

参数

发送文件消息 (msg send_file)

向指定对话发送文件。与图片类似，需要先上传获取文件参数。

参数

发送链接消息 (msg send_link)

向指定对话发送链接卡片消息。用户提供链接标题、描述和地址。

参数

发送位置消息 (msg send_location)

向指定对话发送位置信息。用户提供位置名称、地址和经纬度。

参数

发送语音消息 (msg send_voice)

向指定对话发送语音消息。语音文件需先上传获取参数。

参数

发送群@消息 (msg send_room_at)

向群聊发送@消息，可@特定成员或所有人。

参数

撤回消息 (msg revoke)

撤回已发送的消息。需使用发送消息时返回的 msgid。Agent 应自动保存每次发送消息的 msgid。

参数

确认已读 (msg confirm)

标记消息为已读状态。

参数

参数来源说明

Agent 交互示例

发送文本消息

用户: "给张三发消息：明天开会"
AI: 好的，先搜索张三的联系方式...
   [Agent 调用 contact search，keyword: "张三"]
   找到张三 (user_id: zhangsan)

   [Agent 调用 msg send_text，conversation_id: "S:zhangsan", content: "明天开会"]
   消息已发送给张三！

发送文件

用户: "把报告.pdf发给技术部群"
AI: 好的，正在处理...
   [Agent 上传文件，获取 file_id、aes_key、md5、size]
   [Agent 查找技术部群的 room_id]
   [Agent 调用 msg send_file，conversation_id: "R:room123", file_name: "报告.pdf", ...]
   文件"报告.pdf"已发送到技术部群！

发送群@消息

用户: "在技术部群@所有人：明天10点开会"
AI: 好的，正在发送...
   [Agent 查找技术部群的 room_id 和群成员信息]
   [Agent 调用 msg send_room_at，conversation_id: "R:room123", content: "明天10点开会", at_list: ["@all"]]
   群@消息已发送到技术部群！

撤回消息

用户: "撤回刚才那条消息"
AI: [Agent 使用发送时保存的 msgid]
   [Agent 调用 msg revoke，conversation_id: "S:zhangsan", msgid: "msg_001"]
   消息已撤回。

典型工作流

搜索联系人后发送文本

1. 用户说"给张三发消息：明天开会"
2. Agent 调用 contact search 查找张三，获取 user_id
3. Agent 构建 conversation_id（S:user_id）
4. Agent 调用 msg send_text 发送消息
5. Agent 保存返回的 msgid 以备撤回
6. Agent 向用户确认消息已发送

// 完整工作流示例

用户: "给张三发消息hello"
AI: [Agent 调用 contact search，keyword: "张三"]
   找到张三 (user_id: zhangsan)

   [Agent 调用 msg send_text，conversation_id: "S:zhangsan", content: "hello"]
   消息已发送给张三！(msgid: msg_001，如需撤回请告诉我)

发送图片/文件

1. 用户说"把这张图片发给技术部群"
2. Agent 上传文件获取 file_id 等参数
3. Agent 查找技术部群的 room_id
4. Agent 调用 msg send_image 或 msg send_file 发送

撤回消息

1. 用户说"撤回刚才那条消息"
2. Agent 使用发送时保存的 msgid
3. Agent 调用 msg revoke 撤回
4. 如超过时限，告知用户无法撤回

错误处理