发送消息 - C300-OpenAPI

向智能体发送消息。

如果空间内未开启 "分段回复"，则当前 api 同步返回智能体回复消息内容。

如果空间内已开启 "分段回复"，则当前 api 返回空，然后通过监听创建消息事件，接口智能体异步回复的消息内容

请求参数

Header 参数

Body 参数application/json

示例

{
    "body": {
        "query": "string",
        "dialogId": "string",
        "userId": "string",
        "files": [
            {
                "name": "string",
                "type": "string",
                "url": "string",
                "size": 0
            }
        ]
    }
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

示例

{
  "code": 200,
  "message": "",
  "data": {
    "entity": {
      "content": "您好，我是管家小助手",
      "dialogId": "434aaef34fae53623asf",
      "agentLogs": [
        {
          // 语言判断
          "type": "language",
          "message": "中文",
          "status": "certain", // agent确定语言
          "timestamp": 1762915391425
        },
        {
          // 记忆唤醒
          "type": "recall",
          "message": "记忆内容：1,2,3",
          "timestamp": 1762915391425
        },
        {
          // 意图 & task 选择
          "type": "task",
          "name": "查询订单",
          "timestamp": 1762915391425
        },
        {
          // 知识库检索
          "type": "knowledge",
          "kb": [
            {
              "chunk_id": "7ae93248fe9",
              "content": "Q:测试公司是做什么的?\nA:测试公司提供面向企业测试服务",
              "created_at": 1763640658,
              "document_id": "dd06afb5-7e33-4953-9247-113879e4653",
              "document_name": "测试知识库.md",
              "enabled": true,
              "lang": "zh",
              "score": 0.7226141428807815,
              "source": "Document"
            }
          ],
          "timestamp": 1762915391425
        },
        {
          //MCP tool调用
          "type": "tool",
          "name": "新建订单",
          "costTime": 5,
          "timestamp": 1762915391425
        },
        {
          //MCP tool调用 - 状态行
          "type": "tool",
          "name": "新建订单",
          "costTime": 5,
          "status": "success", // tool 执行成功
          // "status": "failed", // tool 执行失败
          "timestamp": 1762915391425
        },
        {
          // 内部 tool 调用
          "type": "internalTool",
          "entity": {
            "name": "visitor",
            "values": [
              "小牙仔",
              "13812345678"
            ]
          },
          "timestamp": 1762915391425
        },
        {
          // 特殊 task 执行
          "type": "systemTask",
          "name": "收集信息",
          "message": "记录xx,xx,xx",
          "timestamp": 1762915391425
        }
      ]
    }
  }
}