7 września, 2025
Random News

SalesBot

Inno Ops Agentic Commerce & Answer Engines

Inno Ops: Warstwa Akcji

Inno Ops: Warstwa Akcji. Schema + Order/Reserve/ContactAction — architektura i struktura usługi

Cel i idea przewodnia

Warstwa Akcji zamienia Twoją stronę i ofertę w powierzchnię „klikalną” dla asystentów i botów zakupowych: każde „pokaż i opisz” uzupełniamy o „wykonaj”, tak aby agent mógł natychmiast zamówić, zarezerwować, poprosić o ofertę lub skontaktować się z handlowcem, a wszystko to w sposób jednoznaczny semantycznie (schema.org/potentialAction), technicznie stabilny (prostolinijne API + webhooki) i mierzalny (logi zdarzeń oraz KPI konwersji bot-to-bot).

Architektura rozwiązania

Warstwa 1 — Mapowanie ścieżek „click & …”

  • Click & Buy (retail/e-commerce): od Product/Offer do BuyAction/OrderAction → płatność → potwierdzenie.
  • Click & Collect (retail/lokalne usługi): ReserveAction z wyborem punktu i okna czasowego, status rezerwacji i odbiór.
  • Click & Reserve (travel/booking): ReserveAction na Place/Service z parametrami czasu, liczby osób i wariantów.
  • RFQ (B2B): QuoteAction na Service/Product z parametrami technicznymi i załącznikami → zwrot Quote z warunkami.
  • Contact / Call-Me-Back (B2B/B2C): „szybka komunikacja” jako CommunicateAction (alias „ContactAction”), wywołująca callback lub ticket.

Każdą ścieżkę rozpisujemy na kroki użytkownika, agentów i systemów zaplecza, wskazujemy minimalny zestaw atrybutów oraz punkty walidacji (np. dostępność, cena, SLA odpowiedzi), następnie projektujemy jednolite kontrakty API i webhooków dla całej domeny.

Warstwa 2 — Semantyka schema.org (potentialAction)

Dodajemy do kluczowych bytów jawne potentialAction:

  • Product/Offer/Service/Place/Organization/WebPage → BuyAction / OrderAction / ReserveAction / QuoteAction / CommunicateAction
  • EntryPoint definiuje: urlTemplate, httpMethod, encodingType, contentType, opcjonalnie actionPlatform („https://schema.org/GoogleAssistant”, „https://schema.org/ChatBot”).
  • expectsAcceptanceOf (w Buy/Order) wskazuje Offer, result może wskazać Order/Reservation/Quote.

Przykład (skrót, JSON-LD):

{
  "@context":"https://schema.org",
  "@type":"Product",
  "name":"Zestaw Pro",
  "sku":"PRO-001",
  "offers":{
    "@type":"Offer","price":"129.00","priceCurrency":"PLN","availability":"https://schema.org/InStock"
  },
  "potentialAction":{
    "@type":"BuyAction",
    "target":{
      "@type":"EntryPoint",
      "urlTemplate":"https://example.com/api/v1/orders",
      "httpMethod":"POST",
      "encodingType":"application/json"
    },
    "expectsAcceptanceOf":{"@type":"Offer","sku":"PRO-001"}
  }
}

Rezerwacja (skrót):

{
  "@type":"ReserveAction",
  "target":{"@type":"EntryPoint","urlTemplate":"https://example.com/api/v1/reservations","httpMethod":"POST"},
  "result":{"@type":"Reservation","reservationFor":{"@type":"Service","name":"Wizyta 60 min"}}
}

RFQ (skrót):

{
  "@type":"QuoteAction",
  "target":{"@type":"EntryPoint","urlTemplate":"https://example.com/api/v1/rfq","httpMethod":"POST"},
  "result":{"@type":"Quote"}
}

Warstwa 3 — Proste API akcyjne (idempotentne i przewidywalne)

Minimalne endpointy (OpenAPI w projekcie, tu uogólnienie):

  • POST /api/v1/orders – tworzy zamówienie.
  • POST /api/v1/reservations – rezerwacja slotu/click&collect.
  • POST /api/v1/rfq – zapytanie ofertowe.
  • POST /api/v1/contact – szybki kontakt/oddzwonienie.
  • GET /api/v1/orders/{id} | /reservations/{id} | /rfq/{id} – status.

Zasady:

  • Idempotencja przez nagłówek Idempotency-Key, zwracamy 201/202 z action_id i status.
  • Każde żądanie może podać callback_url (HTTPS) do webhooka; w przeciwnym razie oferujemy stronę potwierdzenia confirmation_url.
  • Odpowiedzi w JSON: id, status (pending|confirmed|needs_action|declined|cancelled), next_step, expires_at, contact.
  • Autoryzacja: klucze API dla partnerów/agentów, X-Agent-Id, podpis HMAC w X-Signature (HMAC-SHA256 nad treścią + timestamp).
  • Ograniczenia: rate limit (np. 300/min), rozmiary payload, walidacja schematów.

Przykład żądania OrderAction (skrót):

{
  "offer": {"sku":"PRO-001","quantity":1},
  "buyer": {"name":"Jan Kowalski","email":"jan@example.com"},
  "fulfillment": {"mode":"delivery","address":"..."},
  "payment": {"method":"card","intent":"authorize"},
  "callback_url":"https://agent.example/llm-webhooks/order"
}

Warstwa 4 — Webhooki zdarzeniowe i Action Router

  • Wysyłamy podpisane webhooki: order.created, order.updated, reservation.confirmed, rfq.received, contact.ack, z polami id, status, timestamp, checksum.
  • Action Router to lekka usługa pośrednicząca: serializuje wejścia z różnych produktów/usług do uniwersalnego modelu, łączy się z ERP/WMS/CRS/CRM, realizuje walidacje (dostępność, SLA) i centralnie loguje zdarzenia; wystawia też tryb sandbox dla testów agentów.

Warstwa 5 — Trust, polityki i zgodność

  • Zgrywamy Warstwę Akcji z /llms.txt + Policy Stack: wskazujemy preferowane EntryPointy, warunki licencji i atrybucji.
  • Dodajemy nagłówki: Link: <.../.well-known/llms-policy.json>; rel="llms-policy", X-LLM-Use: allow, polityki zwrotów i RODO jako CreativeWork w JSON-LD.
  • Rejestrowanie zgód i minimalizacja danych osobowych w payloadach, szyfrowanie w spoczynku i w tranzycie.

Warstwa 6 — Monitoring i telemetria

  • Action Logs: każde żądanie i webhook to event z correlation_id, mierzymy ATA (Agent Time-to-Action), success_rate, drop/retry, API latency, webhook delivery.
  • Zasilamy Inno Console: lejek „od odpowiedzi do akcji”, skuteczność per asystent/źródło, alarmy SLO i anomalii.

Struktura projektu i przebieg wdrożenia

Faza 0 — Kick-off i wybór ścieżek

Wspólnie wybieramy 1–2 priorytetowe ścieżki (np. „rezerwacja wizyty” i „RFQ dla linii X”), definiujemy minimalne atrybuty i polityki, ustalamy właścicieli procesów i cele konwersji.

Faza 1 — Projekt semantyki i kontraktów

Przygotowujemy wzorce JSON-LD (Product/Offer/Service/Place/Organization + potentialAction), projektujemy kontrakty endpointów oraz webhooków (schematy, walidacje, błędy, retry, idempotencja), spisujemy OpenAPI i przykłady.

Faza 2 — Implementacja i integracje

Wdrażamy markup na szablonach, uruchamiamy Action Router i minimalne API, łączymy z ERP/WMS/CRM/płatnościami, dopinamy polityki i nagłówki, wystawiamy sandbox z kluczami testowymi.

Faza 3 — Testy z botami i hardening

Przeprowadzamy testy syntetyczne i realne (asystenci, buying bots), testujemy przepływy błędów (brak dostępności, odrzucona płatność), monitorujemy logi; wprowadzamy limity i zabezpieczenia anty-fraud (velocity, blokady IP/ASN).

Faza 4 — Publikacja i monitoring 90 dni

Uruchamiamy produkcję, publikujemy poradnik deweloperski dla partnerów, ustawiamy alerty SLO i cykl tygodniowych poprawek, co miesiąc raportujemy konwersję i rekomendujemy rozszerzenia na kolejne ścieżki.

Minimalne modele danych (skrót)

Order

{"id":"ord_123","items":[{"sku":"PRO-001","qty":1}],"status":"pending","currency":"PLN","amount":12900,"next_step":"payment_authorize"}

Reservation

{"id":"res_456","service_id":"S-60","start":"2025-09-10T10:00:00Z","status":"confirmed","location_id":"LOC-1"}

RFQ

{"id":"rfq_789","subject":"Pakiet serwisowy X","status":"received","sla_reply_hours":24}

KPI i definicje sukcesu

  • Action Success Rate (odsetek udanych akcji per typ i źródło agenta).
  • ATA — Agent Time-to-Action (ms od odpowiedzi do przyjęcia akcji).
  • Action Coverage (odsetek stron/ofert z poprawnym potentialAction).
  • Webhook Delivery Rate/Latency i API 95p latency.
  • Conversion via Actions (liczba/suma zamówień, rezerwacji, RFQ).
  • Error Budget/SLO (np. 99,9% dostępności warstwy akcji).

Governance i bezpieczeństwo

Macierz RACI: właściciel biznesowy ścieżki, właściciel techniczny API, steward danych; zasady publikacji (PR-review dla JSON-LD i OpenAPI), kontrola dostępu (mTLS/keys), podpisy HMAC, idempotencja, rate limiting, rejestrowanie zgód, polityki retencji, regularny post-incident review.

Pakiety i monetyzacja

  • Wdrożenie per domena/brand: 25–80 tys. USD (analiza ścieżek, markup schema.org, Action Router, API + webhooki, sandbox, testy botowe, monitoring startowy).
  • Utrzymanie: stała opłata lub fee per success 0,05–0,30 USD/akcję (zamówienie/rezerwacja/RFQ/contact z potwierdzeniem), obejmuje SLA, aktualizacje kontraktów i raporty KPI.

Co zyskujesz w praktyce

Twoja marka staje się wykonywalna dla agentów: asystent może nie tylko wyjaśnić ofertę, ale i zrealizować zakup, rezerwację lub zapytanie w jednym kroku, z pełną audytowalnością, bezpieczeństwem i mierzalnością, co natychmiast skraca ścieżkę decyzji klienta i odblokowuje nowy, rosnący kanał przychodu bot-to-bot.

Inno Ops: Wejdź do świata AI

Napisz do nas: kontakt@innoops.pl

 Odwiedź Inno Ops: GEOknows.pl | SalesBot.pl | IntegratorAI.pl | SubProfit.pl

Inno Ops Dla Firm I Organizacji