55 lines
1.4 KiB
Markdown
55 lines
1.4 KiB
Markdown
|
---
|
|||
|
|
name: deliver-artifacts
|
|||
|
|
description: Deliver artifacts (files/images/voice) to current IM chat via gateway, returning a receipt. Use this as the only delivery proof for attachments. Text replies are sent automatically - only use this for file/image/voice attachments.
|
|||
|
|
system: true
|
|||
|
|
handler: im_channel
|
|||
|
|
tool-name: deliver_artifacts
|
|||
|
|
category: IM Channel
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
# Deliver Artifacts
|
|||
|
|
|
|||
|
|
通过网关向当前 IM 聊天交付附件（文件/图片/语音），并返回结构化回执。
|
|||
|
|
|
|||
|
|
## Important
|
|||
|
|
|
|||
|
|
- **文本回复**由网关直接转发，不需要用工具发送
|
|||
|
|
- **附件交付**必须使用本工具，回执是"已交付"的唯一证据
|
|||
|
|
|
|||
|
|
## Parameters
|
|||
|
|
|
|||
|
|
| 参数 | 类型 | 必填 | 说明 |
|
|||
|
|
|-----|------|-----|------|
|
|||
|
|
| artifacts | array | 是 | 要交付的附件清单 |
|
|||
|
|
| mode | string | 否 | send 或 preview（默认 send） |
|
|||
|
|
|
|||
|
|
### Artifact Item
|
|||
|
|
|
|||
|
|
| 字段 | 类型 | 必填 | 说明 |
|
|||
|
|
|-----|------|-----|------|
|
|||
|
|
| type | string | 是 | file / image / voice |
|
|||
|
|
| path | string | 是 | 本地文件路径 |
|
|||
|
|
| caption | string | 否 | 说明文字 |
|
|||
|
|
|
|||
|
|
## Examples
|
|||
|
|
|
|||
|
|
**发送截图**:
|
|||
|
|
```json
|
|||
|
|
{
|
|||
|
|
"artifacts": [{"type": "image", "path": "data/temp/screenshot.png", "caption": "页面截图"}]
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
**发送文件**:
|
|||
|
|
```json
|
|||
|
|
{
|
|||
|
|
"artifacts": [{"type": "file", "path": "data/out/report.md"}]
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## Related Skills
|
|||
|
|
|
|||
|
|
- `browser-screenshot`: 网页截图
|
|||
|
|
- `desktop-screenshot`: 桌面截图
|
|||
|
|
- `get-voice-file`: 获取语音文件
|