用途:将工作区中的文件发送到当前对话频道,供用户下载或查看。
主要能力与规则:文件必须已存在于工作区;仅允许发送工作区或 agent-workspace 内的文件,禁止使用 ../ 等路径穿越;超过配置大小上限的文件会被拒绝,默认上限为 25 MB;若配置了扩展名白名单,则只有匹配类型的文件可发送;管理员可能禁用该技能,若收到 disabled 错误,应告知用户文件发送不可用;脚本运行时间不超过 30 秒,若挂起应执行 stop_bash。
使用方式:调用脚本并传入参数。
${HOME}/.agents/skills/send-file/scripts/send-file.ts
--session-id "$SESSION_ID"
--file-path "relative/path/to/file.png"
--caption "Optional description of the file"
参数:--session-id 必填,取自 $SESSION_ID 环境变量;--file-path 必填,为相对于工作区根目录的文件路径;--caption 可选,为随文件发送的文本说明。
示例:
${HOME}/.agents/skills/send-file/scripts/send-file.ts
--session-id "$SESSION_ID"
--file-path "output/chart.png"
${HOME}/.agents/skills/send-file/scripts/send-file.ts
--session-id "$SESSION_ID"
--file-path "exports/report.pdf"
--caption "Here is the report you requested"
适用场景:需要把生成的图片、报告、导出文件等交付给当前会话用户时。
限制:文件须预先存在且位于工作区内;受大小上限、扩展名白名单与管理员开关约束;脚本有 30 秒超时。其他平台支持范围、具体配置项与错误码细节暂未提供。