Storefront MCP 策略和常见问题解答工具即将弃用，将由 UCP MCP 问答工具取代

storefront MCP search_shop_policies_and_faqs 已弃用。请在2027年1月15日之前迁移到 UCP MCP 的 ask_business 工具。

变更内容

Storefront MCP 服务器上的 search_shop_policies_and_faqs 工具（https://{shop}.myshopify.com/api/mcp）已弃用，取而代之的是 UCP Ask MCP 工具。

UCP MCP 实现了 UCP ask 功能（dev.ucp.common.ask），并在 https://{shop-domain}/api/ucp/mcp 端点暴露了以下工具：

• ask_business: 使用商店的知识库和政策，回答买家关于商店政策和服务的问题。

该弃用工具将维护至2027年1月15日，但所有文档将引用Ask MCP。

您应该做什么

如果您正在使用 search_shop_policies_and_faqs 进行构建：

• 将调用迁移至 ask_business，并更新端点以使用 https://{shop-domain}/api/ucp/mcp。
• 在每个请求中包含携带 ucp-agent.profile 的 meta 对象。您的代理配置文件必须声明 dev.ucp.common.ask。
• 在 ask.query 中发送问题，并在 ask.context 中提供可选的买家上下文（例如国家或首选语言）。
• 请注意，ask_business 返回的是 result.structuredContent.answer.plain 中的书面答案，而非原始知识库事实或完整的政策文本。请更新任何解析旧响应的代码。
• 使用 tools/list 检查商店是否为您的代理配置文件提供 ask_business。

有关更多详细信息，请参阅 Ask MCP 文档（https://shopify.dev/docs/agents/ask）。