技能介绍

解决的问题

在 Agent 替用户购物时，常见路径要么直接抓取商户站点，要么绕过平台接入支付，风险高；即使只是搜商品、比价、凑购物车，也可能在缺少统一 profile 和确认机制时把商品、价格、库存和结账责任混在一起。这个技能把 Agent 角色限定为“可发现、可注册、可确认、可交接”，搜索与购物车属于操作前准备，支付只在商家站点完成。

如何工作

核心入口是一个 MCP HTTP 服务，路径为 /mcp。Agent 可先 GET /mcp 读取引导，或用 POST 发送 JSON-RPC initialize；随后调用 tools/list 获取当前工具名、输入/输出 schema，再通过 resources/list 读取 ucp://gateway/profile-registration 或 ucp://gateway/agent-guide。需要流程说明时，可取 ucp-profile-registration、ucp-shopping-flow 或 ucp-operator-handoff。

注册档案时，Agent 本地生成或复用 ECDSA P-256 密钥对，只把 public_key_jwk 发给网关，并调用 register_ucp_profile，传入 agent_name、public_key_jwk、可选的 namespace、description、公开 metadata，以及 skill_name 设为 ucp-gateway-skill。网关返回 agent_id、profile_url、registry_url 等状态，建议保存到 ./.ucpgateway/agent.json。若走旧式 profile_json，需要精确写明能力键，例如 dev.ucp.shopping.catalog.search、dev.ucp.shopping.cart。

购物流程强调确认点：shopping_product_search 和 shopping_product_get 只读；生成或更新购物车前先让用户确认；展示价格、选项、库存信息；结账前只收集用户本人提供的资料，并再次确认；确认后才调用 shopping_checkout_create 且设置 operator_confirmed: true，最后把返回的 continue_url 交给用户。网关响应中的 result.structuredContent.next_step 应作为下一步建议，arguments_hint 不等于授权。