工件

工件是智能体在对话过程中生成的文件——图像、HTML页面、代码文件、文档和其他输出。工件页面是一个跨对话库，让您可以查找、预览和下载智能体创建的所有内容。

​

工件如何创建

任何返回包含 artifacts 列表的 ToolResult 的工具都会生成可下载的文件。智能体不需要特殊指令 — 工件创建是工具执行的自然副作用。 常见生产者： 当工具生成工件时，它会作为可下载的附件内联显示在对话中。所有工件也会被收集在工件库中，以便跨对话浏览。

​

画廊

Artifacts 页面（/artifacts）提供了您在所有对话中生成的所有文件的统一视图。

​

筛选

四种类型筛选器可以缩小视图范围：

​

预览

点击任何工件以打开内联预览：

• 图像 — 以全分辨率呈现
• HTML — 在沙箱 iframe 中显示（脚本隔离）
• 代码 — 带有语言检测的语法高亮
• Markdown — 呈现为格式化文本
• 其他 — 显示为纯文本或下载提示

使用箭头键在工件之间导航；按 Escape 关闭预览。

​

元数据

每个工件显示：

• 文件名和大小
• 创建时间戳
• 源对话（点击可导航回生成该工件的对话）

​

存储

工件存储在服务器文件系统上，每个对话一个目录。每个工件都获得一个基于 UUID 的文件名，使得没有访问对话的情况下无法猜测 URL。文件直接提供服务 — 没有单个工件的数据库记录，保持存储层简单快速。