Shopify Flow の自動化を 「エージェントに頼んで」作る・直す・止める

図解 ： Shopify Flow を AI Toolkit 経由でエージェントから管理できるように Shopify Flow / AI Toolkit / Developer Changelog Shopify Flow の自動化を 「エージェントに頼んで」作る・直す・止める AI Toolkit を使えば、外部エージェントから自分のストアの Flow ワークフローを作成・更新・削除・有効化・無効化できるようになった。CLI からも呼べる。API を直接使うには Shopify の承認が必要な write_automations スコープが要る。 このページの構成 そもそも何が変わるのか（30秒で理解） 仕組み図解 ： 3 つの入口と Flow エージェントにできる 5 つの操作 入口ごとの比較（AI Toolkit / CLI / API） 始め方（AI Toolkit の場合） 制約と注意点 技術者が押さえるべき5つのポイント 業務に活かせる3つのユースケース 提案で使える1行サマリ 1 そもそも何が変わるのか これまで Shopify Flow のワークフローは管理画面の Flow エディタで組むものだった。 今回、 AI Toolkit を通じて外部エージェントから自分のストアの Flow を管理できる ようになった。 これまで ： 管理画面で手組み Flow エディタでトリガー・条件・アクションを人が画面上で組み立てる。 これから ： エージェントに依頼 AI Toolkit の shopify skill 経由で、エージェントに「この自動化を作って／止めて」と頼める。CLI からも呼び出せる。 2 仕組み図解 ： 3 つの入口と Flow 今回のリリースは「自分のストアのワークフロー管理」向け 。サードパーティアプリが基盤 API を直接使うことは防がれている、と明記されている。 3 エージェントにできる 5 つの操作 CRUD 作成・更新・削除 ワークフローを create / update / delete できる。 ON / OFF 有効化・無効化 ワークフローを activate / deactivate できる。 READ 単体・一覧の取得 1 件のワークフロー、またはワークフロー一覧を取得できる。 PARSE .flow ファイルを JSON に変換 .flow ファイルを、API でそのまま使える JSON にパースできる。 BUILD 用 自動化タスクと environment パスの取得 ワークフローを組み立てるために必要な automation tasks（使えるタスク）と environment paths（参照できるパス）を取得できる。エージェントが「何を組み合わせられるか」を知るための材料。 4 入口ごとの比較（AI Toolkit / CLI / API） 入口 使い方 必要な準備 想定する使い手 AI Toolkit エージェントに自然言語で依頼 AI Toolkit を自分のエージェントで動く状態にし、shopify skill を導入／更新 自ストアを管理する人 CLI shopify store execute で API を直接呼ぶ 記載なし（CLI の詳細手順は記事に無い） コマンドラインで操作したい開発者 API 直接 Shopify アプリから automation APIs を呼ぶ write_automations スコープを申請し、 Shopify の承認 を得る 承認を得たアプリ 5 始め方（AI Toolkit の場合） 1 AI Toolkit をエージェントで動かす AI Toolkit が初めてなら、まず好きなエージェントで動く状態にする。 2 shopify skill を導入／更新 既存ユーザーは skill が使える状態になっている場合がある。無ければエージェントに更新を頼む。 3 自動化の操作を依頼 作成・更新・有効化など、Flow の操作をエージェントに頼む。 記事に載っている依頼文（そのまま使える） > Install or update the shopify skill from Shopify AI toolkit so that I can manage Flow automations 訳 ： 「Flow の自動化を管理できるように、Shopify AI toolkit から shopify skill をインストールまたは更新して」 6 制約と注意点 対象 自分のストアだけ このリリースは自分のストアのワークフローを AI Toolkit 経由で管理する用途向け。 対象外 サードパーティアプリ サードパーティアプリが基盤 API を直接使うことは防がれている。 承認制 write_automations API を直接使うにはこのスコープが必要。Shopify の承認が要るスコープ。 対応プラン、承認の審査基準、レート制限、対応エージェントの一覧は 記事に記載なし 。詳細は Shopify Flow の help center / developer reference / automation APIs のドキュメントで確認すること。 7 技術者が押さえるべき5つのポイント 1. 主な入口は AI Toolkit の shopify skill Flow 管理の機能は shopify skill に入っている。既存の AI Toolkit ユーザーは skill の更新だけで使い始められる場合がある。 2. CLI は shopify store execute エージェントを介さずに API を直接呼ぶ手段として CLI が用意されている。スクリプトに組み込みやすい入口。 3. 直接利用は承認スコープで絞られている write_automations は Shopify の承認が必要なスコープ。サードパーティアプリの直接利用は防がれているので、 公開アプリの機能として組み込む前提で設計しない こと。 4. .flow → JSON で既存資産を移せる .flow ファイルを API で使える JSON にパースする操作がある。既存のワークフロー定義を API 経由の管理に乗せる橋渡しになる。 5. タスク・パス取得で「組める部品」を先に知る automation tasks と environment paths を取得できるので、エージェントはワークフロー作成前に「使えるタスク」「参照できるパス」を確認できる。 取得 → 作成 → 有効化 の順で回すのが自然な流れ。作成と有効化が別操作なので、レビューを挟んでから ON にする運用が組める。 8 業務に活かせる3つのユースケース USE CASE 1 運用担当が「言葉で」自動化を作る 課題 やりたい自動化はあるが、Flow エディタでトリガー・条件・アクションを組むのに慣れておらず、作成が後回しになっている。 打ち手 AI Toolkit の shopify skill を入れたエージェントに、やりたいことを伝えてワークフローを作成してもらう。 効果 Flow エディタの操作に慣れていなくても、自動化の作成に手を付けやすくなる。 技術メモ 作成と有効化は別操作。作成後に一覧／単体取得で中身を確認してから activate する流れにすると安全。 USE CASE 2 手元の .flow ファイルを API 管理に乗せる 課題 手元の .flow ファイルとしてワークフロー定義を持っているが、反映は管理画面で人がやっている。 打ち手 .flow ファイルを JSON にパース → その JSON を使ってワークフローを作成・更新する。 効果 ワークフロー定義をファイルで管理し、エージェントや CLI から反映する運用に寄せられる。 技術メモ CLI は shopify store execute で API を直接呼べる。.flow ファイルの形式や JSON スキーマの詳細は記事に記載なし。developer reference で確認する。 USE CASE 3 ワークフローの棚卸しと一時停止をまとめて行う 課題 ワークフローが増えて、どれが動いているか把握しにくい。セール期間などで一部を一時的に止めたい。 打ち手 エージェントにワークフロー一覧を取得させて状況を整理 → 止めたいものを deactivate、期間後に activate。 効果 管理画面で 1 件ずつ切り替える手間を減らし、ON/OFF の切り替え漏れを防ぎやすくなる。 技術メモ activate / deactivate は独立した操作として用意されている。不要になったものは delete も可能。 9 提案で使える1行サマリ 「Shopify Flow の自動化を、AI Toolkit 経由で エージェントに作らせ・直させ・止めさせられる ようになった。 対象は自分のストアのみ、CLI からも呼べて、API の直接利用は Shopify 承認制の write_automations が必要。」 source ： shopify.dev / changelog / shopify-flow-manage-automations-through-admin-api 公開日 2026-10-28（Developer Changelog）