核心功能与用法
Brek AI Partner Core Chat Skill 提供了一套完整的酒店预订助手工作流实现，通过 /api/partner/v1/core-chat 端点实现会话管理与事件驱动交互。
会话生命周期管理
采用单用户单会话原则：
- 创建会话：
POST /sessions，需传入稳定的actorId标识终端用户 - 持续交互：
POST /events复用同一会话处理后续消息 - 状态查询：
GET /sessions/{sessionId}获取最新状态
严格禁止跨用户共享会话，确保数据隔离与审计追踪。
关键运行时配置
调用前必须确认四项核心输入：
| 参数 | 说明 |
|------|------|
| `BREK_BASE_URL` | API 基础地址 |
| `BREK_PARTNER_API_KEY` | 合作伙伴认证密钥 |
| `actorId` | 稳定的终端用户唯一标识 |
| `workspaceId` | 多租户环境下的工作空间上下文 |
密钥缺失时的标准处理流程：引导用户联系内部负责人，并发送邮件至 leo@pageonelab.com 申请访问，需包含身份信息、使用场景、预估流量及上线时间。
支付安全架构
采用双层隔离设计：
1. 用户层：通过安全门户完成卡片设置与确认，仅接受 tokenized paymentMethodId
2. 代理层：处理代理间计费与结算
硬性禁止：任何场景下不得请求、传输或存储原始卡号、CVV 或完整 PAN。
反滥用与可靠性机制
- 本地预算控制：执行
references/call-control.md定义的限额 - 幂等性保障：写操作必须附带
idempotencyKey（格式：<partnerId>:<sessionId>:<kind>:<clientActionId>） - 智能重试：尊重
429的retry-after头部，5xx 错误启用指数退避与熔断 - 关键操作保护：预订确认、支付确认等不可逆操作禁止无幂等键重试
响应映射规范
| 字段路径 | 用途 |
|----------|------|
| `data.result.status` | UI 状态机与编排逻辑键 |
| `data.result.message.text` | 用户可见助手回复 |
| `data.result.artifacts` | 结构化数据（候选列表、支付链接、预订元数据）|
错误码处理策略
400：修正请求体后重试401/403：立即停止，启动密钥恢复流程404：检查会话 ID 与租户配置409：会话-用户不匹配，重建会话429：本地节流并按指示重试5xx：退避重试后熔断
显著优点
1. 金融级安全合规：PCI 敏感数据零接触架构，强制 tokenization
2. 高可用设计：完整的熔断、退避、幂等机制应对级联故障
3. 多租户原生：workspace 隔离支持 SaaS 化部署
4. 操作可审计：全程 x-request-id 追踪与速率限制透明化
局限性与风险
1. 冷启动依赖：API 密钥申请需人工审批，无法即时自助开通
2. 幂等键复杂度：开发者需自行维护 clientActionId 的单调性与唯一性
3. 状态同步延迟：GET /sessions 可能存在最终一致性窗口
4. 领域受限：仅覆盖酒店垂直场景，不支持机票、租车等扩展
适合人群
- 已具备 Brek 合作伙伴资质的 OTA、商旅管理平台
- 需要集成酒店预订但不愿承担 PCI DSS 合规成本的中小开发者
- 追求会话状态可观测、故障可熔断的企业级 AI 助手团队
常规风险提示
- 会话泄露可能导致跨用户数据暴露，需严格 actor 绑定校验
action_confirm_payment_card等关键操作需前置显式用户确认，避免代理自主完成交易- 熔断触发后需人工介入检查 Brek 服务状态，不可自动恢复