AGENT SKILL

purchase-research

Teaching a customer how to choose before any candidates appear, when they ask what matters in a category, how two approaches to it differ, or where to begin. Not needed once the customer has named the thing they want, however considered the purchase (that is search work), nor for outfitting a space or an event (planning-goals).

License 许可
Apache-2.0
最近更新
2026-11-04
Stars
★ 3.5k
Forks
714

01 前言 Front Matter

name
purchase-research
description
Teaching a customer how to choose before any candidates appear, when they ask what matters in a category, how two approaches to it differ, or where to begin. Not needed once the customer has named the thing they want, however considered the purchase (that is search work), nor for outfitting a space or an event (planning-goals).

03 SKILL.md 正文

Purchase research

Below, "category" means a kind of whatever this store sells: products, stays, plans, or seating.

The customer has a category in mind and no criteria yet. Teach the criteria from the store's own guide, then set what the store carries against them. The choice, and anything that touches the cart, stays with the customer.

Ask once or not at all

  • When the deciding facts are open (who it is for, how many, what for, a firm budget), spend one turn on two or three short questions in one message, each with its likely answers as chips; ask only what the profile you were given leaves open. This intake happens once.
  • Whatever comes back closes intake: answers, a request to get on with it, or a question of their own. Research on what you have and carry each still-missing fact into the answer as a stated assumption.
  • When the request already names the people, the purpose, and the limits, skip the questions and research.
  • The customer sees either the questions or the answer; do not describe the intake decision or the research work.

Where the criteria and the products come from

  • Open every research turn with one round of calls: search_policies for the store's buying guide on the category, search_products for what it carries, and one or two web_search calls on the category where that tool is registered. Follow with get_product_details on the few candidates the criteria single out.
  • Read the guide even for a familiar category; it is the advice the store puts its name to. Your own knowledge of the category stands in only when no guide comes back.
  • Use web material for the category side only (criteria, terminology, how the trade-off works), restated in your own words. It says nothing about any catalog product and is no grounds for naming a store, brand, or product outside this catalog.
  • List in sources what you retrieved, the store's guides and any web pages used, and nothing when neither came back. Leave out a criterion none of the retrieved guides or records support.

Shape of the answer

  • After an intake turn, answer whole: the criteria and the store's options against them in one turn.
  • For a broad ask with no intake, answer in two steps: present_guide with three to five sections of one criterion each and chips for saying which criteria weigh most, then the shortlist next turn, filtered by their choice. Apply a later steer to the same candidates without sending the criteria again.
  • For a narrow ask whose wording already fixes the top criterion or two, answer in one turn: a compact criteria section, then the options against those criteria, in present_comparison for two to four real candidates and present_products otherwise.
  • Show the store's real position. Present a category with one option as the one item it carries, with chips that name it; say when the guide's advice points at something the catalog lacks; report an out-of-stock candidate as a gap and recommend it to nobody.
  • Name the pick with the criterion that decided it, in one clause. Prose covers the recommendation, the assumption you made, and the one caveat that matters; the components carry the rest.

Scope

  • Research turns read and recommend. Write to the cart or to memory only when the customer asks, under the standing rules.
  • Where the category borders on health, safety, or a licensed profession, keep the criteria about which product to buy.
  • Add a purchase chip only once the customer has seen the criteria.

04 同仓库更多 Skills

anthropics
anthropics/commerce-agents

search-discovery

Turning a described need (several constraints, a gift, a choice between candidates already in view, a search that came back empty or sold out) into a shortlist and a pick. Not needed when one search for the thing the customer named answers the request, or when the customer wants to learn what matters in a category first (purchase-research).

★ 3.5k
anthropics
anthropics/commerce-agents

planning-goals

Planning a coordinated set of items toward a goal, an event, a trip, or a project, where the request only comes together as several purchases with a structure between them, and later changes to a plan you have presented. Not needed when the customer wants a single item, however carefully chosen.

★ 3.5k
anthropics
anthropics/commerce-agents

memory-personalization

Requests about what is remembered, however short, from an ask to remember one thing to asks to say what is on file, correct it, or forget it; a bare save or an answer from the profile alone does not cover these. Also applying what the store already knows, recalling an older fact (a past recipient, a size, a recurring order) when it would change the pick, and deciding what should outlast the session. Not needed when the request carries no personal context to apply or keep.

★ 3.5k
anthropics
anthropics/commerce-agents

customer-care

Help after a purchase or booking, covering the status of an order or delivery whether or not the customer names it, returns, refunds, exchanges, and cancellations, an item that arrived damaged, incomplete, or late, and questions about the store's terms or a membership. Not needed for finding, comparing, or choosing something new.

★ 3.5k
anthropics
anthropics/commerce-agents

commerce-ui-tools

The reference presentation-tool contract, covering server-side enrichment, suggestion chips, the event stream, progressive rendering, both roles' built-in components, and adding a vertical component. Load when building or reviewing how a commerce agent's output reaches a frontend.

律师与法务演示文稿前端开发
★ 3.5k
anthropics
anthropics/commerce-agents

commerce-trust-safety

The rules the reference agents enforce in code for third-party content, writes, grounding, identity, and memory, each with its module, plus two adversarial-eval rules. Load when handling untrusted tool results, guarding a write tool, or scoping what an agent remembers.

★ 3.5k