> ## 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ファイルを参照、プレビュー、ダウンロードします。

アーティファクトは、会話中にAIエージェントが生成するファイル — 画像、HTMLページ、コードファイル、ドキュメント、その他の出力です。アーティファクトページは、会話全体にわたるギャラリーで、エージェントが作成したすべてのファイルを検索、プレビュー、ダウンロードできます。

## アーティファクトの作成方法

`ToolResult` に `artifacts` リストを返すツールは、ダウンロード可能なファイルを生成します。エージェントは特別な指示を必要としません — アーティファクト作成はツール実行の自然な副作用です。

一般的なプロデューサー:

| ツール               | アーティファクト型        | 例                       |
| ----------------- | ---------------- | ----------------------- |
| `python_exec`     | 画像、HTML、CSV、JSON | matplotlibチャートをPNGとして保存 |
| `template_render` | HTML             | フォーマットされたレポート           |
| コード実行ツール          | 任意のファイル          | 生成されたコード、エクスポートされたデータ   |
| 画像生成              | 画像               | AI生成イラスト                |

ツールがアーティファクトを生成すると、会話内にダウンロード可能な添付ファイルとしてインラインで表示されます。すべてのアーティファクトは、会話間での閲覧用にアーティファクトギャラリーにも収集されます。

## ギャラリー

アーティファクトページ（`/artifacts`）は、すべての会話で生成したすべてのファイルの統合ビューを提供します。

### フィルタリング

4つのタイプフィルターでビューを絞り込めます:

| フィルター    | ファイルタイプ                                                              |
| -------- | -------------------------------------------------------------------- |
| **すべて**  | すべてのファイル                                                             |
| **画像**   | PNG、JPG、GIF、SVG、WebP                                                 |
| **HTML** | HTMLページとレポート                                                         |
| **コード**  | Python、JavaScript、TypeScript、JSON、YAML、XML、CSS、SQL、Markdown、シェルスクリプト |
| **ファイル** | その他すべて — CSV、PDF、プレーンテキスト、バイナリファイル                                   |

### プレビュー

任意のアーティファクトをクリックしてインラインプレビューを開きます：

* **画像** — フル解像度でレンダリング
* **HTML** — サンドボックス化されたiframe内に表示（スクリプトは分離）
* **コード** — 言語検出による構文ハイライト
* **Markdown** — フォーマットされたテキストとしてレンダリング
* **その他** — プレーンテキストまたはダウンロードプロンプトとして表示

矢印キーを使用してアーティファクト間を移動します。Escapeキーを押してプレビューを閉じます。

### メタデータ

各アーティファクトには以下が表示されます：

* ファイル名とサイズ
* 作成タイムスタンプ
* ソース会話（生成されたときの会話に戻るためにクリック）

## ストレージ

アーティファクトはサーバーファイルシステムに保存され、会話ごとに1つのディレクトリが使用されます。各アーティファクトはUUIDベースのファイル名を取得し、会話へのアクセスなしではURLを推測できないようになっています。ファイルは直接提供されます。個別のアーティファクトのデータベースレコードはなく、ストレージレイヤーはシンプルで高速です。