> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fim.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 工件

> 浏览、预览和下载所有对话中AI生成的文件。

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

## 工件如何创建

任何返回包含 `artifacts` 列表的 `ToolResult` 的工具都会生成可下载的文件。智能体不需要特殊指令 — 工件创建是工具执行的自然副作用。

常见生产者：

| 工具                | 工件类型             | 示例                      |
| ----------------- | ---------------- | ----------------------- |
| `python_exec`     | 图像、HTML、CSV、JSON | 保存为 PNG 的 matplotlib 图表 |
| `template_render` | HTML             | 格式化报告                   |
| 代码执行工具            | 任何文件             | 生成的代码、导出的数据             |
| 图像生成              | 图像               | AI 生成的插图                |

当工具生成工件时，它会作为可下载的附件内联显示在对话中。所有工件也会被收集在工件库中，以便跨对话浏览。

## 画廊

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

### 筛选

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

| 筛选器      | 文件类型                                                                 |
| -------- | -------------------------------------------------------------------- |
| **全部**   | 所有内容                                                                 |
| **图像**   | PNG、JPG、GIF、SVG、WebP                                                 |
| **HTML** | HTML 页面和报告                                                           |
| **代码**   | Python、JavaScript、TypeScript、JSON、YAML、XML、CSS、SQL、Markdown、shell 脚本 |
| **文件**   | 其他所有内容 — CSV、PDF、纯文本、二进制文件                                           |

### 预览

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

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

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

### 元数据

每个工件显示：

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

## 存储

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