References

ファイルの種類と制限

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

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

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

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

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

サイズは 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 → 画像ライブラリ → Upload	4 MB	JPEG (.jpg, .jpeg), PNG, GIF, BMP, TIFF (.tif, .tiff), WebP
Design → ビジュアルエディター → 画像を選択 → 画像ツール → 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 ワールド公開用カバー	3 MB	ブラウザによって画像として認識される画像ファイル。

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

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

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

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

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

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

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

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

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