Stardust 配置

基础信息

• Endpoint: POST https://stardust.ticos.cn/summarize
• Content-Type: application/json

认证方式（二选一）

• Header: Authorization: Bearer <API_KEY>
• Query: terminal_secret=<API_KEY>

请求体

{
  "conversation_history": [
    {
      "role": "user|assistant|system",
      "content": "机器人与用户的实际对话内容",
      "timestamp": "2026-02-25T12:34:56Z"
    }
  ],
  "parameters": {
    "max_length": 512,
    "language": "zh-CN",
    "history_in_conversation": true,
    "summarize_prompt": "请基于 {{latest_memory}} 与 {{conversation}} 更新长期服务记忆。",
    "latest_memory": "机器人服务于社区门店，重点关注老年用户体验"
  }
}

字段说明

• conversation_history（必填）
• role：user / assistant / system
• content：对话文本（支持简单 Markdown）
• timestamp：ISO 8601（可选）
• parameters（可选）
• max_length：最大总结长度（默认 200）
• language：输出语言（默认 zh-CN）
• history_in_conversation：是否返回关键点列表（默认 false）
• summarize_prompt：可自定义总结模板
• latest_memory：传入已有记忆，参与本次总结

成功响应

{
  "summary": "机器人在门店接待中需要强化电梯指引，并持续关注行动缓慢老人。"
}

错误码

• 400：请求体格式错误
• 429：请求频率过高
• 500：服务内部错误

示例请求

curl --location 'https://stardust.ticos.cn/summarize' \
--header 'Authorization: Bearer <API_KEY>' \
--header 'Content-Type: application/json' \
--data '{
  "conversation_history": [
    {
      "role": "user",
      "content": "今天迎宾时有顾客多次询问电梯位置。"
    },
    {
      "role": "assistant",
      "content": "我会在接待流程里优先提示电梯方向。"
    },
    {
      "role": "user",
      "content": "另外有位老人行走较慢，请后续重点关注。"
    }
  ],
  "parameters": {
    "max_length": 256,
    "language": "zh-CN",
    "history_in_conversation": true,
    "latest_memory": "机器人在社区门店负责迎宾和基础问询"
  }
}'

可选查询参数

• agent_id：可作为查询参数附加到 /summarize