小K助手-向日葵AI会话（Agent智能体）

// Ask { "input": { "prompt": "你是谁？" }, "stream": true } // Response { "output": { "finish_reason": "stop", "session_id": "e841e6618747466a9f8c0a2df11da94c", "text": "我是..." }, "usage": { // ... } } // Ask { "input": { "prompt": "你会做什么？", "session_id": "e841e6618747466a9f8c0a2df11da94c" }, "stream": true } // Response ...

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Body 参数application/json必填

示例

{
    "input": { // 输入信息
        "prompt": "你是谁？", // 输入当前期望应用执行的指令prompt，用来指导应用生成回复。
        "biz_params": { // 应用通过自定义变量、节点或插件传递参数时，使用该字段进行传递
            "device_info": "设备诊断数据json字符串" // 当回应"need_device_info"时，需要补充设备信息
        },
        "session_id": "1234", // 历史对话的唯一标识，传入session_id时，请求将自动携带云端存储的对话历史。
        "memory_id": "", // 长期记忆体ID。
        "image_list": [ // 图片链接列表。用于传递图片链接。
            "https://xxxx.com/1.png"
        ],
        "file_list": [ // 文件链接列表。用于传递文件链接。
            "https://xxxx.com/2.png"
        ]
    },
    "parameters": {
        "incremental_output": true, // 在流式输出模式下是否开启增量输出（后端默认设置为true）
        "flow_stream_mode": "message_format", // 工作流应用的流式输出模式 message_format (在message字段输出指定节点（流程输出节点或结束节点）的结果), full_thoughts (在thoughts字段流式输出所有节点的结果。使用此模式时，has_thoughts必须设置为True。) (后端默认设置为true）
        "has_thoughts": true // 是否输出插件调用、知识检索的过程，或深度思考模型的思考过程。(后端默认设置为true）
    },
    "stream": true
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功（流式输出-工作流）

text/event-stream

示例输出为调用工作流，并设置参数

 {
    "parameters": {
        "incremental_output": true,
        "flow_stream_mode": "message_format",
        "has_thoughts": true
    }
}

小K助手为工作流性质的Agent，流式输出有两种类型的JSON

// 工作流的流式输出片段
{
  "output": {
    "session_id": "da8cd583e3e343cb99d53ef11708d899",
    "workflow_message": {
      "node_status": "executing",
      "node_type": "End",
      "node_msg_seq_id": 1,
      "node_name": "结束",
      "message": {
        "content": "开启超级桌面的方法如下：\n\n1. 打",
        "role": "assistant"
      },
      "node_is_completed": false,
      "node_id": "End_1Siz"
    },
    "finish_reason": "null"
  },
  "usage": {},
  "request_id": "2798d65e-f0a6-46c6-b503-ab01891f13a4"
}

// 输出完成后的汇总
{
  "output": {
    "session_id": "da8cd583e3e343cb99d53ef11708d899",
    "finish_reason": "stop",
    "text": "开启超级桌面的方法如下：\n\n1. 打开向日葵客户端，在设备列表中找到想要连接的电脑。\n2. 点击你想要打开的应用，连接成功后，远端的应用就会显示在你的本机上。\n   - 如果找不到应用，可以点击“…”打开应用列表（目前仅显示桌面快捷方式）。\n3. 连接成功后即可进入超级桌面使用。\n\n如需退出超级桌面，可在本机任务栏右键向日葵图标，选择【退出超级桌面】即可。"
  },
  "usage": {
    "models": [
      {
        "input_tokens": 527,
        "output_tokens": 8,
        "model_id": "qwen-max-latest"
      },
      {
        "input_tokens": 709,
        "output_tokens": 111,
        "model_id": "qwen-plus-latest"
      }
    ]
  },
  "request_id": "2798d65e-f0a6-46c6-b503-ab01891f13a4"
}

Body

示例

data:{"output":{"session_id":"ccfaf6a10f1c4f2480a915d4b5136e44","workflow_message":{"node_status":"executing","node_type":"End","node_msg_seq_id":1,"node_name":"结束","message":{"content":"开启超级桌面的方法如下：\n\n1. 打","role":"assistant"},"node_is_completed":false,"node_id":"End_1Siz"},"finish_reason":"null"},"usage":{},"request_id":"37d8cb5a-a342-45f9-ae40-071c981d0dbb"}

data:{"output":{"session_id":"ccfaf6a10f1c4f2480a915d4b5136e44","workflow_message":{"node_status":"executing","node_type":"End","node_msg_seq_id":2,"node_name":"结束","message":{"content":"开向日葵客户端，在设备列表中找到想要连接的电脑。\n2. 点击你","role":"assistant"},"node_is_completed":false,"node_id":"End_1Siz"},"finish_reason":"null"},"usage":{},"request_id":"37d8cb5a-a342-45f9-ae40-071c981d0dbb"}

data:{"output":{"session_id":"ccfaf6a10f1c4f2480a915d4b5136e44","workflow_message":{"node_status":"executing","node_type":"End","node_msg_seq_id":3,"node_name":"结束","message":{"content":"想要打开的应用，连接","role":"assistant"},"node_is_completed":false,"node_id":"End_1Siz"},"finish_reason":"null"},"usage":{},"request_id":"37d8cb5a-a342-45f9-ae40-071c981d0dbb"}

data:{"output":{"session_id":"ccfaf6a10f1c4f2480a915d4b5136e44","workflow_message":{"node_status":"executing","node_type":"End","node_msg_seq_id":4,"node_name":"结束","message":{"content":"成功后，远端的应用就会显示在你的本机上。\n   - 如果找不到应用，可以","role":"assistant"},"node_is_completed":false,"node_id":"End_1Siz"},"finish_reason":"null"},"usage":{},"request_id":"37d8cb5a-a342-45f9-ae40-071c981d0dbb"}

data:{"output":{"session_id":"ccfaf6a10f1c4f2480a915d4b5136e44","workflow_message":{"node_status":"executing","node_type":"End","node_msg_seq_id":5,"node_name":"结束","message":{"content":"点击“…”打开应用列表","role":"assistant"},"node_is_completed":false,"node_id":"End_1Siz"},"finish_reason":"null"},"usage":{},"request_id":"37d8cb5a-a342-45f9-ae40-071c981d0dbb"}

data:{"output":{"session_id":"ccfaf6a10f1c4f2480a915d4b5136e44","workflow_message":{"node_status":"executing","node_type":"End","node_msg_seq_id":6,"node_name":"结束","message":{"content":"（目前仅显示桌面快捷方式）。\n3. 连接后即可进入超级桌面使用","role":"assistant"},"node_is_completed":false,"node_id":"End_1Siz"},"finish_reason":"null"},"usage":{},"request_id":"37d8cb5a-a342-45f9-ae40-071c981d0dbb"}

data:{"output":{"session_id":"ccfaf6a10f1c4f2480a915d4b5136e44","workflow_message":{"node_status":"executing","node_type":"End","node_msg_seq_id":7,"node_name":"结束","message":{"content":"远程应用。\n\n如","role":"assistant"},"node_is_completed":false,"node_id":"End_1Siz"},"finish_reason":"null"},"usage":{},"request_id":"37d8cb5a-a342-45f9-ae40-071c981d0dbb"}

data:{"output":{"session_id":"ccfaf6a10f1c4f2480a915d4b5136e44","workflow_message":{"node_status":"executing","node_type":"End","node_msg_seq_id":8,"node_name":"结束","message":{"content":"需退出超级桌面，可在本机任务栏右键向日葵图标，选择【退出超级","role":"assistant"},"node_is_completed":false,"node_id":"End_1Siz"},"finish_reason":"null"},"usage":{},"request_id":"37d8cb5a-a342-45f9-ae40-071c981d0dbb"}

data:{"output":{"session_id":"ccfaf6a10f1c4f2480a915d4b5136e44","workflow_message":{"node_status":"executing","node_type":"End","node_msg_seq_id":9,"node_name":"结束","message":{"content":"桌面】即可。","role":"assistant"},"node_is_completed":false,"node_id":"End_1Siz"},"finish_reason":"null"},"usage":{},"request_id":"37d8cb5a-a342-45f9-ae40-071c981d0dbb"}

data:{"output":{"session_id":"ccfaf6a10f1c4f2480a915d4b5136e44","workflow_message":{"node_status":"success","node_type":"End","node_msg_seq_id":10,"node_name":"结束","message":{"content":"","role":"assistant"},"node_is_completed":true,"node_id":"End_1Siz"},"finish_reason":"null"},"usage":{},"request_id":"37d8cb5a-a342-45f9-ae40-071c981d0dbb"}

data:{"output":{"session_id":"ccfaf6a10f1c4f2480a915d4b5136e44","finish_reason":"stop","text":"开启超级桌面的方法如下：\n\n1. 打开向日葵客户端，在设备列表中找到想要连接的电脑。\n2. 点击你想要打开的应用，连接成功后，远端的应用就会显示在你的本机上。\n   - 如果找不到应用，可以点击“…”打开应用列表（目前仅显示桌面快捷方式）。\n3. 连接后即可进入超级桌面使用远程应用。\n\n如需退出超级桌面，可在本机任务栏右键向日葵图标，选择【退出超级桌面】即可。"},"usage":{"models":[{"input_tokens":527,"output_tokens":8,"model_id":"qwen-max-latest"},{"input_tokens":709,"output_tokens":112,"model_id":"qwen-plus-latest"}]},"request_id":"37d8cb5a-a342-45f9-ae40-071c981d0dbb"}

🟢200成功（非流式输出）

小K助手-向日葵AI会话（Agent智能体）

参考资料

如何实现多轮会话

请求参数

请求示例代码

返回响应

小K助手-向日葵AI会话（Agent智能体）

参考资料#

如何实现多轮会话#

请求参数

请求示例代码

返回响应

参考资料

如何实现多轮会话