适用对象
-
你拥有 Shopify 店铺管理员权限
-
你想在 HelpKnow 智能体里：
-
查询自己的订单
-
搜索并推荐自家商品（可按关键词、库存、类型等）
-
一、在 Shopify 后台创建“自用应用”并获取 Access Token
目标：在店铺后台创建一个自用应用，勾选只读权限，安装后生成 Admin API access token（shpat_...）。
-
打开店铺后台
-
访问
https://你的店铺域名.myshopify.com/admin -
进入左侧底部 Settings（设置） → Apps and sales channels（应用和销售渠道）
-
进入开发应用
-
右上角点击 Develop apps
-
如果页面提示“允许开发应用”，点击 Allow custom app development 并确认
-
创建自用应用
-
点击 Create a legacy custom app
-
App 名称填写：
HelpKnow Connector（仅示例，可自定义） -
填写完毕后点击 Create app
-
配置权限
-
在应用页面选择 Overview→ Configure Admin API scopes
-
勾选以下权限：
-
read_products（读取商品） -
read_orders（读取订单，默认只查询近 60 天） -
read_inventory（读取库存，用于“仅推荐有货”）
-
-
点击 右上角Save 保存
-
安装应用并生成 Token
-
切到 API credentials 页签
-
点击 Install app
-
安装完成后在 Admin API access token 区域点击 Reveal token once，复制
shpat_... - *注意：该 Token 只显示一次，请妥善保存
变更权限后要点：如果你后来又去增减了 scopes，需要重新生成 Token：
方法：Uninstall app 再重新 Install app之后再次到Admin API access token 区域点击 Reveal token once，复制token
生成新 Token 后，记得回到 HelpKnow 对应的插件或工具中替换旧 Token
二、获取店铺域名（Store Domain）
-
登录shopify后台：https://admin.shopify.com/store/
-
点击左侧底部 Settings（设置）
-
找到myshopify.com结尾的店铺域名，然后复制
三、插件授权配置
1. 将获取到的Store Domain和Access Token填入到Helpknow的Shopify平台插件授权参数配置中保存，提示成功即可完成
2. 将配置好的工具添加到需要使用的智能体中，并在智能体设定中编写好工具的使用场景和条件，即可为您的客户提供Shopify平台的订单查询和商品推荐能力
常见问题与排错
Q1：找不到“Develop apps”？
-
位置：Settings → Apps and sales channels → 右上角 Develop apps
-
如果没有权限，请用店铺“所有者/管理员”账号登录
Q2：安装后没有看到 Token？
-
说明你走的是 Dev Dashboard/版本发布路线，需要 OAuth，不是自用应用
-
请按本教程“Develop apps → Create a legacy custom app”的路径重新创建自用应用
Q3：提示“未授权/401/403”？
-
域名是否正确（必须是
xxx.myshopify.com） -
Token 是否粘贴完整、是否为最新（变更权限后需重发 Token）
-
是否勾选了必需的
read_products/read_orders/read_inventory
Q4：不想用了，如何撤销？
-
Shopify 后台打开该自用应用 → Uninstall app，Token 立即失效
Q5：智能体无法按要求调用工具，如何优化？
-
检查智能体配置页面中的知识→知识设置（知识设置栏右上角icon）→无匹配知识回复，是否选择了预设回复，选择预设回复之后，在无匹配知识的情况下不会调用大模型，从而导致工具无法调用，因此要使用工具无匹配知识回复设置必须使用大模型回复
- 确定设置无问题后可以尝试优化您的智能体设定，让智能体知道什么情况下能够调用工具