联犀开发者文档

客户端工具执行与回传：完整报文

约 770 字大约 3 分钟

2026-10-16

本页是场景流程的完整 JSON 序列，按图中编号查阅。示例中的分支互斥，不能顺序重放全部报文；实际 ID、截止、SDP、地址和密钥须由运行时取得。实施状态及字段定义仍以场景与命令页为准。

补充示例 1

回到原场景位置。

{
  "msgToken": "s22-cap",
  "method": "capabilityReport",
  "params": {
    "revision": 1,
    "purposes": [
      "aiConversation"
    ],
    "transports": [
      "none"
    ],
    "features": [],
    "inputModalities": [
      "text"
    ],
    "outputModalities": [
      "text"
    ],
    "frontendTools": [
      {
        "name": "set_local_display_theme",
        "interactionType": "action",
        "schemaRevision": 1
      }
    ]
  }
}

补充示例 2

回到原场景位置。

{
  "msgToken": "s22-create",
  "method": "sessionCreate",
  "params": {
    "purpose": "aiConversation",
    "transport": "none",
    "tracks": [],
    "inputModalities": [
      "text"
    ],
    "outputModalities": [
      "text"
    ],
    "frontendTools": [
      {
        "name": "set_local_display_theme",
        "interactionType": "action",
        "schemaRevision": 1
      }
    ]
  }
}

编号报文

M01 · toolCallExecute

{
  "msgToken": "s22-1",
  "method": "toolCallExecute",
  "sessionId": "s22-session",
  "messageSeq": 1,
  "data": {
    "respId": "reply-1",
    "toolCallId": "tool-1",
    "name": "set_local_display_theme",
    "arguments": {
      "theme": "dark"
    },
    "isFrontend": true,
    "interactionType": "action",
    "executionToken": "<scoped-single-call-token>",
    "expiresAt": 1900000000000
  }
}

M02 · toolCallSubmit

{
  "msgToken": "s22-2",
  "method": "toolCallSubmit",
  "sessionId": "s22-session",
  "params": {
    "respId": "reply-1",
    "toolCallId": "tool-1",
    "executionToken": "<scoped-single-call-token>",
    "status": "succeeded",
    "result": {
      "theme": "dark"
    }
  }
}

M03 · requestAck

{
  "msgToken": "s22-2",
  "method": "requestAck",
  "sessionId": "s22-session",
  "code": 200,
  "data": {
    "requestMethod": "toolCallSubmit",
    "result": {
      "respId": "reply-1",
      "toolCallId": "tool-1",
      "state": "accepted",
      "continuation": "accepted"
    }
  }
}

M04 · respTextDone

{
  "msgToken": "s22-4",
  "method": "respTextDone",
  "sessionId": "s22-session",
  "messageSeq": 2,
  "data": {
    "respId": "reply-1",
    "contentIndex": 0,
    "text": "已收到你的确认。"
  }
}

M05 · respDone

{
  "msgToken": "s22-5",
  "method": "respDone",
  "sessionId": "s22-session",
  "messageSeq": 3,
  "data": {
    "respId": "reply-1",
    "inputId": "input-1",
    "status": "completed",
    "contentCount": 1,
    "audioState": "none"
  }
}

M06 · respCancel

{
  "msgToken": "s22-6",
  "method": "respCancel",
  "sessionId": "s22-session",
  "params": {
    "respId": "reply-1"
  }
}

M07 · requestAck

{
  "msgToken": "s22-6",
  "method": "requestAck",
  "sessionId": "s22-session",
  "code": 200,
  "data": {
    "requestMethod": "respCancel",
    "result": {
      "respId": "reply-1",
      "state": "cancelled"
    }
  }
}

M08 · respDone

{
  "msgToken": "s22-8",
  "method": "respDone",
  "sessionId": "s22-session",
  "messageSeq": 4,
  "data": {
    "respId": "reply-1",
    "inputId": "input-1",
    "status": "cancelled",
    "reason": "userCancelled",
    "contentCount": 0,
    "audioState": "none"
  }
}

M09 · requestAck

{
  "msgToken": "s22-2",
  "method": "requestAck",
  "sessionId": "s22-session",
  "code": 409,
  "data": {
    "requestMethod": "toolCallSubmit",
    "reason": "toolCallExpired"
  }
}

M10 · respDone

{
  "msgToken": "s22-10",
  "method": "respDone",
  "sessionId": "s22-session",
  "messageSeq": 5,
  "data": {
    "respId": "reply-1",
    "inputId": "input-1",
    "status": "failed",
    "reason": "toolTimeout",
    "contentCount": 0,
    "audioState": "none"
  }
}

M11 · interaction.message

{
  "msgToken": "s22-11",
  "method": "interaction.message",
  "sessionId": "s22-session",
  "messageSeq": 6,
  "data": {
    "command": "toolCallExecute",
    "result": {
      "respId": "app-reply",
      "toolCallId": "app-tool",
      "name": "set_local_display_theme",
      "arguments": {
        "theme": "dark"
      },
      "isFrontend": true,
      "interactionType": "action",
      "executionToken": "<app-endpoint-token>",
      "expiresAt": 1900000000000
    }
  }
}

M12 · interaction.control

{
  "msgToken": "s22-12",
  "method": "interaction.control",
  "sessionId": "s22-session",
  "params": {
    "command": "toolCallSubmit",
    "arguments": {
      "respId": "app-reply",
      "toolCallId": "app-tool",
      "executionToken": "<app-endpoint-token>",
      "status": "succeeded",
      "result": {
        "theme": "dark"
      }
    }
  }
}

M13 · interaction.result

{
  "msgToken": "s22-12",
  "method": "interaction.result",
  "sessionId": "s22-session",
  "code": 200,
  "data": {
    "operation": "interaction.control",
    "state": "accepted",
    "result": {
      "respId": "app-reply",
      "toolCallId": "app-tool",
      "state": "accepted",
      "continuation": "accepted"
    }
  }
}

更新日志

2026/10/17 03:27
查看所有更新日志
  • d04e1-docs(AI与音视频): 按公共主线与场景分支整合接入手册于