Workflow Trigger ExtensionsWorkflow Trigger Extensions

AIを使ってトリガーコードを生成する

希望する内容を平易な英語で記述し、AIにコードを作成させましょう。この機能は、ユーザー自身のAIプロバイダーキーを使用し、本アプリの実行時契約、Shopify管理API、および（一度取得済みの場合）トリガーが受信する実際のイベントペイロードに基づいて動作します。

プロバイダーを接続する

[Developer] → [Connections] で、ご希望のプロバイダー（Anthropic（Claude）、OpenAI、**Google Gemini、**または OpenRouter）の API キーを追加してください。

1つまたは複数のプロバイダーを接続し、生成ごとに選択します。「**切断」を選択すると、**キーが再び削除されます。

「Developer」ページの「Connections」タブには、Anthropic、OpenAI、Google Gemini、OpenRouterのカードが表示されており、Anthropicには「Key connected」と表示されています。
開発者向け、「接続」：プロバイダーごとに1枚のカード。一度接続されたキーは二度と表示されることはなく、置き換えられるか、接続が解除されるのみです。

カスタムトリガーを生成する

  1. カスタムトリガーを開きます。プロバイダーが接続されていると、**「Transform」**カード内のコードの上部に「**Generate with AI」**ボックスが表示されます。
  2. どのような動作になるべきかを説明してください。具体的には、いつトリガーされるべきか、またワークフローに何が必要かについて詳しく記述してください。例えば：

    注文合計額が500を超え、かつ注文に「vip」というタグが付いている場合にのみ送信してください。注文番号、合計額、通貨をFlowに送信してください。

  3. プロバイダー（複数接続している場合はその中から1つ）とモデルを選択し、「**生成」**をクリックしてください。
  4. コードは、未保存の変更としてエディタに読み込まれます。**内容を確認し、テストしてから「保存」してください。**すでにコードがある場合は、一から書き直すのではなく、そのコードを編集するため、「さらにXも実行」という操作は、既存のコードを基に行われます。
カスタムトリガーの「変換」カードにある「AIで生成」ボックス。モデルピッカー、生成ごとのコスト、およびプロンプトが表示されています。
モデルを選択してください（各世代あたりのコストはその横に記載されています）。また、トリガーがいつ発動すべきか、およびFlowに何が必要かを記述してください。
生成後のコードエディタ：注文番号が500以下の注文や「vip」タグのない注文をスキップし、注文番号、合計金額、通貨を返す変換関数
その結果は、保存されていない変更としてエディタに反映されます。具体的には、2つのフィルターと、プロンプトで求められた3つの値です。

ストアフロントのスニペットを生成する

カスタムストアフロントのトリガーの動作は異なります。ここに記述すべき変換処理はありません。作成する必要があるのは、テーマからイベントを発行するJavaScriptコードですが、この部分で多くの人が行き詰まってしまいます。テーマごとに要素の命名規則が異なるからです。

「ストアフロント」トリガーを開き、「AIでスニペットを生成」機能を使用します。トリガーを起動すべき条件（「Dawnでカート引き出しが開いたときに、商品数とカート合計額を送信する」）を説明すると、登録済みのイベント名を使用した完成済みのスニペットと、それを貼り付ける場所に関する説明が表示されます。

貼り付ける前に必ず内容を確認し、テーマに合わせて自動で推測されたセレクタを必要に応じて調整してください。また、ペイロードには購入者の氏名、メールアドレス、電話番号、住所を絶対に含めないでください。

「Dawnカートドロワーの生成済みスニペット」と、そのスニペットを貼り付ける場所に関する注記を含む、ストアフロントトリガーの「AIでスニペットを生成」カード
ストアフロントトリガーの場合、イベント名が記載されたテーマスニペットと、その配置場所に関する説明が提供されます。

モデルの選定と費用

各オプションには生成あたりの推定費用が表示され、ボックスには選択したモデルの100万トークンあたりの価格が表示されています。 費用は、Workflow Trigger Extensionsプランではなく、ご利用のプロバイダーアカウントに請求されます。1回の生成にかかる費用は通常、数セント以下です。モデルや価格は随時変更されます。最新情報は、各表の下にリンクされている各プロバイダーのサイトでご確認ください。

アンソロピック（クロード）

モデル こんな方に最適 価格（100万トークンあたりの入出力）
クロード・ソネット第5番 スピードと知性のバランス（デフォルト） 2ドル／10ドル
クロード・オパス5 複雑で主体性のある仕事 5ドル／25ドル
『クロード・フェイブル』第5巻 次世代の長期稼働型エージェント 10ドル／50ドル
クロード・ハイク 4.5 最速かつ最安 1ドル／5ドル

Anthropicの最新モデルと価格情報：platform.claude.com/docs/en/models/overview

OpenAI

モデル こんな方に最適 価格（100万トークンあたりの入出力）
GPT-5.6 Terra 「バランス」（デフォルト） 2ドル／12ドル
GPT-5.6 Sol フロンティア、複雑な仕事 4ドル／20ドル
GPT-5.6 Luna コスト重視 0.20ドル／1.20ドル

OpenAIの最新モデルと価格情報：developers.openai.com/api/docs/models

**Google GeminiとOpenRouterは、**モデルピッカーにおいて、各世代ごとの推定値を同じ値としてモデルを一覧表示しています。OpenRouterでは、1つのキーで多くの企業のモデルを利用できます。

その知識

ジェネレータにはこのアプリの実行時契約が指定されているため、適切なシェイプが使用されます：

  • export async function transform(payload, topic, shop, ctx)（トリガーを発火させるオブジェクトを返す）または null（イベントをスキップする）。
  • ctx.log(...) ログパネル用、および管理用GraphQL API用（ctx.shopify(query, variables)）。後者はエラーが発生すると例外をスローし、1回の実行につき10回までと制限されています。
  • トリガーが監視しているトピックと、そのトピックについてキャプチャされたサンプルペイロード。

システムは、ユーザーがどの権限を付与したかを認識していません。生成されたコードが、ユーザーがアクセス権を付与していないリソースにクエリを送信した場合、実行時に呼び出しは失敗します。詳細は 権限とデータへのアクセス を参照してください。