[Magento 2 × AI Ready パート 2] エンタープライズレベルの連結: 非同期リクエスト、Bulk API、メッセージ キュー、GraphQL の統合

直接回答： Magento / Adobe Commerce の AI タスクは同期処理をブロックしないようにする必要があります。バッチ翻訳、商品コンテンツの生成、レポート分析は、非同期/一括、メッセージ キュー、またはバックグラウンド コンシューマーに適しています。 GraphQL は、生成、監査、またはキャッシュされた AI出力のヘッドレス フロントエンド クエリに適しています。

この記事の対象読者#

• Adobe Commerce / Magento 2 システムアーキテクト。

• 多数の商品や複数店舗のデータを扱う必要があるバックエンド エンジニア。

• AI タスクキューとヘッドレスストアフロントを設計している技術チーム。

AI API のブロックがエンタープライズ レベルのモールに適していないのはなぜですか?#

大規模ショッピング モールでは、一度に 5,000 件の商品説明を翻訳したり、20,000 件の商品画像の ALT をチェックしたり、サイト全体の返品理由を整理したり、複数店舗の在庫を分析したりするなど、大量のデータを処理する必要があることがよくあります。これらのタスクがバックグラウンド リクエストでモデルを同期的に呼び出すと、次のような問題が発生します。

• HTTP タイムアウト。

• モデル API レート制限。

• バックグラウンド操作が停止する。 ・ミッション失敗後の継続走行は困難。

• 各タスクのステータスを追跡できない。 ・リトライ時にライトバックが繰り返される場合があります。

したがって、エンタープライズレベルのAI統合では、「タスクの作成」と「タスクの実行」を分離する必要があります。

非同期/バルクの役割#

Adobe Commerce Web API ドキュメントでは、非同期 Web エンドポイントとバルク エンドポイントの概念が説明されています。 AI Ready では、タスクのみがフォアグラウンドまたはバックグラウンドで作成され、後続の処理はバックグラウンド プロセスによって処理されるというこの考え方から学ぶことができます。

非同期/一括に適した AI タスク:

• プロダクトコピーライティングのバッチ生成。

• 多言語コンテンツの下書き。

• 商品データの品質監査。

• 画像のaltテキスト 候補の生成。

• カテゴリページのSEO概要。

• 大規模な運用レポート。

非同期/一括タスクには適していません:

• チェックアウト時の即時認証。

• 支払いステータスが変更されます。

• 高リスクの価格変動。

• 即時の対応が必要なカスタマーサポート フロント デスク画面。

メッセージ キューとコンシューマAdobe Commerce の Message Queue Framework は、非同期メッセージとコンシューマーをサポートします。#

公式ドキュメントには、RabbitMQ が主要なスケーラブルなブローカーであり、ActiveMQ Artemis や MySQL アダプターなどの他のオプションがあることも記載されています。運用環境では、通常、純粋なデータベース キューよりも外部メッセージ ブローカーの方が大量のタスクに適しています。

AI Ready はキューを使用して処理できます。

1.「ai.product_copy.requested」 2.「ai.translation.requested」 3. ai.image_alt.requested 4.「ai.inventory_report.requested」 5.「ai.レビュー.完了」

各メッセージには、ジョブ ID、ストア ビュー、言語、データ バージョン、冪等キーが含まれている必要があります。コンシューマが完了したら、正式なデータを直接上書きするのではなく、ドラフト、レポート、またはレビュー キューに書き込む必要があります。

AI Ready における GraphQL の位置付け#

Magento GraphQL は、PWA、SPA、ヘッドレス ストアフロントでよく使用されます。 AI Ready は、GraphQL リゾルバーに長い推論を詰め込むべきではありません。 GraphQL はクエリに適しています。

• 生成された商品概要。

• よくある質問を確認しました。

• スマートショッピングガイドの候補結果。

• 商品内容の品質ステータス。

• AI によって生成されキャッシュされた推奨理由。

リゾルバーが毎回すぐにモデルを呼び出すと、フロントエンドの遅延とエラー率が制御不能になります。

一般的なプロセス1. 管理者は、翻訳タスクを作成する商品を 1,000 個選択します。#

2. システムはジョブとバルクアイテムを作成します。
3. キューコンシューマーは商品情報をバッチで取得します。
4. AI Ready Gateway はトークンの予算と言語制限をチェックします。
5. モデルは JSON を出力します。
6. スキーマ検証に合格しました。
7. 結果はドラフト ストア ビューに書き込まれます。
8. 管理者による審査後にリリースします。
9. GraphQL は、公開されたコンテンツまたはキャッシュされたコンテンツのみを読み取ります。

失敗と再試行の戦略#

エンタープライズ レベルのタスクは、障害を処理できるように設計する必要があります。

• 429/レート制限: 遅延された再試行。

• 5xx: サプライヤーのステータスを再試行してログに記録します。

• スキーマ検証に失敗しました: 手動検査のフラグが立てられました。

• 単一アイテムの失敗: タスクのバッチ全体を中止しないでください。

• 重複した Webhook: 冪等キーでスキップされました。

よくある質問#

AI タスクには RabbitMQ を使用する必要がありますか?#

不確かな。小規模な環境の場合は、データベースのキューイングまたはスケジューリングを最初に使用できます。大規模なエンタープライズ レベルのシナリオでは、スケーラビリティと安定性を向上させるために RabbitMQ またはその他の外部ブローカーを評価することをお勧めします。

GraphQL はモデルを直接呼び出すことができますか?#

技術的には可能ですが、お勧めしません。 GraphQL リゾルバーは高速で予測可能である必要があります。 AI 推論は事前に生成するかバックグラウンドで処理し、その結果を GraphQL によってクエリする必要があります。

Bulk タスクはどのようにしてバッチ エラーの拡大を回避しますか?#

バッチ、サンプル レビュー、バージョン レコード、スキーマ検証、ドラフト ライトバック、ロールバック戦略が必要です。公式コンテンツを AIの出力で直接カバーしないでください。

参考資料#

• Adobe Commerce GraphQL、https://developer.adobe.com/commerce/webapi/graphql/
• Adobe Commerce 非同期 Web エンドポイント、https://developer.adobe.com/commerce/webapi/rest/use-rest/asynchronous-web-endpoints/
• Adobe Commerce Bulk エンドポイント、https://developer.adobe.com/commerce/webapi/rest/use-rest/bulk-endpoints/
• Adobe Commerce メッセージ キュー、https://developer.adobe.com/commerce/php/development/components/message-queues/