AI 摘要主动生成
第三方 → Shulex：独立的工单摘要生成能力当第三方需要为指定工单生成摘要时，可主动调用此接口。它独立于 Webhook、AI 回复和标签回调，不会由这些流程自动触发。
调用地址与鉴权
在 Shulex 中创建 Custom Ticket 渠道后，从渠道配置页面复制 Summary 地址；请勿手动拼接 URL。
Shulex 会校验凭证与渠道归属同一账号，且该渠道必须为 Custom Ticket 渠道。请求体不支持覆盖
xToken、channelId 或渠道配置。
说明：targetLanguage为可选字段。推荐传 ISO 语言码，例如en、zh-Hans、ja；未传时使用 AI 根据工单内容和上下文自动识别出的语言，沿用原有行为。传入后，Shulex 先生成 Summary，再调用 GPT 通用翻译接口返回指定语言的最终摘要。
请求格式
可直接传入已整理的文本：请求字段
注意： 建议至少提供content或messages之一。两者均为空时，Shulex 仍会受理请求，但生成的摘要可能不可用。
targetLanguage 完整枚举
以下枚举与 GPT 的BotLanguageEnum 一致。客户可以传 ISO 语言码（推荐），也可以传枚举名或 GPT 展示名；不传参数时使用 AI 自动识别出的语言。
messages[] 字段
内容构造规则
content非空时，Shulex 直接使用它生成摘要。content为空且messages非空时，Shulex 按数组顺序拼接非空消息：
- 空消息会跳过；未提供
role时使用unknown。 - 避免同时传入大量重复的
content与messages，以免摘要输入冗余。
目标语言处理规则
- 未传
targetLanguage或传空白值时，保持历史行为，由 AI 根据工单内容和上下文自动识别输出语言。 - 传入合法目标语言时，Shulex 先调用 GPT 生成原始 Summary，再调用 GPT 通用翻译接口翻译整段 Summary。
targetLanguage推荐使用 ISO 语言码；例如en（英语）、zh-Hans（简体中文）、ja（日语）。也兼容 GPT 语言枚举名或展示名称。- 显式目标语言无法识别或为自动识别选项时，请求会失败，不会静默回退为自动识别。
响应与异步模式
默认同步返回，成功时data.status 为 COMPLETED，summary 即最终结果；指定 targetLanguage 时，summary 为翻译后的结果。
只有渠道配置同时开启“异步摘要”并配置 Summary 回调地址时，接口会立即返回 PENDING；完成后 Shulex 会向已配置的回调地址发送同一份 data 对象，其中包含本次请求的 targetLanguage 和最终 summary。回调地址和鉴权由渠道配置管理，不能通过本次请求指定。
响应字段
同步成功响应
异步受理响应
说明：code="200"且data.status="COMPLETED"表示摘要已生成；当传入targetLanguage时，data.summary已完成翻译；PENDING仅表示异步任务已受理。
常见错误
接入建议
- 始终传递
ticketId，方便将响应或异步回调写回对应工单。 - 优先使用
content，当第三方已完成上下文筛选或脱敏时更可控。 - 使用
messages时，确保数组已按实际对话顺序排序。 - 对异步回调按
taskId幂等处理；当状态为FAILED时记录errorMessage。 - 需要固定输出语言时，显式传递
targetLanguage；不传时保持历史自动识别行为。