THE TAKEAWAYS

この記事のポイント

  • CPU時間と外部待機を区別する
  • 入力の容量と工程別の負荷を測る
  • 契約プランと呼び出し種類で上限を確認する

編集部の実務提案

外部APIを待つ時間と計算の時間を分ける

AIサービスでは、外部APIを待つ処理と、取得した資料を加工する処理が一つの要求に混在します。Supabase Edge Functionsの公式制限資料にはCPU時間に非同期I/Oの待機を含めない説明があり、プランによって実行継続時間の条件も異なります。編集部では、処理が何秒続くかだけでなく、その間に何を計算し、何を待っているのかを分けて整理することを勧めます。数値の上限は契約中の条件で確認してください。

編集部の実務提案

大きな資料の加工を一か所に集めない

外部APIの応答が速くても、大量の文章解析や画像加工を同じ処理へ集めると、別の資源が先に不足する可能性があります。提案として、資料の取得、検証、変換、AI呼び出し、保存を工程ごとに計測します。入力を受けた時点でサイズと形式を確かめ、扱えない資料を途中まで処理してから失敗させないようにします。大きな仕事は分割や別の実行基盤を検討し、画面の要求へ無理に押し込めません。

編集部の実務提案

利用者の待ち方を設計に含める

処理基盤の制限だけで画面のタイムアウトを決めると、利用者が待ち続ける体験になります。短時間で終わる処理と、受付番号を返して後から結果を確認する処理を分ける方法が考えられます。中断した要求が裏側で継続するか、結果をいつまで保持するかも明示します。処理の開始、保存、画面への通知が別々に失敗するケースを試し、重複実行や結果の取り違えを防ぐ確認を加えます。

編集部の実務提案

想定負荷を記録してから公開する

海外チームへ引き継ぐ際には、平均的な依頼だけでなく、大きな入力、同時実行、外部サービスの遅延を含めた条件を渡します。試験で使った入力サイズ、処理時間、観測したエラーを残せば、上限に近いのか別の障害なのかを判断しやすくなります。公式仕様やプランが変わった場合は、古い上限値を記事や設定へ固定せず、現在の資料と構成を照合して見直します。

編集部の実務提案

受入試験で具体例を確かめる

例えば、大きな資料を受け取る機能では、処理開始前に容量を判定します。拒否した際は、入力が保存されたのかどうかも明確にします。受け付けた依頼には識別子を付け、途中で画面を閉じても、担当者が完了や未確定の状態を照合できるようにします。条件と期待する結果を同じ記録に残し、次の担当者が再現できる状態を確認します。判断できない点は未確認として明示し、必要な追加確認を担当者と共有します。

WITH OPERUN.

日々のAI管理を、チームへ。

今回の確認では、CPU時間と外部待機を区別する、入力の容量と工程別の負荷を測る、契約プランと呼び出し種類で上限を確認するという観点を整理しました。担当者へ作業を渡すときは、期待する動作と確認結果を結び、利用者が次に取る行動まで確かめましょう。

作りたいもの・任せたい仕事を相談する

参考にした一次情報

出典確認:2026年11月6日。本文の手順・チェックリストは、編集部の実務提案です。

  1. [1]

この記事を共有