---
title: "容量・入力・実行条件のリファレンス"
description: "添付、Media、HTML、文書、Ask、Workflow、Project Database、Triggerの上限と入力単位。超過時の分割・参照・再確認の方法。"
---

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

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

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

## 添付とProject Media

| 対象 | 上限 |
|---|---:|
| 添付の画像 | 20 MiB / file |
| 添付のPDF | 50 MiB / file |
| 添付の動画 | 200 MiB / file |
| 1回のメッセージ送信の添付 | 10件、合計250 MiB |
| Project Mediaの画像 | 20 MiB / file |
| Project MediaのPDF | 50 MiB / file |
| Project Mediaの動画 | 2 GiB / file |
| Project MediaのProject総量 | 20 GiB |

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](/ja/docs/media)と[WebUIの添付](/ja/docs/webui)を参照する。

## HTMLとShared Documents

| 対象 | 上限・形式 |
|---|---|
| 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](/ja/docs/shared-documents)、[HTML](/ja/docs/html)、[Markdownブロック](/ja/docs/markdown-blocks)で詳細を確認する。

## AskとMeeting

| 対象 | 上限 |
|---|---:|
| Askのquestion | 2,000 bytes |
| Askのbody | 100,000 bytes |
| Askの各option | 200 bytes |
| Meeting title | 1〜120文字 |
| Meeting participants | 最大50名、各名前1〜120文字 |
| Meeting本文 | 空白だけは不可、100,000 bytesまで |

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

## Workflow

| 対象 | 上限・条件 |
|---|---|
| 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](/ja/docs/cli)を参照する。

## Project Database

| 対象 | 上限・条件 |
|---|---|
| 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から作り、ファイル同期後に明示的に適用する。

## Triggerとscheduled follow-up

| 対象 | 条件 |
|---|---|
| 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の状態によって操作できない場合がある。[権限](/ja/docs/permissions)と[Troubleshooting](/ja/docs/troubleshooting)から調べる。成否不明の操作は、サイズを変えた別requestとして送る前に、最初のrequestが受け付けられたか確認する。

## 一覧ごとに異なるページング

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

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