AIに渡すAPI結果は「全部」ではなく、次の判断に必要な情報へ絞る

「取得できる情報」と「次の判断に必要な情報」は違う

APIから多くの情報を取得できること自体は便利です。

しかし、AIが次に「どの商品画像を使うか」「どのIDを対象にするか」を判断するだけなら、商品説明全文、価格情報、在庫、すべての画像、関連データまで必要とは限りません。

取得可能な項目を全部そのまま返すと、目的に関係のない情報の中へ、次工程で必要な値が埋もれることがあります。

最初に「次に何を判断するか」を決める

レスポンスを絞る基準は、「少ない方がよい」ではありません。

次の処理に必要な情報が欠けないことが最優先です。

たとえば商品画像を選ぶ工程なら、商品名、商品ID、商品URL、画像IDや画像URLがあれば次の判断に進める場合があります。

一方、価格改定を判断する工程なら、価格やSKU、在庫など別の項目が必要です。

同じAPIでも、目的によって残すフィールドは変わります。

対象件数と、1件あたりの情報量を別々に絞る

大量レスポンスを小さくするときは、2つの方向があります。

• 対象を絞る：必要なレコードだけをfilterで選ぶ
• 件数を絞る：pagingで1回に返すレコード数を制御する
• 項目を絞る：fieldsやfieldsetsで1件あたりに返す情報を選ぶ

Wix API Query Languageでも、filter、paging、fieldsがそれぞれ別の役割として定義されています。

つまり「10件だけ返す」と「10件の全情報を返す」は同じではありません。件数を減らしても、各レコードが巨大ならレスポンスはまだ大きくなります。

Field Projectionで必要な項目だけ返す

Wixの公式資料では、Field Projectionを使ってメソッドが返すフィールドを制御できます。

個別フィールド名を指定できるAPIでは、必要な項目だけをfieldsへ指定します。

Wix DataのQuery Data Itemsでも、filterやpagingと一緒にfieldsを指定して、返却する項目を限定する例が公式に示されています。

これにより、AIへ渡す前から不要な情報を減らせる場合があります。

API側で絞れない場合は、取得後に整理して返す

すべてのAPIが、欲しい形でField Projectionを提供しているとは限りません。

その場合は、取得したレスポンスをそのまま会話へ流すのではなく、処理側で次工程に必要な項目だけへ整形して返す方法があります。

たとえば商品オブジェクトが多数のネストした情報を持っていても、次の処理に必要なのが商品名、ID、URL、画像情報だけなら、その4種類へ整理して返します。

重要なのは、API内部で絞ったか、取得後に整理したかではなく、次のAI判断へ不要なデータを持ち越さないことです。

大量の生データは、Evidenceとして残す場所と分ける

すべての情報を捨てる必要はありません。

後から監査や検証に必要な元データは、別のログやExperimentsとして保存できます。

一方、現在の判断に使うAIへの返却は、必要な値だけへ整理します。

「保存する情報量」と「今この工程でAIへ見せる情報量」を分けることで、証拠を残しながら作業画面を小さくできます。

数字が大きいこと自体を性能指標にしない

大量レスポンスが発生したとき、「何トークンだったか」「何秒短くなったか」という数字だけで改善を判断しないようにします。

環境の表示上限、内部処理、課金単位などは別の概念だからです。

海辺の部屋では、まず「次の判断に必要な値を最後まで確認できたか」「対象を誤らず識別できたか」を見るようにしています。

処理時間やコストの改善を主張する場合は、別途計測が必要です。

AIへ返すデータを決める確認順

1. 次にAIが何を判断・操作するか決める
2. 対象レコードを識別する条件を決める
3. 必要な件数だけ取得する
4. 次工程に必要なフィールドを列挙する
5. APIが対応していればfieldsなどで投影する
6. 対応していなければ取得後に必要項目へ整形する
7. 検証用の生データが必要なら別レイヤーへ保存する

API連携で重要なのは、取得できる最大量をAIへ渡すことではありません。

次の判断を安全に進められる、必要十分な情報へ変換して渡すことです。

このKnowledgeの関連知識

安全な書き込みへ進む： API結果を次の判断に必要な情報へ絞った後、CMS書き込みではCreateの再実行による重複を防ぐ。

AIにCMSへ書き込ませるとき、同じデータの重複作成をどう防ぐか

現在地： WEB & CMS → Wix・CMS・API自動運用

Knowledgeトップを見る