AGENT SKILL

artifact-usage

产物(artifact)的存取规范:artifact.put 保存内容与审批语义,artifact.get 读取产物

License 许可
Apache-2.0
最近更新
2026-10-16
Stars
★ 108
Forks
23

01 前言 Front Matter

name
artifact-usage
tags
[ "artifact", "storage", "approval" ]
category
general
description
产物(artifact)的存取规范:artifact.put 保存内容与审批语义,artifact.get 读取产物
when_to_use
需要保存报告/导出结果/留存文件,或读取已保存产物的详细内容时

03 SKILL.md 正文

产物存取规范

何时使用

  • 需要把较长的结果(报告、导出内容、大段文本)保存下来交付用户时:用 artifact.put;
  • 需要查看已保存产物的完整内容(如上下文中被截断外置的产物引用)时:用 artifact.get。

artifact.put(写产物,risk=high)

  1. 必须经人工审批:该工具会触发审批中断,先向用户说明要保存什么,再发起调用;
  2. 参数:content(内容本体,必填)、media_type(媒体类型,默认 text/plain)、 summary(一句话摘要,缺省自动截取内容开头)、metadata(来源、标签等附加信息);
  3. 审批被拒绝时不要以同一内容反复重试,先与用户确认意图;
  4. 返回的 artifact_id 与 uri 是后续引用的凭证,回答中应带上摘要与引用。

artifact.get(读产物,risk=medium)

  1. 按 artifact_id(art- 前缀)读取产物的元数据与内容本体;
  2. 上下文中出现产物引用(如大段工具结果被截断外置)时,用它取回全文再继续处理;
  3. 产物不存在会返回 ARTIFACT_NOT_FOUND,不要反复重试,向用户确认产物 ID。

04 同仓库更多 Skills