Sidekick 现在会展示仅声明了 intents 且没有 tools 文件的 App 扩展。此前，扩展必须声明 tools 才有资格被 Sidekick 使用，因此仅注册了意图的 admin.app.intent.link 或 admin.app.intent.render 扩展会被跳过，Sidekick 也不会推荐该应用。此规则适用于所有商店中的所有应用，无需针对特定的 API 版本，也无需进行任何启用操作。如果您的应用拥有仅含意图的扩展，且其 shopify.app.toml 中缺少 extensions_summary，那么在添加该字段之前，您的下一次 shopify app deploy 将因验证失败而报错。
变更内容
当扩展声明了 tools、intents 或两者兼有时，即具备 Sidekick 资格。在此更改之前，只有 tools 才算数。配置格式没有任何变化：您已为 app actions 声明的 [[extensions.targeting.intents]] 块现在在 admin.app.intent.link 和 admin.app.intent.render 目标上单独就足够了。
受影响对象
如果您的应用至少有一个声明了 intents 但未声明 tools 的扩展，则您会受到影响。这些扩展会立即对 Sidekick 可见，如果您的 shopify.app.toml 中没有 extensions_summary，下次部署时将因缺少该字段而验证失败并报错。
如果您应用中的每个 Sidekick 扩展都已声明 tools，则您不受影响。这些扩展此前已具备资格且一直需要 extensions_summary，因此对它们而言没有任何变化。没有 Sidekick 扩展的应用也不受影响。
此功能未附加任何功能预览、权限或作用域条件。它适用于所有商店，且不与 API 版本绑定，因此锁定旧版本无法让您退出该功能。
应对措施
大多数应用无需更改。如果您拥有仅基于意图的扩展程序，请在下次部署前执行以下操作：
- 检查 admin.app.intent.link 或 admin.app.intent.render 上的每个 shopify.extension.toml，查看是否存在 [[extensions.targeting.intents]] 块且旁边没有 tools 文件。
- 如果发现此类情况，请确认您的 shopify.app.toml 在 [sidekick] 下是否有 extensions_summary。如果缺失，请添加一个。
- 在开发商店上运行 shopify app deploy。
- 向 Sidekick 提出与您的注册意图匹配的问题，并确认您的应用被推荐。[sidekick] extensions_summary = "搜索和分析产品评论，创建评论请求活动，并管理评论显示设置"[sidekick] extensions_summary = "Search and analyze product reviews, create review request campaigns, and manage review display settings"
相关文档
- 为 Sidekick 构建应用
- 为您的应用添加扩展程序摘要
- 为 Sidekick 构建应用操作
- Admin UI 扩展程序意图 API