Agent 研习舱
Harness 与运行时2026-07-11

Artifact

定义

Artifact 是 Agent 产出的正式结果,作为一等协议对象存在,回答"结果在哪里、由哪次执行产生"。长任务的结果不应只塞进最终文本,而要成为可引用、可追溯、可版本化的产物——文件、报告、代码 diff 等。

要点

  • 状态五层中的产物层:与 Conversation / Run State / Checkpoint / Semantic Memory 并列,关注生命周期、权限、可追溯。
  • 在 A2A 中 Artifact 与 Task 状态机一起构成跨 Agent 协作的核心;在 Harness 里 Virtual Filesystem / Workspace 把中间结果与最终产物沉淀为可恢复状态。
  • 归属需明确:多个 Run 生成同名文件时,哪个是正式产物、如何标记分支与最终采纳关系,必须写进协议语义。
  • 与 Workspace/Sandbox 相关但不同——Workspace 是 Agent 可读写的工作区状态(文件、代码仓库、浏览器页面),Artifact 是其中被提升为正式产物的部分。

示例

一次研报生成任务的最终 PDF、一次编码任务的 code diff,都应作为带 run_id 归属的 Artifact 暴露,而非仅作为对话里的一段文本,从而支持前端引用、审计追溯和评测。

相关概念

参考资料

  • 主笔记:Agent Runtime Protocol 稳定对象〔待补〕

来自本站知识库 · 全部概念