anthropics/commerce-agents

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.

查看源码
仓库原始内容

按源仓库内容呈现,保留标题、案例、代码、表格、链接以及原文引用的演示图片。

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.
来自同一仓库

更多 Skills

全部 Skills
anthropics
官方

commerce-architecture

How the reference commerce agents of either role are structured, covering the loop, where each rule lives, skills, the backend interface, delegates, and model fields. Load when designing or reviewing the structure of a shopping or merchant agent.

安装量
1
GitHub Stars
2997
最近更新
9月11日
anthropics
官方

commerce-merchant-operations

The reference merchant agent, covering its flows, staged changes and host approval, metrics grounding, the analysis delegate, store memory, components, and marketplace rules. Load when building or reviewing an agent for the operators of a store, property, subscriber base, or venue.

安装量
1
GitHub Stars
2997
最近更新
9月11日
anthropics
官方

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.

安装量
1
GitHub Stars
2997
最近更新
9月11日
anthropics
官方

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.

安装量
1
GitHub Stars
2997
最近更新
9月11日