把Agent生成的大型文件存为版本化artifact

目标

避免把大文件反复塞入提示，同时支持按会话和版本取回文件。

步骤

1. 选定artifact service后端，确定应用、用户和会话的存储隔离。 [artifact]
2. 在工具中用 await ctx.save_artifact(filename, part) 保存Part；不要把大payload作为普通文本返回。 [artifact]
3. 把文件名和版本号返回；用 await ctx.load_artifact(filename, version=n) 按需读取指定版本。 [artifact]
4. 设置大小、类型、保留和删除规则，防止上传的文件被无限保留。 [artifact]

验证方式

保存后只在模型上下文中出现artifact引用；取回内容与选定版本一致。

故障处理

若文件内容被截断，核对MIME类型与Part格式；若版本错配，显式传递并验证版本号。