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などお使いのコーディングエージェントにプロンプトを貼り付けてください。