name: deliver-artifacts description: 通过网关向当前 IM 聊天交付附件(文件/图片/语音),并返回结构化回执。将此作为附件交付的唯一证明。文本回复由网关直接转发,无需使用此工具 - 仅用于文件/图片/语音附件。 system: true handler: im_channel tool-name: deliver_artifacts category: IM Channel
交付附件
通过网关向当前 IM 聊天交付附件(文件/图片/语音),并返回结构化回执。
重要
- 文本回复由网关直接转发,不需要用工具发送
- 附件交付必须使用本工具,回执是"已交付"的唯一证据
参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| artifacts | 数组 | 是 | 要交付的附件清单 |
| mode | 字符串 | 否 | send 或 preview(默认 send) |
附件项目
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| type | 字符串 | 是 | file / image / voice |
| path | 字符串 | 是 | 本地文件路径 |
| caption | 字符串 | 否 | 说明文字 |
示例
发送截图:
{
"artifacts": [{"type": "image", "path": "data/temp/screenshot.png", "caption": "页面截图"}]
}
发送文件:
{
"artifacts": [{"type": "file", "path": "data/out/report.md"}]
}
相关技能
browser-screenshot: 网页截图desktop-screenshot: 桌面截图get-voice-file: 获取语音文件