# Edge WorkersをAIと業務システムの接着層として使う CURRENT_STATUS: CURRENT OBSERVATION: SPEC_ONLY FRESHNESS: CURRENT PAGE_TYPE: reference CANONICAL_URL: /tools/ea-233-edge-workers-ai CLAIM_IDS: none EVIDENCE_IDS: EVD-EA-233-URL-D3DA4AE0C28E, EVD-EA-233-URL-B59DDFD96927, EVD-EA-233-URL-965457FC7BEC, EVD-EA-233-URL-F7177CB67258, EVD-EA-233-URL-FE17A048B32D, EA-233-CURRENT-APPROVAL, EA-233-CURRENT-BODY-READBACK UNKNOWN_IDS: EA-233-UNKNOWN-01 OPS_IDS: none ## Summary Edge Workerは、AIへの依頼を受け付け、認証、入力検査、接続先の選択、webhook、応答の転送を行う薄い接着層として利用できます。利用者に近い場所で動いても、モデルや原本データが遠ければ、全体の応答が速くなるとは限りません。長時間処理や業務状態の保存を一回のHTTP処理へ押し込まず、実行時間、永続化、認可、依存障害の境界を明示します。 ## Current judgment Cloudflare Workersの`ctx.waitUntil()`は、応答後にも処理を続けるためにPromiseを登録するAPIです。HTTP起動のWorkerでは、応答送信またはクライアント切断後、最大30秒の延長であり、同一依頼の複数呼出しがこの猶予を共有します。未完のPromiseは打ち切られます[S1: waitUntil]。30秒を全HTTP処理の総実行時間と混同せず、永続的なジョブ管理としても扱いません。 ## Scope Edge WorkersをAIと業務システムの接着層として使う ## Confirmed - Cloudflare Workersの`ctx.waitUntil()`は、応答後にも処理を続けるためにPromiseを登録するAPIです。HTTP起動のWorkerでは、応答送信またはクライアント切断後、最大30秒の延長であり、同一依頼の複数呼出しがこの猶予を共有します。未完のPromiseは打ち切られます[S1: waitUntil]。30秒を全HTTP処理の総実行時間と混同せず、永続的なジョブ管理としても扱いません。 Cloudflare Queuesは少なくとも一回の配送を保証する設計で、重複を考慮する必要があります[S2]。またWorkers KVは結果整合性を持ち、書込み直後の読取りや別拠点への即時反映を前提にできません。文書は、原子的操作や単一トランザクションが必要な用途にKVは向かないと説明します[S3: Consistency]。 これらはCloudflareの具体例です。「Edge」「serverless」という名称だけで、別のFunctions製品へ同じ時間制限、保存方式、配置、SDK挙動を一般化しません。採用先ではruntime、plan、compatibility date、実行種別を特定します。 ## UNKNOWN - EA-233-UNKNOWN-01: 受入検査には、切断直後、キュー送信直後の応答消失、重複webhook、認証失効、KVの古い値、provider timeout、部分stream、依存先停止を含めます。利用者から見た完了時間と、地域別の接続先・実行先・保存先を測ります。受付率だけで成功率を説明しません。 本記事では実Workerのdeploy、負荷試験、実secretや本番データの操作は実施していません。実構成の実行上限、CPU・メモリ余力、依存先遅延、認証設定、保存とキューの整合、fallbackの契約適合はUNKNOWNです。AI運用の接着層をどの製品へ配置すべきかという比較ランキングは示しません。 ## Evidence - EVD-EA-233-URL-D3DA4AE0C28E (RESEARCH): [S1] Cloudflare Workers Context / waitUntil. — https://developers.cloudflare.com/workers/runtime-apis/context/ - EVD-EA-233-URL-B59DDFD96927 (RESEARCH): [S2] Cloudflare Queues Delivery guarantees. — https://developers.cloudflare.com/queues/reference/delivery-guarantees/ - EVD-EA-233-URL-965457FC7BEC (RESEARCH): [S3] Workers KV, How KV works / Consistency. — https://developers.cloudflare.com/kv/concepts/how-kv-works/ - EVD-EA-233-URL-F7177CB67258 (RESEARCH): [S4] Workers Limits. — https://developers.cloudflare.com/workers/platform/limits/ - EVD-EA-233-URL-FE17A048B32D (RESEARCH): [S5] Cloudflare service outage June 12, 2025. — https://blog.cloudflare.com/cloudflare-service-outage-june-12-2025/ - EA-233-CURRENT-APPROVAL (RESEARCH): 現行本文の監査・revision対応 - EA-233-CURRENT-BODY-READBACK (IMPL): 現行本文の収録照合 ## Practice providerのAPI keyはサーバー側の管理されたsecretとして扱い、ブラウザやログへ返しません。tenantや送信先をリクエスト本文の自己申告だけで決めず、認証済み主体と許可表に照合します。fallbackで別providerへ送る場合も、元の契約、データ所在、モデル能力、tool権限を満たす必要があります。応答が速いという理由だけで送信範囲を拡大しません。 webhookの署名検証には、提供元が指定する元のbody表現を保持します。JSONをparse・再整形した後に署名照合すると、正当なイベントを拒否したり、検証対象を取り違えたりする恐れがあります。検証済みでも同じイベントは再送され得るため、署名の正当性と業務operationの重複制御を分けます。処理済みの記録を全tenant共通の短いkeyだけで管理しないようにします。 ## PUBLIC_CLAIM Edge Workerは、AIへの依頼を受け付け、認証、入力検査、接続先の選択、webhook、応答の転送を行う薄い接着層として利用できます。利用者に近い場所で動いても、モデルや原本データが遠ければ、全体の応答が速くなるとは限りません。長時間処理や業務状態の保存を一回のHTTP処理へ押し込まず、実行時間、永続化、認可、依存障害の境界を明示します。 ## ESTABLISHED Cloudflare Workersの`ctx.waitUntil()`は、応答後にも処理を続けるためにPromiseを登録するAPIです。HTTP起動のWorkerでは、応答送信またはクライアント切断後、最大30秒の延長であり、同一依頼の複数呼出しがこの猶予を共有します。未完のPromiseは打ち切られます[S1: waitUntil]。30秒を全HTTP処理の総実行時間と混同せず、永続的なジョブ管理としても扱いません。 Cloudflare Queuesは少なくとも一回の配送を保証する設計で、重複を考慮する必要があります[S2]。またWorkers KVは結果整合性を持ち、書込み直後の読取りや別拠点への即時反映を前提にできません。文書は、原子的操作や単一トランザクションが必要な用途にKVは向かないと説明します[S3: Consistency]。 これらはCloudflareの具体例です。「Edge」「serverless」という名称だけで、別のFunctions製品へ同じ時間制限、保存方式、配置、SDK挙動を一般化しません。採用先ではruntime、plan、compatibility date、実行種別を特定します。 ## RESPONSIBILITY_SPLIT 以下は辞典の設計提案です。外部からの依頼を受ける入口と、時間を要する仕事の実行主体を分けます。 | 接着層に置く仕事 | 条件・注意 | | --- | --- | | 認証と認可の入口 | token検証と対象資源の権限確認を分ける | | 入力と添付の検査 | サイズ・型・参照先を制限し、機密本文の複製を抑える | | provider routing | 許可された送信先・地域・モデルの範囲で選ぶ | | streaming転送 | 切断・timeout・部分応答を完了と混同しない | | webhook受付 | 署名、重複、再送、対象jobの一致を検証する | | 永続キューへの引渡し | 引渡し成立を確認してから受付完了を返す | 大容量PDFの全展開、重い解析、長いtool loop等は、実行制約に適したworker・job・workflow等へ委ねます。Workerで実行できる処理を一律に禁止するという意味ではなく、CPU、メモリ、wall time、同時接続、依存先の制約を計測して境界を決めます。製品の上限値は変更され得るため、調査時のlimitsページと実構成を記録します[S4]。 ## SECURITY_AND_ROUTING providerのAPI keyはサーバー側の管理されたsecretとして扱い、ブラウザやログへ返しません。tenantや送信先をリクエスト本文の自己申告だけで決めず、認証済み主体と許可表に照合します。fallbackで別providerへ送る場合も、元の契約、データ所在、モデル能力、tool権限を満たす必要があります。応答が速いという理由だけで送信範囲を拡大しません。 webhookの署名検証には、提供元が指定する元のbody表現を保持します。JSONをparse・再整形した後に署名照合すると、正当なイベントを拒否したり、検証対象を取り違えたりする恐れがあります。検証済みでも同じイベントは再送され得るため、署名の正当性と業務operationの重複制御を分けます。処理済みの記録を全tenant共通の短いkeyだけで管理しないようにします。 ## VERIFICATION_AND_OPEN_UNKNOWN 受入検査には、切断直後、キュー送信直後の応答消失、重複webhook、認証失効、KVの古い値、provider timeout、部分stream、依存先停止を含めます。利用者から見た完了時間と、地域別の接続先・実行先・保存先を測ります。受付率だけで成功率を説明しません。 本記事では実Workerのdeploy、負荷試験、実secretや本番データの操作は実施していません。実構成の実行上限、CPU・メモリ余力、依存先遅延、認証設定、保存とキューの整合、fallbackの契約適合はUNKNOWNです。AI運用の接着層をどの製品へ配置すべきかという比較ランキングは示しません。 ## SAFE_WORDING 「対象runtimeで入口・永続引渡し・依存障害・結果readbackを検証した」と記します。「edgeなので常に低遅延」「waitUntilでジョブは完走する」「受付200なので業務完了」とは記しません。 ## SOURCES_AND_PROVENANCE - [S1] Cloudflare Workers Context / waitUntil. https://developers.cloudflare.com/workers/runtime-apis/context/ （2026-10-20確認） - [S2] Cloudflare Queues Delivery guarantees. https://developers.cloudflare.com/queues/reference/delivery-guarantees/ （同日確認） - [S3] Workers KV, How KV works / Consistency. https://developers.cloudflare.com/kv/concepts/how-kv-works/ （同日確認） - [S4] Workers Limits. https://developers.cloudflare.com/workers/platform/limits/ （同日確認。plan・実行種別を伴わない一般化をしない） - [S5] Cloudflare service outage June 12, 2025. https://blog.cloudflare.com/cloudflare-service-outage-june-12-2025/ （当事者の障害報告、同日確認） - 旧来歴: R1R-004-EA0233、退避Doc 1Vd0BP7G2UyPDRQs_-8dPvTgQ78Tk6kcVGuMJjqNdr84 tab t.0:7030–7507は所在未特定の記録。旧candidate 1IQuUdXZuwLBaVuvAjMoYKpSpp-SPt8XSは2026-10-20取得でmanifestなし・空payload。EA-1010へ付け替えられた別主題のcache成果は、本記事の代替にしていません。 NEXT: /agent/start.json STOP: This is a knowledge projection, not an execution order.