AI Toolkit を使えば、外部エージェントから自分のストアの Flow ワークフローを作成・更新・削除・有効化・無効化できるようになった。CLI からも呼べる。API を直接使うには Shopify の承認が必要な write_automations スコープが要る。
Flow エディタでトリガー・条件・アクションを人が画面上で組み立てる。
AI Toolkit の shopify skill 経由で、エージェントに「この自動化を作って／止めて」と頼める。CLI からも呼び出せる。
ワークフローを create / update / delete できる。
ワークフローを activate / deactivate できる。
1 件のワークフロー、またはワークフロー一覧を取得できる。
.flow ファイルを、API でそのまま使える JSON にパースできる。
ワークフローを組み立てるために必要な automation tasks（使えるタスク）と environment paths（参照できるパス）を取得できる。エージェントが「何を組み合わせられるか」を知るための材料。
| 入口 | 使い方 | 必要な準備 | 想定する使い手 |
|---|---|---|---|
| AI Toolkit | エージェントに自然言語で依頼 | AI Toolkit を自分のエージェントで動く状態にし、shopify skill を導入／更新 | 自ストアを管理する人 |
| CLI | shopify store execute で API を直接呼ぶ |
記載なし（CLI の詳細手順は記事に無い） | コマンドラインで操作したい開発者 |
| API 直接 | Shopify アプリから automation APIs を呼ぶ | write_automations スコープを申請し、Shopify の承認を得る |
承認を得たアプリ |
AI Toolkit が初めてなら、まず好きなエージェントで動く状態にする。
既存ユーザーは skill が使える状態になっている場合がある。無ければエージェントに更新を頼む。
作成・更新・有効化など、Flow の操作をエージェントに頼む。
訳 ： 「Flow の自動化を管理できるように、Shopify AI toolkit から shopify skill をインストールまたは更新して」
このリリースは自分のストアのワークフローを AI Toolkit 経由で管理する用途向け。
サードパーティアプリが基盤 API を直接使うことは防がれている。
API を直接使うにはこのスコープが必要。Shopify の承認が要るスコープ。
Flow 管理の機能は shopify skill に入っている。既存の AI Toolkit ユーザーは skill の更新だけで使い始められる場合がある。
shopify store executeエージェントを介さずに API を直接呼ぶ手段として CLI が用意されている。スクリプトに組み込みやすい入口。
write_automations は Shopify の承認が必要なスコープ。サードパーティアプリの直接利用は防がれているので、公開アプリの機能として組み込む前提で設計しないこと。
.flow ファイルを API で使える JSON にパースする操作がある。既存のワークフロー定義を API 経由の管理に乗せる橋渡しになる。
automation tasks と environment paths を取得できるので、エージェントはワークフロー作成前に「使えるタスク」「参照できるパス」を確認できる。取得 → 作成 → 有効化の順で回すのが自然な流れ。作成と有効化が別操作なので、レビューを挟んでから ON にする運用が組める。
shopify store execute で API を直接呼べる。.flow ファイルの形式や JSON スキーマの詳細は記事に記載なし。developer reference で確認する。write_automations が必要。」