ファイル

ファイルは、指示書、参照データ、サンプルなど、エージェントが実行中に読み取れるドキュメントです。組織に一度アップロードしておき、実行またはワークフローごとに、どのファイルをどこにマウントするかを選びます。

ファイルをアップロードする

ファイルは、ダッシュボードのファイル、POST /v1/files、または ephemeral files upload でアップロードできます。各ファイルには、file_9c41… のような ID と名前が付きます。名前は guides/refunds.md のような相対パスで、240 文字までです。

すでに存在する名前で再度アップロードすると、新しい ID の新しいファイルが追加されます。ファイル一覧には、名前ごとに最新のアップロードが表示されます。古いアップロードは、削除するまで ID で引き続き利用できます。

実行にファイルを渡す

実行の files 配列にファイルを列挙します。各エントリは、1 つのファイルを任意の path にマウントします。内容の指定方法は 3 通りあります。

アップロード済みのファイルでは、path のデフォルトはファイルの名前です。インラインのファイルでは必ず指定する必要があります。パスは相対パスで、実行内で一意でなければなりません。

"files": [
  { "file": "guides/refunds.md", "path": "instructions/refunds.md" },
  { "file": "file_9c41d2a07be35f1e8a6c0d4b9e2f7a13" },
  { "path": "context.md", "content": "The customer is on the annual plan." }
]

microVM の内部

ワーカーには、ファイルが読み取り専用のディレクトリとして渡され、各ファイルのパスも伝えられます。ワーカーはファイルを変更できません。作業ディレクトリは、これとは別の一時領域です。そこに書き込んだものは microVM の破棄とともに消えるため、ファイルが実行間で共有されることはありません。実行の結果は、そのテキスト出力です。

実行は、キューを離れた時点でファイルの内容を読み込みます。そのファイルを使う実行がまだキューにある間にファイルを削除すると、その実行は失敗します。

上限

アップロード、ダウンロード、名前の変更、削除については、ファイル API をご覧ください。