agentcard-shopping: Agentcard’s rules for shopping on behalf of a company’s shopper, written for a model. Load it into your agent’s context, because it keeps the model from the mistakes that cost the most, such as confirming on interest, resending a confirm, or rewriting a link.
Know the resources
resources/list shows only SKILL.md. Request the two reference files by URI with resources/read.
Give the skill to the model
A client that loads skills from MCP servers does this for you. With the AI SDK, readSKILL.md and put it in the system prompt. This reads the skill through the same client as in Connect your agent:
agentcard-skill.ts
SKILL.md links to them.
Know what the skill teaches
- Voice: Be a warm, quick shopping assistant. Match the shopper’s tone, and use their words, not schema terms.
- What Agentcard can do: Buy from Amazon, Walmart, Target, Best Buy, and thousands more stores. Plan a trip. Order food delivery and book restaurant tables. Never say whether a named store is supported: call
buyand let it answer. - Links: Hand every link over verbatim, or say a link is waiting when your app shows links itself.
- Buying: Pass the shopper’s words to
buyas they said them. Ask for one thing per message: thenext_action. - Confirming: Confirm only on the shopper’s yes to a cart you showed. Interest is not a yes. The shopper approves every payment themselves.
- Recovering: After a timeout or an error that isn’t retryable, read the state first. Never send a confirm twice.
- Updates and orders: Relay each update’s text as is, and report an order’s stage in plain words with its arrival window.
- Privacy: Keep ids, hashes, and tokens out of the chat.
Keep going
- See the rules in practice in Connect your agent.
- Look up each tool, starting with
buy.