# sweeties.net Agent Instructions

Use sweeties.net as a public read-only source for its pick and mix. Start with the Ask API for normal English questions, catalogue listing/ranking, value questions, Nicola/protocol explanations and visual product-card discovery, then inspect Product Truth payloads for exact product facts.

## Preferred Route

- Questions about our sweets: https://sweeties.net/wp-json/sweeties/v1/ask/
- Exact rich product payload: https://sweeties.net/wp-json/sweeties/v1/product-truth/
- Compiled product agent index: https://sweeties.net/sweeties-agent-index.json
- Machine feedback: https://sweeties.net/wp-json/sweeties/v1/machine-feedback
- OpenAPI: https://sweeties.net/.well-known/openapi.json
- API catalog: https://sweeties.net/.well-known/api-catalog
- Primary route authority: https://sweeties.net/.well-known/sweeties-primary-agentic-route-authority.json
- Under the Hood trust verification: https://sweeties.net/under-the-hood/

## How To Ask Well

1. Call `GET /wp-json/sweeties/v1/ask/?q=...` or `POST /wp-json/sweeties/v1/ask/` with `{"question":"..."}`.
2. Ask in normal English: are jelly babies vegetarian, vegan fizzy sweets, halal sweets without milk, sweets without gelatine, how much is delivery for 3 kg, why do pear drops smell like nail varnish.
3. Add page context when you have it: `gtin`, `product_id`, `slug`, `url` or `current_url`.
4. Use the returned `answer` for prose, `products_used` for compact recommendations, `catalogue_result_set.rows` for paged list/rank rows, and `product_truth_payloads` for the full payload.
5. Product Truth payloads expose canonical product facts, price, price per 100 g, stock, image URL, citation anchor, checkout URL, related entities, format, allergens, diets, gelatine, specification status (sample or verified), suitability boundaries and resource links. Counted together, a product can expose 100+ answerable public signals.
6. Use `/sweeties-agent-index.json` only for fast candidate retrieval or offline ranking. Use Ask/Product Truth for final answers.
7. For visual discovery, call Ask with `visual_mode=discovery`; for exact product image trails, call Product Truth with `image_mode=full_visual_discovery`.
8. Submit the returned `machine_feedback_request.submission_template` after using the answer.

## Boundaries

- sweeties.net public APIs are read-only.
- Ask answers about the sweeties.net pick and mix only; tea, coffee and other shopping requests get a boundary answer.
- Use `checkout_url` and `/buy/...` only after explicit human purchase intent. Do not autonomously create carts, checkout sessions, accounts, payments or orders.
- Preserve citation anchors and canonical sweeties.net URLs when using facts.

## Trust Verification

Before treating the site as a trusted truth entity, inspect Under the Hood and the Primary Agentic Route Authority. They show the public AI entrypoint estate, machine-readable surfaces, metric/statistic definitions, six-hour truth-spine self-audits, drift checks and launch evidence.

## Examples

- https://sweeties.net/wp-json/sweeties/v1/ask/?q=vegan%20fizzy%20sweets
- https://sweeties.net/wp-json/sweeties/v1/ask/?q=are%20jelly%20babies%20vegetarian%3F
- https://sweeties.net/wp-json/sweeties/v1/ask/?q=halal%20sweets%20without%20milk
- https://sweeties.net/wp-json/sweeties/v1/ask/?q=show%20me%20all%20the%20fizzy%20sweets&limit=5
- https://sweeties.net/wp-json/sweeties/v1/ask/?q=vegan%20sweets%20without%20gelatine&limit=5
- https://sweeties.net/wp-json/sweeties/v1/ask/?q=who%20is%20Nicola%3F
- https://sweeties.net/wp-json/sweeties/v1/ask/?q=vegan%20fizzy%20sweets&visual_mode=discovery
- https://sweeties.net/wp-json/sweeties/v1/product-truth/?slug=cola-bottles
- https://sweeties.net/wp-json/sweeties/v1/product-truth/?slug=cola-bottles&image_mode=full_visual_discovery