Skip to main content

SmartBatch

SmartBatch は、1件または複数のカタログ照会をバッチとして実行します。エンドポイントを選び、入力フィールドをマッピングし、バッチの実行方法を決めます。Smart-Agent UI（ai.verifik.co）または API（async.verifik.co）から利用します。

バッチ設定は再利用可能なレシピです。名前、国、ステップ（カタログ機能）、マージ戦略、実行モード、任意の通知が含まれます。ファイルをアップロードするか照会をキューに入れるたびに、SmartBatch はそのレシピからバッチを作成します。

概要​

SmartBatch は、すでに使っている SmartCheck カタログの上にあります。Sync は現在のリクエストで待ちます。Async はすぐに応答し、タブを閉じたあとも処理を続けます。設定が Async のとき、ファイルバッチと1行の API 呼び出しは同じワーカーを共有します。

バックエンドからカタログパスをキューとして呼ぶ場合は、エンドポイントをキューとして呼び出す (async) を見てください。

主な機能​

Async

バックグラウンドで実行します。このタブを閉じてもバッチは続きます。

Sync

サーバー上でステップを連鎖実行します。後続ステップが前の結果を使う場合に適します。

カタログステップ

カタログ URL がある SmartCheck エンドポイントを検証ステップとして追加します。

通知

Webhook URL と完了メールは設定に保存されます。クエリパラメータではありません。

ファイルまたは API

スプレッドシートをアップロードするか、type=queue で1行をキューに入れます。どちらも同じ Async ワーカーを再利用します。

ダッシュボード

バッチダッシュボードで進捗、試行、行あたりのコスト、リンク済み Webhook を確認します。

Async vs Sync​

ウィザードとダッシュボードは製品ラベル Async と Sync を使います。

実行モード動作使うとき
Async（デフォルト）バッチはバックグラウンドで実行されます。Smart-Agent のタブを閉じても構いません。ワーカーが各行を取得し、機能 URL を呼び出し、試行を記録します。即時応答の照会、大きなファイル、Webhook フロー。
Syncサーバーがステップを連鎖実行し、各結果を待ちます。後続ステップは前の出力を使えます。ステップ 2 がステップ 1 に依存する多段レシピ。

クレジットは機能が実際に実行されたときに課金されます（Async はワーカー呼び出し、Sync はステップ呼び出し）。行をキューに入れた時点では課金されません。

API の type 値

async.verifik.co では type を省略するか type=sync を送って結果を待ちます。type=queue を送ってキューに入れます。UI から queue や featureRunner を渡す必要はありません。

ai.verifik.co で設定を作成する​

https://ai.verifik.co を開き、Smart Batch で 作成 を選びます。

1. 基本情報​

設定名、説明、国を入力します。実行モード を選びます。

  • Async — バックグラウンドで実行します。このタブを閉じてもバッチは続きます。
  • Sync — サーバー上でステップを連鎖実行します。後続ステップが前の結果を使う場合に適します。

デフォルトは Async です。

2. エンドポイントを選択​

カタログを検索し、必要な検証ステップを追加します。各ステップは URL 付きの SmartCheck 機能です（身分、加入、車両など）。カタログ URL がない機能（passwordless、PDF ジェネレーター）はバッチステップとして実行できません。

3. パラメータを確認​

各ステップの必須パラメータを確認します。これらのフィールドは、アップロードしたファイルヘッダー（または1行をキューに入れるときの API inputData）からマッピングされます。

4. 確認と作成​

概要を確認します。必要なら 通知 を開きます。

  • Webhook URL — 行とバッチ完了イベントをこのアドレスに POST します。続行する前に URL をテストしてください。
  • 完了時のメール — バッチ終了時にメッセージを受け取る任意のアドレスです。

設定を保存します。通知は設定に残ります。以降の type=queue 呼び出しは、毎回新しい設定を作らず、一致する Async 設定（Queue …）を再利用します。

バッチの実行と監視​

設定からファイルをアップロードするか実行を開始できます。ダッシュボード には次が表示されます。

  • 行ごとのステータスと進捗
  • 各行の試行履歴
  • 行あたりのコスト
  • リンク済み Webhook（クリックで Smart Monitor へ）

リンク済みバッチ設定は、Smart Monitor の Webhook 一覧と詳細にも表示されます。

ファイルバッチと1行 API 呼び出し​

開始方法ホスト結果
Smart-Agent でファイルをアップロードai.verifik.coN 行のバッチ
カタログパスに type=queue で GET/POSTasync.verifik.co202 と1行バッチ

設定が Async のとき、両方の経路は同じバックグラウンドワーカーを使います。API の A–Z は エンドポイントをキューとして呼び出す (async) を見てください。

関連​