核心用法
Brek AI Partner Core Chat 是面向 B2B 合作伙伴的企业级酒店搜索与预订智能体技能，通过 /api/partner/v1/core-chat 端点实现会话生命周期管理。其核心执行顺序为：首次创建会话（POST /sessions）→ 持续发送用户事件（POST /events）→ 按需读取状态（GET /sessions/{sessionId}）。技能强制要求稳定的 actorId 进行用户隔离，禁止跨用户复用会话，确保数据边界清晰。
显著优点
1. 企业级安全架构：内置多层防护——API 密钥强制校验、幂等性键生成（<partnerId>:<sessionId>:<kind>:<clientActionId>）、速率限制响应（429 重试）、熔断器机制，有效防御重放攻击与级联故障。
2. 支付合规设计：严格遵循 PCI-DSS 原则，禁止采集原始卡号/CVV/完整 PAN，仅接受令牌化的 paymentMethodId，用户需在安全门户完成卡设置，代理侧仅处理确认流程。
3. 多租户就绪：原生支持 partnerId + workspaceId 的租户上下文，便于 SaaS 平台按客户组织计费与隔离数据。
4. 结构化响应映射：响应数据清晰映射为状态机键、用户可见文本及结构化产物（短名单、支付 URL、预订元数据），便于前端 UI 驱动与编排层集成。
潜在缺点与局限性
- 配置门槛较高：需预置 6 项运行时输入（BASE_URL、API_KEY、actorId、workspaceId、partnerId、clientActionId），对快速原型开发不够友好。
- 错误处理复杂度高：需区分 400/401/403/404/409/429/5xx 等多类错误码，并实施不同的重试或熔断策略，集成工作量较大。
- 幂等性键依赖运行时上下文：若
partnerId缺失需回退到workspaceId，可能因租户配置不一致导致键冲突。 - 无内置对话记忆抽象：需开发者自行管理会话状态与历史，非开箱即用的对话体验。
适合人群
- B2B SaaS 平台：需在自有产品中嵌入酒店预订能力的 OTA、企业差旅管理（T&E）平台或费控系统。
- 具备 API 集成经验的技术团队：熟悉 OAuth、幂等性设计、熔断器模式的工程团队。
- 高合规要求场景：金融、医疗、跨国企业等需满足 PCI-DSS 及数据驻留要求的客户。
常规风险
- 密钥泄露风险：
BREK_PARTNER_API_KEY为高敏感度凭证，需通过内部审批渠道配置，禁止在聊天界面或日志中暴露。 - 幂等性键冲突：若
partnerId与workspaceId混用或格式不统一，可能导致重复预订或资金损失。 - 熔断器误触发：不合理的超时阈值或重试策略可能导致正常服务被误判为故障，影响用户体验。
- 支付确认流程绕过：若前端未严格执行用户显式确认步骤，存在合规与纠纷风险。