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

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

ToolResult に artifacts リストを返すツールは、ダウンロード可能なファイルを生成します。エージェントは特別な指示を必要としません — アーティファクト作成はツール実行の自然な副作用です。 一般的なプロデューサー:
ツールアーティファクト型例
python_exec画像、HTML、CSV、JSONmatplotlibチャートをPNGとして保存
template_renderHTMLフォーマットされたレポート
コード実行ツール任意のファイル生成されたコード、エクスポートされたデータ
画像生成画像AI生成イラスト
ツールがアーティファクトを生成すると、会話内にダウンロード可能な添付ファイルとしてインラインで表示されます。すべてのアーティファクトは、会話間での閲覧用にアーティファクトギャラリーにも収集されます。

​
ギャラリー

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

​
フィルタリング

4つのタイプフィルターでビューを絞り込めます:
フィルターファイルタイプ
すべてすべてのファイル
画像PNG、JPG、GIF、SVG、WebP
HTMLHTMLページとレポート
コードPython、JavaScript、TypeScript、JSON、YAML、XML、CSS、SQL、Markdown、シェルスクリプト
ファイルその他すべて — CSV、PDF、プレーンテキスト、バイナリファイル

​
プレビュー

任意のアーティファクトをクリックしてインラインプレビューを開きます：
  • 画像 — フル解像度でレンダリング
  • HTML — サンドボックス化されたiframe内に表示（スクリプトは分離）
  • コード — 言語検出による構文ハイライト
  • Markdown — フォーマットされたテキストとしてレンダリング
  • その他 — プレーンテキストまたはダウンロードプロンプトとして表示
矢印キーを使用してアーティファクト間を移動します。Escapeキーを押してプレビューを閉じます。

​
メタデータ

各アーティファクトには以下が表示されます：
  • ファイル名とサイズ
  • 作成タイムスタンプ
  • ソース会話（生成されたときの会話に戻るためにクリック）

​
ストレージ

アーティファクトはサーバーのファイルシステムの uploads/conversations/{conversation_id}/artifacts/ に保存されます。各アーティファクトには UUID ベースのファイル名が付与され、URL は推測不可能になります。ファイルは直接提供されます。個別のアーティファクトのデータベースレコードはなく、ストレージレイヤーはシンプルで高速です。

​
API

エンドポイント説明
GET /api/artifacts現在のユーザーのすべてのアーティファクトをリストします。?page=、?size=、?type= フィルターをサポートしています
GET /api/conversations/{id}/artifacts特定の会話のアーティファクトをリストします
GET /api/conversations/{id}/artifacts/{artifact_id}特定のアーティファクトをダウンロードします