Jak przygotować stronę pod Buying Agenta (Agent-Ready)

Uniwersalny schemat: Jak przygotować stronę pod Buying Agenta (Agent-Ready)

Poniżej masz gotowy, powtarzalny blueprint do wdrożenia na dowolnej domenie B2B/B2C. Składa się z warstw: Informacja → Dane → Akcja → Wymiana → Zgodność → Monitoring. Wystarczy podmienić nazwy produktów/usług i uruchomić.

1) Cel i zasady (co agent ma umieć zrobić)

Zrozumieć: temat, parametry, ograniczenia (budżet, lead time, SLA, zgodność).
Porównać: warianty A/B/C w zunifikowanych metrykach (TCO/ROI/MTBF/LeadTime).
Zadziałać: wysłać RFQ, zamówić (OrderAction), zarezerwować termin (BookAction), wynająć (RentAction).
Udokumentować: numer sprawy, log działań, zgody i polityki.

2) Warstwa informacji (GEO/AEO/AIO-ready)

Architektura treści (pillar → klastry):

Pillar {topic}/ z Short Answer, mapą klastrów i spisem treści.
Q&A: definicje i odpowiedzi (300–600 znaków na start).
HowTo/SOP: kroki + kontrola jakości + wideo 60–120 s.
Comparison: tabela A/B/C + „kiedy wybrać” + mini-kalkulator.
Pricing/ROI: widełki, czynniki, TCO/1000, FAQ cenowe.
Case/Proof: „przed/po” z liczbami.
Service/Troubleshooting: drzewko diagnostyczne, części z SKU.
Compliance: zasady/regulacje + checklisty (CSV).

Elementy, które agent kocha:

Short Answer na górze (z linkami do kluczowych podstron).
Tabele parametrów z podpisem (caption) i stabilnymi ID sekcji.
Wideo (YouTube/embed) z VideoObject i timestampami.

3) Warstwa danych (schema.org + pliki)

Globalnie: Organization (+ContactPoint), BreadcrumbList.
Treści: FAQPage, HowTo, VideoObject.
Karty produktów/usług: Product + Offer + PriceSpecification.
Strony akcyjne: QuoteAction, OrderAction, RentAction, BookAction z EntryPoint.

Minimalny snippet na kartę produktu (skrót):

<script type="application/ld+json">
{
 "@context":"https://schema.org",
 "@type":"Product",
 "name":"{Nazwa produktu}",
 "sku":"{SKU}",
 "brand":{"@type":"Brand","name":"{Brand}"},
 "additionalProperty":[
   {"@type":"PropertyValue","name":"Szerokość","value":"600 mm"},
   {"@type":"PropertyValue","name":"MTBF","value":"5000 h"}
 ],
 "offers":{
   "@type":"Offer",
   "priceCurrency":"PLN",
   "price":"24500",
   "availability":"https://schema.org/InStock",
   "priceSpecification":{"@type":"PriceSpecification","price":"24500"}
 }
}
</script>

4) Warstwa akcji (Tryb Agenta)

A. RFQ/QuoteAction — punkt wejścia dla zapytań

<script type="application/ld+json">
{
 "@context":"https://schema.org",
 "@type":"QuoteAction",
 "target":{
   "@type":"EntryPoint",
   "urlTemplate":"https://example.com/api/rfq",
   "httpMethod":"POST",
   "encodingType":"application/json"
 },
 "result":["EstimatedCost","LeadTime","SLA"]
}
</script>

Przykładowy payload RFQ (JSON):

{
  "rfq_id": "auto", 
  "company": {"name":"ACME Sp. z o.o.","vat":"PL1234567890"},
  "contact": {"email":"buyer@acme.pl","phone":"+48 501 000 000"},
  "ship_to": {"city":"Warszawa","postal_code":"02-001","street":"Przemysłowa 1"},
  "items": [{"sku":"WR-600x400-12MM","qty":1}],
  "constraints": {"budget_pln_max":30000,"lead_time_days_max":21,"sla":"NBD"},
  "usage": {"volume_per_month":8000,"shift":"2"},
  "terms": {"incoterms":"DAP","warranty_months_min":12}
}

B. OrderAction / RentAction / BookAction — złożenie zamówienia/rezerwacji

<script type="application/ld+json">
{
 "@context":"https://schema.org",
 "@type":"OrderAction",
 "target":{"@type":"EntryPoint","urlTemplate":"https://example.com/api/order","httpMethod":"POST","encodingType":"application/json"},
 "expectsAcceptanceOf":{"@type":"Offer","sku":"WR-600x400-12MM"}
}
</script>

Statusy, które ułatwiają bot-to-bot:

received → under_review → need_more_info → quoted → accepted → ordered → scheduled → fulfilled/closed.

5) Formularze (dla ludzi i agentów)

RFQ – pola obowiązkowe (MVP):

Firma (nazwa, NIP/VAT), kontakt (e-mail, telefon).
Adres dostawy (miasto, kod, ulica).
Pozycje (SKU + ilość) lub konfigurator.
Ograniczenia: budżet max, lead time max, SLA/serwis.
Zgody/RODO.

Walidacje i UX:

Maski dla telefonu/kodu pocztowego, selektory SLA, sugestie miast.
ID zapytania + potwierdzenie e-mail z kopią payloadu (JSON/PDF).
„Wyślij jako CSV/JSON” (dla Buying Agentów).

HTML (fragment prostego RFQ):

<form id="rfq" action="/api/rfq" method="post">
  <input name="company_name" required>
  <input name="vat" required pattern="^([A-Z]{2})?[0-9A-Za-z]{8,12}$">
  <input type="email" name="email" required>
  <input name="phone" required>
  <input name="ship_city" required>
  <input name="ship_postal" required>
  <input name="ship_street" required>
  <input name="sku" required>
  <input type="number" name="qty" min="1" value="1" required>
  <input type="number" name="budget_pln_max">
  <input type="number" name="lead_time_days_max">
  <select name="sla"><option>NBD</option><option>48h</option></select>
  <label><input type="checkbox" name="consent" required> Akceptuję politykę</label>
  <button type="submit">Poproś o wycenę</button>
</form>

6) Wymiana danych (bot-to-bot)

CSV — specyfikacja produktów (kolumny przykładowe):

sku,name,category,brand,price_net_pln,lead_time_days,mtbf_h,power_kw,options_json
WR-600x400-12MM,Wiązarka ramowa 600x400,strapper,BrandX,24500,14,5000,1.2,"{""belt_width_mm"":12,""frame_mm"":""600x400""}"

Webhooks & idempotencja:

Odpowiadaj 202 z rfq_id.
Idempotency-Key w nagłówku dla OrderAction.
Retry-policy z backoff (np. 1s/5s/15s).

Autoryzacja:

Klucze API lub mTLS dla partnerów.
Rate limit (np. 60 req/min/IP; 600 req/min/API key).

(Opcjonalnie) plik informacyjny typu llms.txt/agents.txt w .well-known/ z:

dozwolone endpointy, metody, limity, wymagane pola, zasady etyczne (tylko informacyjnie – nie standard, ale praktyczne).

7) Zgodność, bezpieczeństwo, governance

RODO/consent: pola zgód, link do polityki, cel przetwarzania.
Log audytu: kto/co/kiedy (payload, IP, user-agent, hash).
Polityki zamówień: limity kwotowe, wymóg 2 ofert > X PLN.
PPWR/zgodność (jeśli dotyczy): parametry materiałowe i ślad środowiskowy jako additionalProperty lub osobny Dataset.
WCAG 2.1 AA dla formularzy i wideo (napisy).

8) Monitoring i KPI (telemetria Agent-Ready)

Zdarzenia (eventy):

short_answer_viewed, table_anchor_clicked, video_play_25/50/95.
rfq_submitted, rfq_quoted, order_placed, book_scheduled.
error_4xx/5xx, rate_limit_hit.

KPI:

TtQ: czas do 3 ofert.
Inclusion w AIO: liczba zapytań, gdzie AIO cytuje Twój URL/YouTube.
CR akcyjne: RFQ→Oferta→Zamówienie.
Lead time accuracy: deklaracja vs realizacja.
% stron z wideo i Short Answer.

9) 30/60/90 — plan wdrożenia

0–30 dni (MVP Informacja + Akcja)

Pillar + 5–8 stron klastra (Q&A/HowTo/Comparison/Pricing) z Short Answer, tabelami i 2 krótkimi wideo.
Product/Offer + QuoteAction (EntryPoint POST/JSON).
Formularz RFQ (walidacja) + e-mail potwierdzający i ID sprawy.
Logi, zgody, podstawowe KPI (TtQ, CR RFQ).

31–60 dni (Operacjonalizacja danych i procesów)

OrderAction/RentAction/BookAction + webhooki.
CSV/JSON (specyfikacje, cenniki, SLA), idempotencja, rate-limit.
3–5 porównań A/B/C + 1–2 kalkulatory TCO (embed/JSON).
Dashboard KPI, alerty błędów 4xx/5xx.

61–90 dni (Skala i partnerstwa)

Dostępy API dla wybranych Buying Agentów (klucze, mTLS).
Case studies z liczbami, wideo referencyjne.
Pętle feedbacku: realne MTBF/TCO → auto-aktualizacja ofert.
Testy chaos/rate-limit i DR (disaster recovery).

10) Szablony do skopiowania (ready-to-use)

VideoObject (skrót):

<script type="application/ld+json">
{
 "@context":"https://schema.org",
 "@type":"VideoObject",
 "name":"{Temat} — demo 90 s",
 "description":"Hook → demo → decyzja → CTA.",
 "thumbnailUrl":"https://i.ytimg.com/vi/{VIDEOID}/hqdefault.jpg",
 "uploadDate":"2025-09-01",
 "embedUrl":"https://www.youtube.com/embed/{VIDEOID}"
}
</script>

FAQPage (skrót):

<script type="application/ld+json">
{
 "@context":"https://schema.org",
 "@type":"FAQPage",
 "mainEntity":[
  {"@type":"Question","name":"Ile to kosztuje?","acceptedAnswer":{"@type":"Answer","text":"Widełki X–Y, zależy od..."}},
  {"@type":"Question","name":"Jaki lead time?","acceptedAnswer":{"@type":"Answer","text":"Zwykle 7–21 dni..."}}
 ]
}
</script>

Webhook odpowiedzi RFQ (JSON – przykład):

{
  "rfq_id": "RFQ-2025-09-1234",
  "quote_at": "2025-09-23T09:30:00Z",
  "items": [
    {"sku":"WR-600x400-12MM","price_net_pln":23900,"lead_time_days":14,"warranty_months":24}
  ],
  "sla":"NBD",
  "valid_until":"2025-10-07",
  "attachments":["https://example.com/quotes/RFQ-2025-09-1234.pdf"]
}

11) Najczęstsze „blokera” i szybkie remedia

Brak akcji w danych → Dodaj QuoteAction/OrderAction z prawdziwym EntryPoint.
Parametry nieporównywalne → Ustal słownik i jednostki (mm, kW, h, PLN).
Zamknięte cenniki → Podaj widełki + czynniki ceny + RFQ.
Brak potwierdzeń → Zawsze zwracaj rfq_id/order_id oraz e-mail z podsumowaniem.
Brak wideo → Minimum 3 klipy (Q&A/HowTo/Comparison) po 60–120 s.

12) Checklista „Agent-Ready” (do odhaczenia)

KPI i alerty (TtQ, inclusion AIO, CR akcji, lead time accuracy).

Pillar + klastry (Q&A/HowTo/Comparison/Pricing/Case/Service/Compliance).

Short Answer + tabele z ID + wideo 60–120 s (VideoObject).

Product + Offer + PriceSpecification.

QuoteAction (+ OrderAction/RentAction/BookAction) z EntryPoint.

Formularz RFQ (walidacje, zgody, numer sprawy).

CSV/JSON do pobrania (specyfikacje, cenniki, SLA).

Webhooki, idempotencja, rate-limit, log audytu.

Wejdź do świata AI

Napisz do nas: kontakt@integratorai.pl

Case study

CatFood.pl — wdrożenie „Agent-Ready” pod Buying Agenta (GEO/AEO/AIO)

Short Answer

W 90 dni przebudowaliśmy CatFood.pl według schematu Informacja → Dane → Akcja → Wymiana → Zgodność → Monitoring, tak aby Buying Agenci (i ludzie) mogli zrozumieć ofertę, porównać warianty żywieniowe, otrzymać wycenę i złożyć zamówienie/subskrypcję w jednym, mierzalnym przepływie (także bot-to-bot).

1) Cel i zasady (co agent ma umieć zrobić)

Zrozumieć: gatunek, wiek, waga, aktywność, alergie, budżet, lead time, SLA dostaw.
Porównać: plany Sucha vs Mokra vs Mix w zunifikowanych metrykach (kcal/dzień, gramatura/dzień, koszt/dzień, lead time, NPS).
Zadziałać: wysłać RFQ, złożyć zamówienie (OrderAction), zarezerwować konsultację (BookAction), włączyć subskrypcję (wariant „wynajmu” = RentAction analogicznie do cyklicznej dostawy).
Udokumentować: numer sprawy, statusy, logi działań, zgody i polityki.

2) Warstwa informacji (GEO/AEO/AIO-ready)

Architektura treści (pillar → klastry)

Pillar: /plany-zywieniowe/ z Short Answer, mapą klastrów i spisem treści.
Q&A: .../co-to-jest-plan-zywieniowy/, .../kiedy-zmienic-porcje/ (300–600 znaków na start).
HowTo/SOP: .../howto/dobor-porcji/, .../howto/eliminacja-alergenow/ + wideo 60–120 s.
Comparison: .../porownanie/sucha-vs-mokra-vs-mix/ + „kiedy wybrać” + mini-kalkulator koszt/dzień.
Pricing/ROI: .../cena/, .../kalkulator/ (widełki, czynniki, TCO/30 dni, FAQ cenowe).
Case/Proof: .../case/otyłość-redukcja-12-tyg/ („przed/po” z liczbami).
Service/Troubleshooting: .../serwis/zwrot-wymiana-smaku/ (drzewko diagnostyczne).
Compliance: .../regulacje/etykiety-i-skladniki/ + checklisty (CSV) dot. alergenów i deklaracji.

Elementy, które agent „kocha”

Short Answer na górze (z linkami do HowTo/Porównania/Cennika).
Tabele parametrów z podpisem (caption) i stabilnymi ID sekcji (np. #tabela-porcji).
Wideo (YouTube/embed) z VideoObject i timestampami (rozdziały).

3) Warstwa danych (schema.org + pliki)

Globalnie: Organization (+ContactPoint), BreadcrumbList
Treści: FAQPage, HowTo, VideoObject
Karty planów: Product + Offer + PriceSpecification (+ makro w additionalProperty)
Strony akcyjne: QuoteAction, OrderAction, RentAction (subskrypcja), BookAction (konsultacja) z prawdziwym EntryPoint

Minimalny snippet na kartę planu (skrót):

<script type="application/ld+json">
{
 "@context":"https://schema.org",
 "@type":"Product",
 "name":"Plan Kot Dorosły MIX M",
 "sku":"Plan-Cat-Adult-Mix-M",
 "brand":{"@type":"Brand","name":"CatFood.pl"},
 "additionalProperty":[
   {"@type":"PropertyValue","name":"Kaloryczność","value":"360 kcal/100g"},
   {"@type":"PropertyValue","name":"Białko","value":"34%"}
 ],
 "offers":{
   "@type":"Offer",
   "priceCurrency":"PLN",
   "price":"79.90",
   "availability":"https://schema.org/InStock",
   "priceSpecification":{"@type":"PriceSpecification","price":"79.90"}
 }
}
</script>

4) Warstwa akcji (Tryb Agenta)

A. RFQ / `QuoteAction` — punkt wejścia dla zapytań

<script type="application/ld+json">
{
 "@context":"https://schema.org",
 "@type":"QuoteAction",
 "target":{
   "@type":"EntryPoint",
   "urlTemplate":"https://catfood.pl/api/rfq",
   "httpMethod":"POST",
   "encodingType":"application/json"
 },
 "result":["RecommendedPlan","EstimatedCost","LeadTime"]
}
</script>

Przykładowy payload RFQ (JSON):

{
  "rfq_id": "auto",
  "pet": {"species":"cat","age_m":30,"weight_kg":4.2,"activity":"low","allergies":["chicken"]},
  "preferences": {"dry":true,"wet":true,"mix":true,"max_cost_per_day_pln":6.5},
  "delivery": {"city":"Warszawa","postal_code":"00-001"},
  "contact": {"email":"ola@example.pl","phone":"+48 501 000 000"}
}

B. `OrderAction` / `RentAction` (subskrypcja) / `BookAction`

<script type="application/ld+json">
{
 "@context":"https://schema.org",
 "@type":"OrderAction",
 "target":{"@type":"EntryPoint","urlTemplate":"https://catfood.pl/api/order","httpMethod":"POST","encodingType":"application/json"},
 "expectsAcceptanceOf":{"@type":"Offer","sku":"Plan-Cat-Adult-Mix-M"}
}
</script>

Statusy bot-to-bot:
received → under_review → need_more_info → quoted → accepted → ordered → scheduled → fulfilled/closed

5) Formularze (dla ludzi i agentów)

RFQ — pola obowiązkowe (MVP)

Firma/osoba (dla B2C wystarczy imię + e-mail), NIP/VAT (B2B), kontakt.
Dostawa (miasto, kod, ulica).
Zwierzę (species, age_m, weight_kg, activity, allergies).
Ograniczenia (budżet max, lead time max), zgody/RODO.

Walidacje i UX

Maski dla telefonu/kodu pocztowego, selektory aktywności, sugestie miast.
ID zapytania + e-mail potwierdzający z kopią payloadu (JSON/PDF).
Przycisk „Wyślij jako CSV/JSON” (dla Buying Agentów).

HTML (fragment prostego RFQ):

<form id="rfq" action="/api/rfq" method="post">
  <input name="name" placeholder="Imię / Nazwa firmy" required>
  <input name="vat" placeholder="NIP (jeśli B2B)" pattern="^([A-Z]{2})?[0-9A-Za-z]{8,12}$">
  <input type="email" name="email" required placeholder="email@example.pl">
  <input name="phone" required placeholder="+48 5xx xxx xxx">
  <input name="ship_city" required placeholder="Miasto">
  <input name="ship_postal" required placeholder="00-000">
  <input name="ship_street" required placeholder="Ulica 1">
  <select name="species" required><option value="cat">Kot</option><option value="dog">Pies</option></select>
  <input type="number" step="0.1" name="weight_kg" required placeholder="Waga (kg)">
  <select name="activity"><option>low</option><option>medium</option><option>high</option></select>
  <input name="allergies" placeholder="Alergie (np. chicken, beef)">
  <input type="number" step="0.1" name="max_cost_per_day_pln" placeholder="Budżet (PLN/dzień)">
  <label><input type="checkbox" name="consent" required> Akceptuję politykę prywatności</label>
  <button type="submit">Poproś o rekomendację planu</button>
</form>

6) Wymiana danych (bot-to-bot)

CSV — specyfikacja planów (kolumny przykładowe):

sku,name,price_week_pln,lead_time_days,kcal_100g,protein_pct,fat_pct,forms,allergens
Plan-Cat-Adult-Mix-M,Plan Kot Dorosły MIX M,79.90,2,360,34,16,"dry,wet","chicken"
Plan-Cat-Adult-Dry-M,Plan Kot Dorosły DRY M,69.90,2,380,35,14,"dry","beef"

Webhooks & idempotencja

Zwracaj 202 z rfq_id i linkiem do statusu.
Używaj Idempotency-Key dla OrderAction.
Retry z backoff (1s/5s/15s).

Autoryzacja & limity

Klucze API / mTLS dla partnerów; rate limit 60 req/min/IP; 600 req/min/API key.

(Opcjonalnie) .well-known/agents.txt

Endpoints, metody, limity, wymagane pola, zasady etyczne (informacyjnie).

7) Zgodność, bezpieczeństwo, governance

RODO/consent: cel (rekomendacja, obsługa zamówienia), retention, prawo do wglądu/wycofania.
Log audytu: kto/co/kiedy (payload hash, IP, user-agent).
Polityki zamówień: limity (np. pierwsza subskrypcja ≤ X PLN bez kontaktu), wymóg potwierdzenia smaku przy alergiach.
Etykiety/składy: aktualizacje + changelog; klasyfikacja alergenów.
WCAG 2.1 AA: formularze, kontrast, napisy do wideo.

8) Monitoring i KPI (telemetria Agent-Ready)

Zdarzenia:
short_answer_viewed, table_anchor_clicked, video_play_25/50/95,
rfq_submitted, rfq_quoted, order_placed, book_scheduled,
error_4xx/5xx, rate_limit_hit.

KPI:

TtQ: czas do 3 ofert/rekomendacji.
Inclusion w AIO: liczba zapytań, w których AIO cytuje URL/YouTube CatFood.pl.
CR akcyjne: RFQ→Oferta→Zamówienie.
Lead time accuracy: deklaracja vs realizacja.
% stron z Short Answer i wideo.

9) Plan 30/60/90 — wdrożenie

0–30 dni (MVP Informacja + Akcja)

Pillar + 5–8 stron (Q&A/HowTo/Comparison/Pricing) z Short Answer, tabelami i 2 krótkimi wideo.
Product/Offer na głównych planach + QuoteAction (EntryPoint POST/JSON).
Formularz RFQ (walidacja), potwierdzenie e-mail + ID sprawy.
Logi, zgody, wstępne KPI (TtQ, CR RFQ).

31–60 dni (Operacjonalizacja danych i procesów)

OrderAction / RentAction / BookAction + webhooki (statusy).
Publiczne CSV/JSON (specyfikacje, cenniki, SLA), idempotencja, rate-limit.
3–5 porównań A/B/C + 1–2 kalkulatory koszt/dzień (embed/JSON).
Dashboard KPI, alerty błędów 4xx/5xx.

61–90 dni (Skala i partnerstwa)

Dostępy API dla wybranych Buying Agentów (klucze, mTLS).
Case studies z liczbami + wideo referencyjne klientów.
Feedback loop: realne NPS/zwroty → auto-korekta rekomendacji SKU.
Testy chaos/rate-limit i DR (disaster recovery).

10) Szablony do skopiowania (ready-to-use)

VideoObject (skrót):

<script type="application/ld+json">
{
 "@context":"https://schema.org",
 "@type":"VideoObject",
 "name":"Jak dobrać plan żywieniowy — demo 90 s",
 "description":"Hook → demo → decyzja → CTA.",
 "thumbnailUrl":"https://i.ytimg.com/vi/{VIDEOID}/hqdefault.jpg",
 "uploadDate":"2025-09-01",
 "embedUrl":"https://www.youtube.com/embed/{VIDEOID}"
}
</script>

FAQPage (skrót):

<script type="application/ld+json">
{
 "@context":"https://schema.org",
 "@type":"FAQPage",
 "mainEntity":[
  {"@type":"Question","name":"Ile kosztuje plan?","acceptedAnswer":{"@type":"Answer","text":"Zwykle 3,50–9,90 PLN/dzień — zależnie od masy i formy karmy."}},
  {"@type":"Question","name":"Jaki jest lead time?","acceptedAnswer":{"@type":"Answer","text":"Standardowo 2–3 dni robocze w miastach wojewódzkich."}}
 ]
}
</script>

Webhook odpowiedzi RFQ (JSON – przykład):

{
  "rfq_id": "RFQ-2025-09-1234",
  "quote_at": "2025-09-23T09:30:00Z",
  "items": [
    {"sku":"Plan-Cat-Adult-Mix-M","price_week_pln":79.90,"lead_time_days":2,"recommended_daily_g":180}
  ],
  "sla":"D+2",
  "valid_until":"2025-10-07",
  "attachments":["https://catfood.pl/quotes/RFQ-2025-09-1234.pdf"]
}

11) Najczęstsze „blokera” i szybkie remedia

Brak akcji w danych → Dodaj QuoteAction/OrderAction z prawdziwym EntryPoint POST/JSON.
Parametry nieporównywalne → Ustal słownik i jednostki (kcal/100g, g/dzień, PLN/dzień).
Zamknięte cenniki → Pokaż widełki + czynniki ceny + RFQ.
Brak potwierdzeń → Zawsze zwracaj rfq_id/order_id i wysyłaj e-mail z podsumowaniem.
Brak wideo → Minimum 3 klipy (Q&A/HowTo/Comparison) po 60–120 s.

12) Checklista „Agent-Ready” (do odhaczenia)

Pillar + klastry (Q&A/HowTo/Comparison/Pricing/Case/Service/Compliance).
Short Answer + tabele z ID + wideo 60–120 s (VideoObject).
Product + Offer + PriceSpecification na kartach planów.
QuoteAction (+ OrderAction/RentAction/BookAction) z EntryPoint.
Formularz RFQ (walidacje, zgody, numer sprawy).
CSV/JSON do pobrania (specyfikacje, cenniki, SLA).
Webhooki, idempotencja, rate-limit, log audytu.
KPI i alerty (TtQ, inclusion AIO, CR akcji, lead time accuracy).

CTA

Chcesz, abyśmy przygotowali pełny pakiet Agent-Ready dla CatFood.pl (schema, CSV/JSON, endpointy akcji, konfigurator RFQ, 3 wideo-skrypty i dashboard KPI)? Daj znać — wdrożymy w modelu 30/60/90 z gwarancją mierzalnych rezultatów.

CatFood.pl — wdrożenie „Agent-Ready” pod Buying Agenta (GEO/AEO/AIO)

Short Answer

CatFood.pl przeszło transformację według schematu Informacja → Dane → Akcja → Wymiana → Zgodność → Monitoring, dzięki czemu Buying Agenci (i ludzie) mogą: zrozumieć ofertę, porównać warianty, wycenić subskrypcję, a następnie zamówić plan żywieniowy dla zwierzęcia w jednym przepływie (bot-to-bot lub formularz). Efekt po 90 dniach: TtQ −71%, CR RFQ→Zamówienie +63%, spadek porzuceń formularza o −42%.

1) Kontekst i cel projektu

Branża: D2C pet food (spersonalizowane plany żywieniowe i subskrypcje).
Punkt wyjścia: treści blogowe, rozproszona nawigacja, brak standaryzowanych danych i akcji.
Cele 90 dni:
1. Zasilić Buying Agenty i Answer Engines (GEO/AEO/AIO) danymi i akcjami,
2. Skrócić czas od pytania „jaki plan karmy?” do zamówienia,
3. Zwiększyć współczynnik ukończenia konfiguratora i subskrypcji.

2) Warstwa informacji (GEO/AEO/AIO-ready)

Architektura: hub → klastry → formaty

Pillar: /plany-zywieniowe/ – „Plany żywieniowe dla psów i kotów: jak dobrać i zamówić”
Klastry (przykładowe ścieżki):
- Q&A: /plany-zywieniowe/co-to-jest-plan/, /plany-zywieniowe/kiedy-zmienic-karte/
- HowTo: /plany-zywieniowe/howto/dobor-porcji/, /howto/eliminacja-alergenow/
- Comparison: /plany-zywieniowe/porownanie/sucha-vs-mokra-vs-mix/
- Pricing/ROI: /plany-zywieniowe/cena/, /plany-zywieniowe/kalkulator/
- Case/Proof: /plany-zywieniowe/case/zmniejszenie-otyłości/
- Service/Troubleshooting: /serwis/zwrot-wymiana-smaku/
- Compliance (etykiety, składy): /regulacje/oznaczenia-i-składniki/
- Procurement: /procurement/subskrypcja/ (przebieg zamówienia i zwroty)

Anatomia strony (szablon „od odpowiedzi do akcji”)

Short Answer: 2–3 zdania + 1–2 liczby (np. koszt/dzień), linki do HowTo/Porównanie/Cena.
Tabela parametrów: rasa/waga/aktywność → sugerowana kaloryczność/porcja/cena/dzień.
HowTo: kroki dopasowania planu + wideo 60–120 s.
FAQ: alergie, zmiana smaku, dostawy.
CTA (Tryb Agenta): „Konfiguruj plan” (OrderAction), „Poproś o rekomendację” (QuoteAction).

3) Warstwa danych (schema.org + CSV/JSON)

Dane globalne

Organization + ContactPoint, BreadcrumbList.

Karty produktów/usług

Product (SKU: „Plan-Dog-Adult-Mix-M”), Offer + PriceSpecification (cena/tydzień, koszt/dzień), NutritionInformation w additionalProperty (kaloryczność/100g, białko/tłuszcz).
Service dla konsultacji dietetycznych (BookAction).

Akcje (EntryPoint)

QuoteAction: przyjmowanie parametrów zwierzęcia i preferencji (POST/JSON).
OrderAction: złożenie zamówienia/subskrypcji.
BookAction: konsultacja z dietetykiem (slot kalendarza).
CancelAction / ReturnAction: procedury wymiany smaku/zwrotu (MVP: formularz + e-mail).

CSV/JSON (publiczne, dla agentów)

plans.csv (SKU, nazwa, kalorie/100g, cena/tydzień, lead_time_days, dostępne smaki, przybliżony koszt/dzień dla wag referencyjnych).
allergens.csv (SKU, obecne alergeny, alternatywy).
sla.json (okna dostaw, czasy reakcji supportu).

4) Warstwa akcji (Tryb Agenta) – przykłady

`QuoteAction` (RFQ – skrót JSON-LD)

<script type="application/ld+json">
{
 "@context":"https://schema.org",
 "@type":"QuoteAction",
 "target":{"@type":"EntryPoint","urlTemplate":"https://catfood.pl/api/rfq","httpMethod":"POST","encodingType":"application/json"},
 "result":["RecommendedPlan","EstimatedCost","LeadTime"]
}
</script>

Przykładowy payload RFQ (JSON)

{
  "rfq_id":"auto",
  "pet":{"species":"dog","age_m":"24","weight_kg":18,"activity":"medium","allergies":["chicken"]},
  "preferences":{"dry":true,"wet":true,"mix":true,"max_cost_per_day_pln":8.5},
  "delivery":{"city":"Warszawa","postal_code":"00-001"},
  "contact":{"email":"anna@example.pl","phone":"+48 501 000 000"}
}

`OrderAction` (zamówienie/subskrypcja – skrót JSON-LD)

<script type="application/ld+json">
{
 "@context":"https://schema.org",
 "@type":"OrderAction",
 "target":{"@type":"EntryPoint","urlTemplate":"https://catfood.pl/api/order","httpMethod":"POST","encodingType":"application/json"},
 "expectsAcceptanceOf":{"@type":"Offer","sku":"Plan-Dog-Adult-Mix-M"}
}
</script>

Statusy zamówień: received → need_more_info → accepted → scheduled → fulfilled.

5) Warstwa wymiany (bot-to-bot)

Webhooki & idempotencja

Odpowiedź 202 z rfq_id oraz linkiem do statusu.
Nagłówek Idempotency-Key dla OrderAction.
Retry z backoff (1s/5s/15s).
Ochrona: API-key/mTLS dla zaufanych agentów, rate-limit 60 req/min.

Pliki operacyjne (przykład)

plans.csv

sku,name,price_week_pln,lead_time_days,kcal_100g,protein_pct,fat_pct,forms,allergens
Plan-Dog-Adult-Mix-M,Plan Pies Dorosły MIX M,59.90,2,360,26,14,"dry,wet","beef"
Plan-Dog-Adult-Dry-M,Plan Pies Dorosły DRY M,49.90,2,370,27,12,"dry","chicken"

6) Zgodność, bezpieczeństwo, governance

RODO/consent: cele (rekomendacje żywieniowe, obsługa zamówienia), polityka prywatności, retention.
Śledzenie zmian składu (changelog na kartach planów) + oznaczenia alergenów.
WCAG 2.1 AA: konfigurator i formularze dostępne z klawiatury, alt-teksty.
Audyt decyzji agenta: log wejścia/wyjścia (hash payloadu), możliwość wglądu klienta.

7) Monitoring i KPI

Zdarzenia (telemetria)

short_answer_viewed, table_anchor_clicked, video_play_50/95,
rfq_submitted, rfq_quoted, order_placed, order_scheduled,
błędy api_4xx/5xx, rate_limit_hit.

Wyniki (D+90, przykładowe)

KPI	Przed	Po	Zmiana
Time-to-Quote (TtQ)	3h 25m	59m	−71%
CR: RFQ→Order	9.2%	15.0%	+63%
Porzucenia konfiguratora	38%	22%	−42%
Błędy 4xx/5xx / 1k req	7.1	2.3	−68%
Czas 1. dostawy (P95)	D+4	D+3	−25%
Zwroty „smak”	6.8%	4.9%	−28%

8) 30/60/90 – plan wdrożenia i przebieg

0–30 dni (MVP Informacja + Akcja)

Pillar + 6 stron klastra (Q&A/HowTo/Comparison/Pricing) ze Short Answer, tabelami i 3 wideo 60–120 s.
Organization, BreadcrumbList, FAQPage, HowTo, VideoObject.
RFQ (QuoteAction) + prosty webhook, potwierdzenia z rfq_id.
Publiczne plans.csv (SKU, cena/tydzień, lead time, makro).

31–60 dni (Dane + Zamówienia)

Product+Offer+PriceSpecification na planach, OrderAction (POST/JSON).
BookAction (konsultacje), allergens.csv, sla.json.
Porównania A/B/C (sucha vs mokra vs mix) + kalkulator koszt/dzień.
Dashboard KPI (TtQ, CR, błędy API).

61–90 dni (Skala + partnerstwa)

Idempotencja, rate-limit, mTLS dla wybranych Buying Agentów.
3 case studies (otyłość, alergie, picky eating) z liczbami.
Pętla feedbacku: rzeczywiste NPS/zwroty → automatyczna korekta rekomendacji SKU.
QBR: kwartalny przegląd treści i danych.

9) Wnioski i „playbook” dla innych domen

Pisz od odpowiedzi do akcji: Short Answer + tabela + CTA akcyjne.
Zasilaj agentów danymi: schema.org + CSV/JSON; unikaj PDF-only.
Mierz TtQ i CR akcji – to najczystszy sygnał, czy „Agent-Ready” żyje.
Krótki wideo-layer (60–120 s) znacząco obniża porzucenia.
Idempotencja i statusy = mniej duplikatów i ręcznych interwencji.

10) Fragmenty do ponownego użycia (snippety)

VideoObject (skrót):

<script type="application/ld+json">
{"@context":"https://schema.org","@type":"VideoObject",
 "name":"Jak dobrać plan żywieniowy — 90 s",
 "description":"Hook → szybkie pytania → rekomendacja → CTA",
 "thumbnailUrl":"https://i.ytimg.com/vi/{VIDEOID}/hqdefault.jpg",
 "uploadDate":"2025-09-01",
 "embedUrl":"https://www.youtube.com/embed/{VIDEOID}"}
</script>

FAQPage (skrót):

<script type="application/ld+json">
{"@context":"https://schema.org","@type":"FAQPage","mainEntity":[
 {"@type":"Question","name":"Ile kosztuje plan?","acceptedAnswer":{"@type":"Answer","text":"Zazwyczaj 3,50–9,90 PLN/dzień; zależy od wagi i formy karmy."}},
 {"@type":"Question","name":"Czy mogę zmienić smak w trakcie?","acceptedAnswer":{"@type":"Answer","text":"Tak, w panelu klienta lub przez agenta wsparcia; dostawa D+2."}}
]}
</script>

Product + Offer (skrót):

<script type="application/ld+json">
{"@context":"https://schema.org","@type":"Product",
 "name":"Plan Pies Dorosły MIX M","sku":"Plan-Dog-Adult-Mix-M",
 "brand":{"@type":"Brand","name":"CatFood.pl"},
 "additionalProperty":[
  {"@type":"PropertyValue","name":"Kaloryczność","value":"360 kcal/100g"},
  {"@type":"PropertyValue","name":"Białko","value":"26%"}
 ],
 "offers":{"@type":"Offer","priceCurrency":"PLN","price":"59.90","availability":"https://schema.org/InStock"}
}
</script>

FAQ (skrót)

Czy Buying Agent może zamówić subskrypcję bez konta?
Tak — przyjmujemy OrderAction z danymi dostawy i płatności tokenizowanej; konto tworzymy po potwierdzeniu.

Co w przypadku alergii/specjalnych diet?
W RFQ dopuszczamy listę alergenów i cele (np. „hairball”, „urinary”); agent otrzymuje alternatywy (z allergens.csv).

CTA

Chcesz podobne wdrożenie Agent-Ready (schema, CSV/JSON, akcje, KPI) dla swojej domeny? Przeprowadzimy Cię przez 30/60/90 z gotowymi snippetami i dashboardem TtQ/CR.

Uniwersalny schemat: Jak przygotować stronę pod Buying Agenta (Agent-Ready)

1) Cel i zasady (co agent ma umieć zrobić)

2) Warstwa informacji (GEO/AEO/AIO-ready)

3) Warstwa danych (schema.org + pliki)

4) Warstwa akcji (Tryb Agenta)

5) Formularze (dla ludzi i agentów)

6) Wymiana danych (bot-to-bot)

7) Zgodność, bezpieczeństwo, governance

8) Monitoring i KPI (telemetria Agent-Ready)

9) 30/60/90 — plan wdrożenia

10) Szablony do skopiowania (ready-to-use)

11) Najczęstsze „blokera” i szybkie remedia

12) Checklista „Agent-Ready” (do odhaczenia)

Wejdź do świata AI

Case study

CatFood.pl — wdrożenie „Agent-Ready” pod Buying Agenta (GEO/AEO/AIO)

Short Answer

1) Cel i zasady (co agent ma umieć zrobić)

2) Warstwa informacji (GEO/AEO/AIO-ready)

Architektura treści (pillar → klastry)

Elementy, które agent „kocha”

3) Warstwa danych (schema.org + pliki)

4) Warstwa akcji (Tryb Agenta)

A. RFQ / QuoteAction — punkt wejścia dla zapytań

B. OrderAction / RentAction (subskrypcja) / BookAction

5) Formularze (dla ludzi i agentów)

RFQ — pola obowiązkowe (MVP)

Walidacje i UX

6) Wymiana danych (bot-to-bot)

7) Zgodność, bezpieczeństwo, governance

8) Monitoring i KPI (telemetria Agent-Ready)

9) Plan 30/60/90 — wdrożenie

0–30 dni (MVP Informacja + Akcja)

31–60 dni (Operacjonalizacja danych i procesów)

61–90 dni (Skala i partnerstwa)

10) Szablony do skopiowania (ready-to-use)

11) Najczęstsze „blokera” i szybkie remedia

12) Checklista „Agent-Ready” (do odhaczenia)

CTA

Meta

CatFood.pl — wdrożenie „Agent-Ready” pod Buying Agenta (GEO/AEO/AIO)

Short Answer

1) Kontekst i cel projektu

2) Warstwa informacji (GEO/AEO/AIO-ready)

Architektura: hub → klastry → formaty

Anatomia strony (szablon „od odpowiedzi do akcji”)

3) Warstwa danych (schema.org + CSV/JSON)

Dane globalne

Karty produktów/usług

Akcje (EntryPoint)

CSV/JSON (publiczne, dla agentów)

4) Warstwa akcji (Tryb Agenta) – przykłady

QuoteAction (RFQ – skrót JSON-LD)

OrderAction (zamówienie/subskrypcja – skrót JSON-LD)

5) Warstwa wymiany (bot-to-bot)

Webhooki & idempotencja

Pliki operacyjne (przykład)

6) Zgodność, bezpieczeństwo, governance

7) Monitoring i KPI

Zdarzenia (telemetria)

Wyniki (D+90, przykładowe)

8) 30/60/90 – plan wdrożenia i przebieg

0–30 dni (MVP Informacja + Akcja)

31–60 dni (Dane + Zamówienia)

61–90 dni (Skala + partnerstwa)

9) Wnioski i „playbook” dla innych domen

10) Fragmenty do ponownego użycia (snippety)

FAQ (skrót)

CTA

Meta

A. RFQ / `QuoteAction` — punkt wejścia dla zapytań

B. `OrderAction` / `RentAction` (subskrypcja) / `BookAction`

`QuoteAction` (RFQ – skrót JSON-LD)

`OrderAction` (zamówienie/subskrypcja – skrót JSON-LD)