容量・入力・実行条件のリファレンス

同じファイルでも、Sessionへの添付とProject Mediaへの公開では上限が異なる。使う保存先とファイル形式を決めてから、この表で確認する。

KiBは1,024 bytes、MiBは1,024 KiB、GiBは1,024 MiBである。「bytes」の上限は文字数とは異なり、日本語などのUTF-8文字は複数bytesになる。各値は入力・保存の制約であり、処理時間や稼働率の保証ではない。

添付とProject Media

Project Mediaの2 GiBは動画の上限であり、画像やPDFにも適用できる上限ではない。サイズ内でも未対応形式や暗号化PDFは拒否される。添付はProject Mediaへ自動公開されず、Mediaのcanonical URLも外部向けpublic shareではない。

容量に加えて、次の内容上の制約がある。たとえば20分のMP4添付や501ページのPDFは、ファイルが小さくても受け付けられない。

対象	内容上の上限
画像	幅・高さそれぞれ12,000 pixels、合計100,000,000 pixels、アニメーション64 frames
PDF	500ページ。PDF streamの展開には64 MiBの上限もある
添付動画	10分
Project Media動画	60分
すべての動画	幅3,840 pixels、高さ2,160 pixels。縦横を入れ替えた同等面積という条件ではない

大きすぎる画像は必要な解像度へ縮小し、PDFは必要なページへ分け、動画は長さやbitrateを調整する。単に拡張子を変えて形式制限を回避しない。MediaとWebUIの添付を参照する。

対象	上限・形式
Project HTMLの1ファイル	5 MiB
Project HTMLのProject総量	50 MiB、500ファイル
Shared Document	1 MiB
文書のkind名	32文字まで。英小文字始まり、英小文字・数字・`_`・`-`
通常のdoc ID	64文字まで。英小文字・数字で始まり、英小文字・数字・`_`・`-`
mindmap	200ノード
brainstorm	100案。各titleは50 Unicode code points、descriptionは200まで
task block	100タスク

画像やPDFなどの完成ファイルはMediaへ置き、HTMLや文書から参照する。HTMLに大きなファイルをbase64として埋め込むと、HTML自体の上限に数えられる。文書が大きくなったら、独立して読める内容ごとに分割してWikiLinkで結ぶ。

PROJECT.mdとREPORT.mdには予約された用途と大文字のpathがある。pathが正しくても、frontmatter構文や権限などの理由で保存できない場合がある。Shared Documents、HTML、Markdownブロックで詳細を確認する。

長い資料をAskのquestionやoptionに詰めず、判断に必要な要約と資料への参照をbodyへ置く。Workflow Decisionの描画済みbodyにもAskのbody上限が適用される。

対象	上限・条件
Bundle内の1ファイル	256 KiB
Bundle全体	1 MiB、128ファイル
Bundle内の相対path	1〜256 UTF-8 bytes
WorkflowのStep数	1〜64
1 Stepの直接依存数	最大32
Workflow全体の依存edge数	最大256。循環は不可
描画済みSession Step prompt	100,000 bytes
completionとRun出力	128 KiB、JSON depth最大32
Attempt feedback body	8,192 bytes
Published Workflowの合成	1段まで。同じProjectの公開済みWorkflowを利用

Bundleのファイル上限と、入力や依存Stepの出力を展開した後のprompt上限は別である。短いtemplateでも、大きなinputを展開すると実行時の上限を超えることがある。長い成果はProjectの文書等へ保存し、Step出力には必要な小さな値と参照を返す。

入力・出力は宣言したschemaに一致させる。objectはadditionalProperties: falseを持つため、次のWorkflowに前の出力を渡すときも必要なキーだけを選ぶ。上限だけを満たしても未宣言キーや型の違いは受け付けられない。操作構文はCLIを参照する。

対象	上限・条件
SQL入力・migration file	100 KiB
query	1 statementのSELECT / INSERT / UPDATE / DELETE
query params	最大100個のstringを持つJSON array。positional `?`で参照
query結果	最大1,000 rows、decoded結果最大1 MiB
migration	最大100 statements。queryとは別の許可構文
WebUIの1ページ	25 / 50 / 100 rows
migration ID	1〜128文字。英小文字・数字で始まり、英小文字・数字・`_`・`-`

query結果の上限を超えた場合、部分結果は返らない。必要な列と行へ絞り、WHEREと適切なLIMITを使う。100個のparamsは一度に100行を書けるという意味ではなく、placeholderへ渡す値の数である。

同じProjectのlive queryは重ねて受け付けない。処理中や成否不明のmutationを繰り返さず、返されたエラーのread指示で現在値を確認する。migrationはschema.sqlの親versionから作り、ファイル同期後に明示的に適用する。

対象	条件
Project Triggerのinterval	最小300秒。終了時刻が必須
既存Sessionのscheduled follow-up	間隔60〜86,400秒
calendar Trigger	IANA timezone、local time、1つ以上の曜日。終了日を指定する場合はその日を含む
Document match	同じProjectのfrontmatterのstring / number / boolean完全一致。複数条件はAND、一回限り

Triggerは新しいSessionまたはPublished Workflowを起動する。scheduled follow-upは既存Sessionへturnを追加する。周期の上限や停止方法を混同しない。時刻条件は作成前にpreviewし、実際の次回時刻を確認する。

まず、どの保存先・入力・結果が制限を超えたかを確認する。ファイル自体のサイズ、UTF-8 bytes、展開後のprompt、SQLの結果サイズは別々である。値を小さくしたり資料へ分離したりした後、操作の結果を再確認する。

上限内でも、権限、対応形式、Project status、空き容量、providerの状態によって操作できない場合がある。権限とTroubleshootingから調べる。成否不明の操作は、サイズを変えた別requestとして送る前に、最初のrequestが受け付けられたか確認する。

一覧	続きを読む方法
Timeline・Session transcript	応答のopaqueな`next.before`を`--before`へ渡す。`--last`の範囲と既定値は各commandを確認する（CLI）
Workflow一覧/Run一覧	`next_cursor`を`--before`へ渡すか、返された`next_command`を辿る（CLI）
Trigger一覧・起動履歴	`--cursor` / `--limit`（1〜100）を使い、一覧の`next_command`または履歴の`next_occurrences_command`がnullになるまで辿る（Triggers）
Project Database WebUI	25 / 50 / 100行の番号付きpage。tableやsort変更でqueryが変わる（Database）
Inbox・Session decision・検索抜粋	上限付きのviewでありcursor付き全履歴ではない。案内された履歴readを使う。Inboxにページングはない（Sessions、CLI）

cursor・page番号・行数上限を取り違えたり、最初のpageを全件と考えたりしないでください。WorkflowのBundle/schema制約はWorkflow reference、日付と起動条件はTriggersを参照してください。