ask_business へ 2027/1/15 までに移行search_shop_policies_and_faqs は ask_business に置き換え。エンドポイント・リクエスト形式・レスポンス形式がすべて変わるため、AI エージェント側のコード修正が必要。
search_shop_policies_and_faqs（ストアのポリシー・FAQ 検索ツール）が非推奨になった。ask_business。買い手の質問に対して、ストアのナレッジベースとポリシーをもとに文章で回答するツール。
search_shop_policies_and_faqsStorefront MCP（https://{shop}.myshopify.com/api/mcp）上のツール。2027 年 1 月 15 日までは維持されるが、ドキュメントは今後すべて Ask MCP を参照する。
ask_businessUCP MCP（https://{shop-domain}/api/ucp/mcp）上のツール。UCP の ask ケイパビリティ（dev.ucp.common.ask）を実装している。
{shop}.myshopify.com、新は {shop-domain}。パスも /api/mcp → /api/ucp/mcp に変わる。
| 項目 | 旧 ： search_shop_policies_and_faqs | 新 ： ask_business |
|---|---|---|
| サーバー | Storefront MCP | UCP MCP |
| エンドポイント | https://{shop}.myshopify.com/api/mcp |
https://{shop-domain}/api/ucp/mcp |
| エージェント識別 | 記載なし | 必須 全リクエストに meta で ucp-agent.profile |
| 質問の渡し方 | 記載なし | ask.query（＋任意で ask.context） |
| 返ってくるもの | （新ツールとの対比から）ナレッジベースの事実やポリシー本文に相当する生データ ※詳細な形式は記載なし | 文章の回答 result.structuredContent.answer.plain |
| 提供有無の確認 | 記載なし | tools/list でエージェントプロファイルごとに確認 |
| ステータス | 非推奨 2027/1/15 まで維持 | 推奨 ドキュメントの参照先 |
meta の正確な JSON 構造や ask.context に入れられる項目の一覧は記事に記載なし。詳細は Ask MCP のドキュメント（https://shopify.dev/docs/agents/ask）を参照。ツール呼び出しを ask_business に変更し、エンドポイントを https://{shop-domain}/api/ucp/mcp に更新。
全リクエストに ucp-agent.profile を持つ meta を付与。プロファイルは dev.ucp.common.ask を宣言していること。
質問は ask.query、国や希望言語などの任意の文脈は ask.context に入れる。
回答は result.structuredContent.answer.plain の文章。旧レスポンスをパースしていたコードは要修正。
そのストアが自分のエージェントプロファイルに対して ask_business を提供しているかを tools/list で確認。
旧 {shop}.myshopify.com/api/mcp → 新 {shop-domain}/api/ucp/mcp。URL を組み立てるロジックで myshopify ドメイン前提にしている場合は、ホストの扱いも見直す。
全リクエストに meta の ucp-agent.profile が必須。プロファイルは dev.ucp.common.ask を宣言していなければならない。プロファイルの準備が移行の最初のブロッカーになりうる。
ask_business が返すのは文章の回答（answer.plain）で、ナレッジベースの生データやポリシー全文ではない。生データを加工・引用していた実装は設計から見直しが必要。
ask.context で国や希望言語などの買い手の文脈を任意で渡せる。エージェントが持っているロケール情報をそのまま渡す配線を用意しておくとよい。
記事は「tools/list でストアが自分のエージェントプロファイル向けに ask_business を提供しているか確認せよ」としている。全ストアで常に使えるとは限らない前提で、呼び出し前のツール存在チェックを組み込むのが安全。提供されない場合の挙動・条件は記載なし。
search_shop_policies_and_faqs で返品・配送ポリシー等の質問に答えるエージェントを運用中。2027/1/15 の維持期限が迫る。meta（ucp-agent.profile）・ask.query・レスポンス解析の 4 点を改修し、期限前に新旧を並行稼働して回答を比較してから切り替える。ask.context に入れて ask_business を呼ぶ。ask.context に入れられる項目の正式な一覧は記事に記載なし。Ask MCP ドキュメントで確認してから実装する。ask_business が提供されているか分からず、呼び出し失敗の扱いが曖昧。tools/list を叩き、ask_business があるストアだけ呼び出す。無いストアでは「ポリシーはストアのページで確認してください」等の案内に切り替える。tools/list 結果のキャッシュ期間の目安は記載なし。ask_business へ移行が必要。ask.query 形式・“検索結果”ではなく“文章の回答”が返る点。