Shopify 動作

連接 Shopify 商店，讓你的代理程式能在聊天中搜尋你的商品目錄並查詢訂單狀態。

將 Shopify 商店連接到你的代理程式後，代理程式就能根據你的即時商品目錄回答商品問題，並在對話過程中查詢訂單狀態。這與把聊天小工具放到你的店面上是不同的事——如需了解後者，請參閱 Shopify 嵌入。

先連接你的商店

兩個動作都需要已連接的商店。

前往你代理程式的動作分頁
開啟整合，找到 Shopify 卡片
以 store-name.myshopify.com 的格式輸入你的商店網域
完成 Shopify 的同意畫面

之後卡片會顯示連接狀態，並讓你重新連接或中斷連接。若連接需要注意，會出現一則琥珀色橫幅，提示你重新連接。

此連接以代理程式為單位。每個代理程式各自連接自己的商店，因此若某個代理程式應回答另一間商店的問題，就要為它建立自己的連接，而不是共用同一個連接。

要求存取哪些權限

在同意畫面上，Agentkit 只會要求兩項讀取權限範圍：

範圍	用途
`read_products`	搜尋你的商品目錄
`read_orders`	查詢訂單狀態

不會要求任何寫入權限範圍。此連接也使用 Shopify 預設的離線權杖——這項請求刻意省略了逐位使用者授權選項——因此即使連接商店的人已登出，代理程式仍會持續運作。

以上是目前實作所要求的權限範圍。至於一個應用程式可以取得哪些資料，Shopify 會另行判斷：部分客戶與訂單欄位受到保護，取得 read_orders 權限本身並不保證一定能取得每個欄位的資料。

兩項動作

每項動作都在動作底下個別新增與設定。

搜尋商品

當訪客詢問商品、價格或庫存狀況時，讓代理程式搜尋已連接商店的商品目錄。可依查詢字串、選填的最高價格，以及結果筆數上限來縮小結果範圍。

搜尋結果只會包含已發佈到網路商店的有效商品。庫存狀況採用 Shopify 的商品整體庫存，也會正確處理未追蹤庫存的商品。

預設的「使用時機」說明是*"Use when the user wants to find products, compare prices, or check whether an item is available."*（大意是：「當使用者想尋找商品、比較價格，或確認商品是否有庫存時使用。」）請依你的訪客實際的提問方式進行調整。

查詢訂單狀態

查詢單一訂單。訪客必須同時提供訂單編號與結帳時使用的電子郵件，且兩者必須對應到同一筆訂單，系統才會回傳任何資訊。

這項配對要求是一項隱私保護措施：單靠訂單編號很容易被猜到或偷聽到，因此永遠不足以作為查詢依據。若訂單不存在，或電子郵件與訂單不相符，代理程式都會得到同一則通用回應："We could not find an order matching those details."（大意是：「我們找不到符合這些資訊的訂單。」）——它無法判斷究竟是哪一項不正確，訪客也無從得知。

即使訂單編號與電子郵件都正確，較舊的訂單仍可能得到相同的「找不到」回應：Agentkit 要求的是 Shopify 標準的 read_orders 權限範圍，涵蓋商店最近的訂單（大約最近 60 天），而不是需要另外核准的完整訂單歷史紀錄。如果查詢較舊訂單對你的商店來說很重要，請預期需要將有較舊訂單的訪客引導至你的客服管道。

預設的「使用時機」說明是*"Use when the user asks for an order status or tracking details and can provide the order number and checkout email."*（大意是：「當使用者詢問訂單狀態或物流追蹤資訊，且能提供訂單編號與結帳時使用的電子郵件時使用。」）

啟用動作的兩項條件

以下兩項都必須成立，動作才能開啟：

已連接的商店——若尚未連接，啟用開關旁會顯示一則行內提示，連結至動作 → 整合
付費方案——與自訂 API、網頁搜尋、讀取文件連結，以及各項預約動作的要求相同

即使尚未滿足這兩項條件、動作處於停用狀態，你仍然可以建立、編輯並儲存這兩項動作。這兩項條件只適用於「開啟」動作這個步驟。

疑難排解

OAuth 已完成，但訂單查詢沒有結果。 請確認你商店使用的訂單編號格式，並確認測試時使用的電子郵件正是該訂單結帳時使用的電子郵件。接著確認該應用程式在這間商店是否具備存取受保護客戶與訂單資料的資格——是否能取得這類資料，取決於該應用程式是否確有必要，且 Shopify 可以加以限制。要求更廣泛的權限範圍並不會改變這一點，重新連接也不保證會獲准。

代理程式根據訓練內容回答，而不是根據商品目錄。 調整「使用時機」說明，讓與商品、價格、庫存相關的問題能明確導向搜尋動作。

卡片顯示重新連接警示。 表示已儲存的授權已無法使用。請點選重新連接，再次完成同意畫面。重新連接可以恢復連接本身，但不會恢復動作：當已儲存的授權失效時，兩項 Shopify 動作都會自動關閉，而同意畫面並不會將它們重新開啟。重新連接之後，請回到動作分頁，手動重新啟用你想要使用的每一項動作。