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

# レプリゼンテーション

レプリゼンテーションとは、Boxに保存されているファイルの代替アセットです。このようなアセットには、PDF、サムネイル、またはテキスト抽出を使用できます。レプリゼンテーションを使用すると、ドキュメントからテキストを抽出して処理のために言語モデルに送信するなど、ファイルを手動で変換することなく、さまざまな形式のコンテンツにアクセスできます。

レプリゼンテーションは、Boxへのアップロード時またはアセットのリクエスト時に、サポートされているファイルの種類に対して自動的に生成されます。

このようなレプリゼンテーションは、`fields=representations`クエリパラメータと`x-rep-hints`ヘッダーを使用することで、`GET /files/:id`エンドポイントを介して公開されます。

このワークフローでは以下の処理が行われます。

1. <Link href="/guides/representations/list-all-representations">ファイルの利用可能なレプリゼンテーションのリストを取得する。</Link>
2. <Link href="/guides/representations/request-a-representation">特定のレプリゼンテーションのステータスを確認し、その`url_template`を取得する。</Link>
3. <Link href="/guides/representations/download-a-representation">レプリゼンテーションをダウンロードする (利用可能な場合)。</Link>
