brek-ai
leo9 제작
Search & Research요약
Integrate with Brek Partner Core Chat API for hotel-search and booking assistant flows.
설명
이 스킬이 하는 일
Connects to the Brek Partner Core Chat API to run hotel-search and booking assistant flows. Manages session lifecycle per end user, routes typed events with idempotency keys, enforces anti-abuse call controls, and handles payment confirmation without touching raw card data.
Bundles idempotency enforcement, rate-limit backoff, circuit breaking, and PCI-safe payment routing into one skill, so you don't build those guardrails from scratch against the Brek API.
사용 시점
- Starting a hotel-search session for a new traveler
- Sending a booking event with a deterministic idempotency key to avoid duplicate reservations
- Redirecting a user to a provider-hosted payment portal instead of collecting card details in chat
- Cancelling an existing booking through the agent API
- Throttling retries and opening a circuit breaker after repeated 5xx failures from Brek
예시 워크플로
User asks: Find me a hotel in Paris for March 20-22 and book the cheapest option
- 1
POST /sessions with stable actorId to create a new Brek chat session
- 2
POST /events with a hotel-search query; read data.result.artifacts for the shortlist
- 3
Present shortlist to user and collect their chosen option ID
- 4
POST /events with kind=command_book_by_option_id and idempotencyKey=<partnerId>:<sessionId>:<kind>:<clientActionId>
- 5
Return payment setup URL from artifacts; await tokenized paymentMethodId before sending action_confirm_payment_card
Booking confirmation object with reservation metadata returned in data.result.artifacts
요구 사항
- BREK_BASE_URL environment variable
- BREK_PARTNER_API_KEY (obtain from your internal Brek account owner or approved support channel)
설치
clawhub install leo9/brek-aiCLI 명령을 실행하거나, 프롬프트를 Claude Code, Cursor, Codex 등 사용하는 코딩 에이전트에 붙여넣으세요.