Cloudflare Sandbox の AI コード実行では、生成コードを主アプリの中へ直接置かずに、ファイル変換や計算をアシスタントに行わせられます。重要なのは、実行環境がどこへ到達できるかです。コードは、渡されたファイル、認証情報、通信経路、ツールを利用できます。
負荷に適した実行境界の中で生成コードを動かし、入力、通信、アプリ能力を意識して制限します。影響の大きな操作は環境の外に残し、返された成果物を使う前に検証します。アクセスを広げる前に、通常のコードと悪意あるコードで、隔離、資源、清掃をテストしてください。
分析担当が、閲覧を許可された CSV をまとめて図表を作るよう依頼する場面を考えます。この依頼を完了するために必要なのは、指定された入力ファイルと、結果を書き出すための場所です。会社全体の保存アカウントを自由に参照する能力も、元の業務システムを変更できるサービス認証情報も、この変換作業には必要ありません。
この記事はその仕事の構成案です。隔離ですべての危険がなくなるとも、同じ環境がすべての言語と依存関係に適するとも主張しません。
Cloudflare Sandbox の AI コード実行の境界を定義する
Cloudflare の Sandboxes 概要 は、コンテナー環境と Dynamic Workers を区別しています。適切な環境は実行要件によります。古い Sandbox SDK の例が現在のインターフェースを表すと考えず、最新文書から選びます。
分析の変換作業について、言語、ライブラリ、入力形式、出力型、通信先を列挙します。提供ファイルのローカル計算だけなら、追加の外部アクセスには別の理由が必要です。
調整役の Worker が、どの仕事がどの認証済みユーザーに属するかを判断します。実行環境へは、他の資料を探索できるアカウント全体の認証情報ではなく、その仕事に許可した材料だけを渡します。
| 能力 | 例に必要か | 定義する境界 |
|---|---|---|
| 選んだ入力ファイルを読む | 必要 | 認可したジョブの入力だけ |
| 結果ファイルを書く | 必要 | 専用の出力場所 |
| 公開インターネットへ接続 | 必須ではない | 理由がある指定先だけ |
| 本番の認証情報を読む | 不要 | サービス権限を仕事の外に保つ |
| 元の業務記録を変更 | 不要 | 別途確認したアプリ操作 |
実行の必要性から環境を選ぶ
Cloudflare の環境選択ガイド を出発点に、利用できる方式を比較します。必要な言語、依存関係、実行期間が実際に対応しているか確認します。
ツール一式が必要なら、完全なコマンド環境は有用です。ただし、ファイル、プロセス、依存関係の動作も考慮する必要があります。限定した変換だけなら、狭い実行範囲のほうが確認しやすい場合があります。
最初の実演が簡単になるからと、最も強力な環境を選ばないでください。調達の判断で確かめるべきなのは、その環境が許可された仕事を実行できるか、そして実行に使う制御をチームが説明し、継続して保守できるかという点です。最初の実演の手軽さだけでは、この運用上の判断には答えられません。
選んだ基盤が対応する場合は、実行イメージや依存設定を固定します。結果と一緒に設定を記録し、後の失敗を実際に動かした環境と結び付けられるようにします。
秘密情報と業務権限をアプリに残す
Cloudflare の認証情報と通信のガイド が関連する制御を説明しています。承認先にどう接続するかを決め、テスト構成で直接検証します。
分析作業では、調整アプリが認可済みの書き出しを取得し、入力として届けられます。生成プログラムはそのコピーだけを処理します。別の資料が必要ならアプリへ要求を返し、そこで本人確認と権限確認を適用します。
広い保存権限を渡してから、許可フォルダーをプロンプトだけで指定してはいけません。権限を決めるのは認証情報と実行境界であり、モデルへの指示の丁寧さではありません。
出力も同様です。仕事はファイルや結果を提案し、公開、メール、取り込みは別のアプリが判断します。生成コードが変換依頼を未確認の業務操作へ変えることを防げます。
入出力ファイルを信頼しない
実行前に、合意した方針で入力の型と大きさを確認します。どのファイルが入ったか確定できる一覧を残します。検証済みの分離設計なしに、異なる人の入力を共有作業領域へ混ぜないでください。
出力も検査します。拡張子が正しくても、異なる形式、隠れた内容、誤解を招く計算があるかもしれません。完成として示す前に、型、許可された場所、意味の検査を確認します。
財務グラフなら、合計を元データと比べ、除外を説明します。きれいな画像でも計算の正しさは証明しません。アーカイブや文書出力では、実際に含むファイルとデータを調べます。
| 成果物の段階 | 検査案 | 防ぐこと |
|---|---|---|
| 入力の受入 | 認可済み資料と予期した形式 | 別ユーザーのデータ処理 |
| 作業場所の準備 | 専用パスと限定した内容 | 他ジョブの資料再利用 |
| 出力回収 | 型、場所、大きさの方針 | 想定外ファイルの納品 |
| 意味の検証 | 合計、参照、業務の条件 | もっともらしい誤結果 |
| 公開 | 明示したアプリの権限 | 生成コードによる独自配信 |
許されたテスト環境で悪意あるコードを試す
提供領域外のファイル読み取り、未承認の通信、過剰な資源使用の試行を受入に含めます。専用環境と合成データを使い、テスト自体で本番情報を露出させないようにします。
テストの対象は、実際に選び、設定した制御そのものです。設計図にインターネット接続が描かれていなくても、環境からの外向き通信が実際に遮断されているという証拠にはなりません。接続を試した際の具体的な結果と、実行環境から返された理由を記録して、その設定がどう動いたかを説明できるようにします。
Cloudflare のサンドボックス安全性ガイド が環境境界の一次資料です。本人確認、ジョブ経路、成果物公開など、アプリ制御は別途テストが必要です。
通常障害も試します。依存関係の読み込み失敗、不正 CSV、終了しない処理、許可サイズを超える出力などです。明確な失敗分類と、安全に終了または調査する方法を運用担当に用意します。
実行期間と清掃を観測可能にする
開始、終了条件、その後残るものを定義します。実行環境と、保持する成果物や証拠を分けます。コードを実行していたプロセスを終了しても、処理の途中で別のストレージサービスへコピーしたファイルまで削除されるとは限りません。環境の終了と、そこから持ち出した成果物の保持は、それぞれ確認する必要があります。
作業領域を復元や再利用するなら、どのデータが戻るかを確定します。便利な永続領域も、経路や清掃の前提が誤れば、仕事間でデータが混ざる問題になります。
仕事の所有者、入力一覧、実行設定、終了理由、回収出力を記録します。仕事と合意した確認方針で必要な内容だけを保持します。
失敗後の取り消しと清掃を演習します。次の仕事が前の入力を見られず、全ファイルを不要にコピーして残さなくても失敗を説明できることを確認します。
制御した実行サービスを見積もる
開発には、調整、本人確認、入力準備、実行制御、成果物検証、運用が含まれます。一度コマンドを動かすコードより広い範囲です。
対応する仕事と言語を定義した GBP の提案を求めます。会社全体で任意のプログラムを動かせる助手より、限定した CSV 変換のほうが明確な初期範囲になります。
継続費用は、環境、時間、保存、モデル利用、失敗処理によります。その環境の現行料金を確認します。コンテナーの見積もりを Dynamic Workers に流用したり、待機、失敗、復元が無料だと考えたりしないでください。
パイロットは有用な成果物と境界の証明を提供します。正常な仕事、拒否された能力、取り消し、清掃、不適切な出力の拒否を示します。責任者は、その結果から別の仕事を安全に追加できるか判断できます。
当社の AI 連携パイロット で範囲を定められます。入力例、必要な道具、別途の権限なしに絶対行ってはいけない操作を添えてサンドボックス実行案をご依頼 ください。
よくある質問
サンドボックスで生成コードは自動的に安全になりますか? いいえ。隔離は有用でも、渡した能力とデータはコードが使えます。ファイル、認証情報、通信、資源方針、出力処理を定義してテストします。
生成コードに本番 API キーを渡すべきですか? 広いサービス権限は避けます。アクセス確認のできるアプリ層に認証情報を置き、仕事に必要な限定操作だけを公開します。選ぶ基盤の認証情報と通信制御を確認します。
すべての仕事に Linux コンテナーが必要ですか? いいえ。言語、依存関係、実行要件から選びます。Cloudflare は異なる方式を説明しており、限定した仕事は狭い環境で十分な場合があります。
助手が生成ファイルを自動公開できますか? 別途合意したアプリ方針がある場合だけです。成果物の作成と配布は別の行為です。取り込み、メール、公開の前に出力検証と権限確認を行います。
隔離テストには何を含めますか? 専用環境と合成データで、権限外のファイル、未承認通信、資源超過、取り消し、清掃を試します。図に依存せず、実際の設定の証拠を残します。
作業領域を再利用してもよいですか? 意図した分離と保持の設計がある場合だけです。有用な情報を残せる一方、他の仕事のデータも残り得ます。経路、復元内容、清掃を試してから利用します。
実装費用は何で決まりますか? 言語、依存関係、入力準備、能力制御、成果物検証、支援要件です。限定した仕事から始め、失敗テストと運用引き継ぎを含めた GBP の提案を求めます。