Commerce-Flows · AACSearch

Optionale Flow-Runtime-Sitzungen für Studio-Commerce-Journeys (standardmäßig aus).

Commerce-Flows sind eine eigene Zustandsmaschine neben den Projekt-Einkaufsberatern. Definitionen sind Studio-fähige YAML/JSON-Dokumente (kompilierte Techmaps und Custom-Fixtures). Sitzungen halten Ledger und Schrittzeiger. Alle Routen benötigen search:read.

Flows bleiben aus, bis der Index settings.flows.enabled setzt (Console Flows Studio unter /flows oder die zugehörigen oRPC-Einstellungen). Listen und Lesen von Definitionen funktionieren bei ausgeschaltetem Flag; Anlegen oder Fortschreiben einer Sitzung liefert dann 403 FLOW_DISABLED.

Definitionen listen oder lesen:

GET /api/v1/indexes/{slug}/flows
GET /api/v1/indexes/{slug}/flows/{flowId}

Sitzung starten (flow_id, optional client_id, oder Freitext text für Trigger / Default-Flow):

POST /api/v1/indexes/{slug}/flows/sessions
{"client_id":"visitor-42","flow_id":"commerce.simple-product-pick"}

Fortschreiben mit optimistischer Konkurrenz. Senden Sie die letzte data.revision als expected_revision:

POST /api/v1/indexes/{slug}/flows/sessions/{sessionId}/advance
{"expected_revision":1,"answer":{"value":"acme"}}

Ein search-Schritt kann Retrieval-Proof anhängen (Treffer über denselben searchForIndex-Pfad). catalog_match und quote nutzen die Shopping-Guide-Produkt-Helfer, wenn verschachtelter Guide-State vorliegt: pendingActions werden zu resolved oder incomplete, die Antwort kann catalog / quote enthalten. Fehlen Bindings oder die Stage, bleibt needs_guide_session mit endpoint für POST .../guide/sessions/{id}/recommendations bzw. .../quotes (siehe Projekt-Einkaufsberater). Custom-Flows ohne Guide erhalten unsupported — kein stilles No-op.

Der Assistant-Stream startet bei aktivierten Flows einen Commerce-Flow bei Trigger-Treffer (vor defaultFlowId). Techmap-Flows können dieselbe Seed-Session wie Studio öffnen. Übergeben Sie die Session-ID als conversation_id zum Fortsetzen; cancel/отмена oder clarify/уточните senden ein command statt einer Slot-Antwort. Katalog/Quote und Ask-Optionen erscheinen als SSE-ui (product_cards / guide_actions).

Eine veraltete Revision ergibt 409 FLOW_REVISION_CONFLICT. Unbekannter Flow oder Sitzung: 404 FLOW_NOT_FOUND. Unvollständige Antworten: 422 FLOW_INCOMPLETE.

Vollständige Request-/Response-Formen stehen in der generierten OpenAPI-Referenz zu listFlowDefinitions, getFlowDefinition, createFlowSession, getFlowSession, advanceFlowSession.