今回 Shopify AI Toolkit を試していて、かなり象徴的だと思った「AIのつまずき」がありました。

結論から言うと、

AIが「昔のShopifyの常識」に引っ張られた

という話です。

💥 何が起きたか

最初に、

• 「Shopify AI Toolkit を試したい」
• 公式URL

をAIへ渡していました。

しかし AI は、

「Shopify の Admin API を使うなら token が必要」

という過去の知識パターンを優先してしまいました。

その結果、

本来は不要だった：

• カスタムアプリ作成
• Admin API token取得
• 手動認証

を案内してきました。

でも実際には、AI Toolkit には最初から：

Shopify CLI Connector App

という認証仕組みが内包されています。

つまり、

「Authenticate my Shopify store for the Shopify AI toolkit」

だけで認証できたんです。

🧠 なぜ起きたのか

今回の件は、かなりAIっぽい失敗だと思いました。

大きく理由は2つあります。

① 新しいツール固有の仕組みを知らなかった

AI は、

「Shopify = カスタムアプリ + token」

という古い知識パターンを強く持っています。

一方で、

Shopify CLI Connector App

のような新しい仕組みは、学習データに十分含まれていなかった可能性があります。

そのため、

「知らない新機能」

より、

「知っている古いパターン」

へ引っ張られてしまった。

これはかなりAIらしい挙動です。

② 公式URLを渡されても“理解したつもり”になった

もう1つ大きかったのがここ。

公式URLを渡していたにも関わらず、

AIは：

• ドキュメントを十分確認せず
• 新しい認証構造を検証せず

に、

こういうものは token が必要なはず

という思い込みで回答してしまいました。

つまり、

「知らない」

を認識できていなかった。

⚠️ 本質は「古い知識」ではなく「知らない自覚がなかったこと」

今回の件で一番重要だったのは、

情報が古かったこと

より、

自分は本当にこのツールを理解しているか？

をAI自身が疑えなかったことだと思っています。

AI は、

「知識が曖昧」

でも、

かなり自然に断定口調で話せてしまいます。

これが実運用では結構危険です。

🔍 実際かなりそれっぽく見える

特に Shopify 開発をやっている人からすると、

カスタムアプリを作る
↓
tokenを発行する
↓
Admin APIを叩く

は“いつもの流れ”です。

だから余計に、

「それっぽく見えてしまう」。

実際、自分も最初は違和感なく信じかけました。

💡 今回かなり学びになったこと

今回の件で感じたのは、

AIを使う時って、

「答えを聞く」

より、

AIが何を前提に考えているか

を見るのが重要なんだなということ。

特に：

• 新しいツール
• ベータ機能
• AI連携
• MCP系

は仕様変化が速いので、

AIの知識がズレていることが普通にあります。

🛠 防ぐためにできること

ユーザー側

最初に、

• 「このツールは token 必要？」
• 「認証は内蔵？」
• 「公式の推奨方法は？」

を確認するとズレに気づきやすいです。

AI側

本来は、

• 「この知識は古い可能性があります」
• 「最新ドキュメントを確認します」

と前置きした上で、

公式ドキュメントを確認してから提案するべきでした。

📌 AI Toolkitの面白さはここにもある

少し皮肉なんですが、

今回の失敗自体が、

「AI Toolkit が必要な理由」

を逆に証明している気もしました。

従来のAIは、

「一般論」

では答えられる。

でも Shopify AI Toolkit のように、

• Shopify Docs
• GraphQL schema
• 現在のCLI仕様

へ接続されることで、

初めて：

Shopify の“今の仕様”

を前提に動けるようになる。

今回のつまずきは、

「AIに最新コンテキストを渡す重要性」

そのものだったなと思っています。