---
title: "店舗向けの Shopify AI エージェントを作る"
description: "各店舗の注文と在庫を読み取り、確認した注文にタグを付ける Shopify AI エージェントを作れます。AIsa Connect が店舗ごとの Connection を保持し、店舗同士を分離します。"
canonical: "https://aisa.one/ja/solutions/shopify-ai-agent"
---

# 各店舗のストアで動く Shopify AI エージェントを作る

> 各店舗の注文と在庫を読み取り、確認した注文にタグを付ける Shopify AI エージェントを作れます。AIsa Connect が店舗ごとの Connection を保持し、店舗同士を分離します。

店舗は Admin API トークンでストアを接続します。エージェントが未発送の注文と在庫を読み取って確認済みの注文にタグを付け、AIsa は店舗ごとの Connection を分けて管理します。

- ウェブページ：https://aisa.one/ja/solutions/shopify-ai-agent
- 向いているチーム：エージェント開発者、越境 EC 事業者
- データ領域：AIsa Connect
- AIsa Connect で動作：[AIsa Connect](https://aisa.one/ja/products/connect)

## ストアの接続から注文のタグ付けまで 4 つのリクエスト

各ステップはサーバーから送る 1 回のリクエストです。対象は架空の店舗 store_8812 で、項目名は各アクションが公開する schema に従います。

### 1. 店舗がストアを接続

プロダクト内でストアの Admin API トークンと myshopify.com ドメインを集め、一度だけ転送します。AIsa が項目を確認し、Shopify がトークンを確認します。Connection はこの店舗の externalUserId に属します。

```
curl -X POST "https://api.aisa.one/apis/v1/connector/connect/shopify/credentials" \
  -H "Authorization: Bearer $AISA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "externalUserId": "store_8812",
    "apiKey": "shpat_...",
    "credentials": {
      "shopDomain": "acme.myshopify.com"
    }
  }'
```

### 2. 対応が必要な注文を読み取る

shopify.list_orders は未発送の注文などの Shopify 検索クエリを受け取り、各注文の番号、発送状況、合計金額、顧客を返します。

```
curl -X POST "https://api.aisa.one/apis/v1/connector/actions/run" \
  -H "Authorization: Bearer $AISA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "actionKey": "shopify.list_orders",
    "externalUserId": "store_8812",
    "input": {
      "first": 50,
      "query": "fulfillment_status:unfulfilled"
    }
  }'
```

### 3. 日付を約束する前に在庫を確認

shopify.get_inventory_quantities は、1 つのロケーションにある 1 つの商品の在庫数を返します。発送の遅れか在庫切れかを見分けられます。

```
curl -X POST "https://api.aisa.one/apis/v1/connector/actions/run" \
  -H "Authorization: Bearer $AISA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "actionKey": "shopify.get_inventory_quantities",
    "externalUserId": "store_8812",
    "input": {
      "inventoryItemId": "gid://shopify/InventoryItem/4410283321",
      "locationId": "gid://shopify/Location/7731205",
      "names": [
        "available"
      ]
    }
  }'
```

### 4. 確認した注文にタグを付ける

shopify.add_tags はストアに書き込むため、実行前に店舗に確認してください。AIsa は一度だけ送ります。結果が不明な場合は、Shopify で注文を確認してから再実行してください。

```
curl -X POST "https://api.aisa.one/apis/v1/connector/actions/run" \
  -H "Authorization: Bearer $AISA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "actionKey": "shopify.add_tags",
    "externalUserId": "store_8812",
    "input": {
      "id": "gid://shopify/Order/5829113872",
      "tags": [
        "agent-reviewed"
      ]
    }
  }'
```

## コーディングエージェントに作らせる

プロダクトのリポジトリで Claude Code、Codex、Cursor にこのプロンプトを貼り付けてください。AIsa キーはサーバーの環境変数に置きます。

```text
AIsa Connect（https://aisa.one/docs/resources/aisa-connect）を使って、このアプリに Shopify エージェントを追加してください。

まずガイドを読んでください。AIsa はサーバーからだけ呼び出し、AISA_API_KEY は環境変数から読み込みます。キーをブラウザに送らないでください。

1. 店舗が Shopify の Admin API トークンと myshopify.com ドメインを入力する設定フォームを追加します。店舗の ID を externalUserId として、両方を POST /connect/shopify/credentials に転送します。400 エラーはわかりやすい言葉で説明し、トークンは保存しないでください。
2. 1 つの店舗について、クエリ fulfillment_status:unfulfilled で shopify.list_orders を実行し、注文を一覧にするジョブを追加します。
3. 各注文の商品の在庫を shopify.get_inventory_quantities で確認します。
4. shopify.add_tags を実行する前に、店舗に一覧を承認してもらいます。outcome_unknown は不明として扱い、再試行の前に注文を確認します。

呼び出しを書く前に GET /apps/shopify/actions から各アクションの inputSchema を読み、コードを書く前に計画を見せてください。
```

コーディングエージェントはコードを書く前に計画を示します。店舗が自分のストアを接続する前に、開発用ストアでテストしてください。

## Shopify AI エージェントの開発についてのよくある質問

### Shopify AI エージェントとは何ですか？

Shopify AI エージェントは、未発送の注文の一覧作成、在庫の確認、注文のタグ付けなど、店舗の代わりにストアのデータを読み取り操作するソフトウェアです。AIsa Connect では各店舗が自分のストアを接続し、エージェントはその店舗のためだけに Shopify のアクションを実行します。

### Shopify アプリを公開する必要はありますか？

トークンで接続する場合は不要です。各店舗が自分のストアで Admin API アクセストークンを作成してプロダクトに入力し、AIsa がそのトークンで呼び出します。

### 店舗はどうやってストアを接続しますか？

shpat_ で始まる Admin API アクセストークンと、ストアの myshopify.com ドメインをプロダクトに入力します。両方を一度転送するだけで、項目が足りないと invalid_request、トークンが拒否されると connect_failed が返ります。

### エージェントはどの Shopify アクションを実行できますか？

注文、商品、在庫、顧客、下書き注文、フルフィルメントにわたる 100 件近くのアクションです。各アクションは入力 schema を公開し、読み取り・書き込み・削除のどれかを示します。

### エージェントは注文や商品を変更できますか？

はい。shopify.add_tags や shopify.update_product などのアクションはストアに書き込むため、実行前に店舗に確認してください。AIsa が実行を自動でリトライすることはありません。

### Shopify エージェントの実行にはいくらかかりますか？

成功した実行は 1 回 $0.0003 で、どのプランでも同じです。失敗した実行は無料です。ストアの接続と Connection の管理には料金がかかりません。

## 関連タスク

- [AI カスタマーサポートエージェントを作る](https://aisa.one/ja/solutions/ai-customer-support-agent.md)：店舗の Gmail から注文の問い合わせを読み、ストアで注文を調べて、担当者が送る返信の下書きを作ります。エージェント開発者、エンタープライズチーム 向け
- [EC レポートを自動化](https://aisa.one/ja/solutions/ecommerce-reporting.md)：毎週、各店舗の注文とメールキャンペーンを取得し、レポートをその店舗の Notion に書き込みます。エージェント開発者、マーケティング代理店 向け
