参考文献

ファイルの種類と制限

Atoms にファイルを追加する前に、サイズと形式の要件を確認してください。制限はアップロード先によって異なります。チャット添付、Design 画像、アプリのブランディング、プロフィール画像では、それぞれ異なるルールがあります。

アップロード、プレビュー、処理はそれぞれ別です。アップロードが成功しても、Atoms がプレビューを表示できることや、エージェントがファイル内のすべてを読み取って利用できることは保証されません。

チャット添付とフォルダの制限

アップロード場所または操作	制限	想定される動作
ホームページまたはプロジェクトチャットで、動画を含むファイルを添付する	1 ファイルあたり 100 MB	制限を超えるファイルはスキップされます。他の有効なファイルは引き続きアップロードできます。
ホームページまたはプロジェクトチャットのアップロード領域にフォルダをドラッグする	フォルダのドロップ 1 回あたり 500 ファイル、ネスト 10 階層まで	いずれかの制限を超えると、フォルダのドロップ全体がキャンセルされます。ファイル数を減らすか、フォルダ構造を簡略化してから再試行してください。

フォルダのドロップ制限は、メッセージごとの一般的な添付制限ではありません。フォルダ内の各ファイルにも、チャットのファイルごとのサイズ制限が適用されます。これらのルールはチャットのアップロード領域について説明するものであり、別個の Files パネルのアップロードや、公開済みアプリに訪問者が送信するファイルについてのものではありません。

サイズは Atoms に表示される単位を使用します。これらの判定では、1 MB は 1,048,576 バイトに相当します。記載された最大値ちょうどのファイルはサイズ制限内です。DOCX プレビューの例外については以下で説明します。

動画のアップロード

ホームページまたはプロジェクトチャットに添付する動画ファイルには、同じ 1 ファイルあたり 100 MB の制限 が適用されます。動画が 100 MB を超える場合、アップロードできません。ファイルサイズを小さくしてから再試行してください。

組み込みの動画プレビューは、ブラウザとエンコードの互換性に応じて MP4、WebM、MOV をサポートします。サイズ制限内でアップロードできても、その動画の再生や AI 処理について、再生時間、解像度、エンコードがサポートされることは保証されません。この添付制限は、別個の動画エディターへのインポートや、モデル固有の参照動画の制限を定めるものではありません。

プレビューできるファイル形式

以下の形式には組み込みのプレビュー対応があります。これはプレビューの参考情報であり、アップロード可能な形式や AI 処理でサポートされる形式の完全な一覧ではありません。

ファイルカテゴリ	プレビュー形式	注記
画像	.jpg, .jpeg, .png, .gif, .bmp, .webp, .svg, .avif, .ico	画像アップロードツールでは、対応形式の一覧がこれより狭い場合があります。追加の制限は以下を参照してください。
ドキュメント	.pdf, .docx	DOCX プレビューには 10 MB 未満のファイルが必要です。そのサイズ以上の DOCX ファイルはアップロード自体は成功しても、組み込みの DOCX プレビューは使用できません。
スプレッドシートと表形式データ	.xlsx, .csv	プレビュー対応は、すべてのスプレッドシート機能が再現されることを保証するものではありません。
テキスト、Markdown、コード、設定	.txt, .md、および .js, .ts, .jsx, .tsx, .vue, .html, .css, .py, .json, .yaml, .xml, .sql, .sh などの一般的なソース / 設定形式	表示されているコード / 設定の拡張子は例であり、網羅的な一覧ではありません。
ノートブックと図表	.ipynb, .mmd, .mermaid	Notebook と Mermaid のプレビュー形式です。
音声	.mp3, .wav, .ogg, .aac, .flac	再生はブラウザとエンコードの対応状況にも依存します。
動画	.mp4, .webm, .mov	再生はブラウザとエンコードの対応状況にも依存します。

組み込みプレビューのないファイル

一部のファイル形式はアップロードできますが、直接プレビューできません。例:

アーカイブ: ZIP, RAR, 7Z, TAR
Office ファイル: DOC, XLS, PPT, PPTX
ドキュメント形式: EPUB, RTF
デザインファイル: PSD, AI, FIG, Sketch
画像とメディア: HEIC, HEIF, TIFF, AVI, MKV, M4A

プレビューがないこと自体は、アップロード失敗を意味しません。

アップロードしたファイルにプレビューがない場合は、ダウンロードして対応アプリケーションで開いてください。フォルダ自体には個別のファイルプレビューはありません。代わりにフォルダ内のファイルを開いてください。

追加の画像およびストレージのアップロード制限

使用している特定のツールの制限を確認してください。チャットの制限内に収まるファイルでも、これらの画像コントロールのいずれかでは大きすぎる場合があります。

アップロード場所	画像 1 枚あたりの最大サイズ	形式
Design → image library → Upload	4 MB	JPEG (.jpg, .jpeg), PNG, GIF, BMP, TIFF (.tif, .tiff), WebP
Design → ビジュアルエディター → 画像を選択 → image tool → Upload	5 MB	ファイルピッカーでは PNG、JPG/JPEG、GIF、BMP、WebP が選択できます。
アプリロゴ	5 MB	PNG, JPEG
ソーシャルプレビュー画像	5 MB	PNG, JPEG, WebP
プロフィール画像	2 MB	PNG, JPEG
ワークスペース画像 — デスクトップ	5 MB	PNG, JPEG, WebP
ワークスペース画像 — モバイル	5 MB	PNG, JPEG, WebP, SVG
App World 公開カバー	3 MB	ブラウザで画像として認識される画像ファイル。

Design の image library アップローダーは TIFF を受け付けますが、上記の一般的なファイルプレビュー用画像形式には含まれていません。

Atoms クラウドストレージ: Cloud storage パネルからファイルをアップロードする場合、1 ファイルあたり 100 MB の制限があります。これはチャット添付や、合計ストレージ容量とは別です。また、公開済みアプリに組み込んだアップロード機能の制限を定めるものでもありません。

その他のファイル処理の動作

読み取れない画像。 チャットアップロードでは、一般的なビットマップ画像が読み取れるか確認します。画像を読み取れない場合、その画像はスキップされ、有効な画像を指定するよう求められます。再試行する前に、元のファイルをローカルで開き、新しいコピーとして書き出してください。

長い貼り付けテキスト。 チャットエディターに貼り付けたテキストは、50 行または 2,000 文字に達すると TXT 添付になることがあります。これは自動的な添付変換のしきい値であり、ドキュメントの最大長ではありません。

エージェントでファイルを使う。 プレビューは、そのファイルを表示できることだけを確認するものです。音声の文字起こし、アーカイブの展開、スキャンされたページの読み取り、複雑なドキュメントのすべての要素の解釈がサポートされることを意味するものではありません。

ファイルが拒否された場合、または使用できない場合

発生すること	対処方法
ファイルが大きすぎる	そのアップロード場所の制限を確認してください。圧縮するか、より小さいコピーを書き出すか、可能であれば内容をより小さなファイルに分割してください。元のファイルは保持してください。
フォルダのドロップがファイル数またはネスト制限を超えている	フォルダをより小さなグループに分けるか、ネストしたサブフォルダを減らしてから再試行してください。拒否されたフォルダのドロップは部分的にはアップロードされません。
画像ツールが形式を拒否する	そのツールで一覧表示されている形式のいずれかで画像を書き出してください。ファイル拡張子の名前を変更しても、ファイル形式は変換されません。
Atoms が無効または読み取れない画像と報告する	画像がローカルで開けることを確認してください。画像アプリケーションから再書き出しするか、新しいコピーを入手してから再度アップロードしてください。
「ファイルはアップロードされましたが、プレビューは利用できません」	アップロード自体は成功している可能性があります。上記のプレビュー形式と DOCX プレビューのサイズ制限を確認するか、ファイルをダウンロードしてローカルで開いてください。
音声または動画のプレビューが再生されない	ローカルでの再生とブラウザ互換性を確認してください。必要に応じて、ブラウザ互換のエンコードと、一覧にあるプレビュー形式のいずれかで再書き出ししてください。
エージェントがアップロードしたファイルを期待どおりに使えない	使用してほしい内容を具体的に指定してください。可能であれば、元のファイルの複雑なレイアウトに頼るのではなく、関連するテキストやより単純な書き出しを提供してください。
エラーがストレージ容量に言及している	関連するストレージ使用量と許容量を確認してください。合計容量の問題は、1 ファイルのサイズ制限超過とは別です。

問題が続く場合は、[email protected] まで Atoms サポートにお問い合わせください。アップロード場所、ファイル拡張子、ファイルサイズ、正確なエラーメッセージを含めてください。必要がない限り、機密性の高いファイル内容は共有しないでください。