AI桌面助手V1(Socket)

流程图示意

链接socket + 认证

建立websocket链接

ApiKey认证

DeviceToken认证

智能体 desktop_assistant_v1

初始创建

停止语音上传

终止流体返回数据

socket 返回示例说明

聊天场景

场景通知

聊天场景-情绪识别

聊天场景-音频数据

聊天场景-文字聊天

通用场景-结束对话

    {
        "socket_status": 1007,
        "socket_message": "agent_event",
        "socket_type": "agent_event",
        "event_name": "agent_action",
        "socket_data": {
            "agent_type": "text",
            "agent_name": "desktop_assistant_v1"
        }
    }

此次事件为 agent_action ，没有 agent_output 表示场景通知，输出类型为 text，表示接下来会进行文本对话交流。

询问天气

闹钟数据

倒计时

系统设置

请求参数

Header 参数

Authorization

string

必需

示例值:

Bearer {{api_key}}

Body 参数application/json

agent_name

enum<string>

调用智能体名称

必需

枚举值:

desktop_assistant_v1

默认值:

desktop_assistant_v1

示例值:

desktop_assistant_v1

map_name

enum<string>

可选

场景位置不传默认场景

枚举值:

textcheck_weatherset_alarmset_countdownmodify_device_config

session_token

string

必需

使用session 记录聊天记录，下方接口获取session_token
session 获取对话列表
session 创建新对话

示例值:

cebc7012-6d12-44b2-84c3-60bd7de5001d

upload_format

enum<string>

语音识别格式

可选

枚举值:

pcmwavopusspeexaacamr

默认值:

pcm

示例值:

pcm

upload_sample_rate

enum<integer>

语音识别采样率

可选

枚举值:

800016000

默认值:

16000

language

enum<string>

设置语种

可选

枚举值:

autozhenjayuekofrderues

默认值:

中文

示例值:

english中文

character_uuid

string

角色uuid

可选

profile_data

object

角色数据

可选

profile_uuid

string

档案uuid

可选

emotion_output

boolean

情绪识别

可选

agent_function

object

智能体功能

可选

status

enum<string>

智能体功能状态

可选

枚举值:

onoffpartial

默认值:

enabled_function

array[string]

可选

启动功能(启动，禁止二选一)

枚举值:

chatweb_searchcheck_weatherset_alarmset_countdownmodify_device_config

disabled_function

array[string]

可选

禁用功能(启动，禁止二选一)

枚举值:

chatweb_searchcheck_weatherset_alarmset_countdownmodify_device_config

llm_model

enum<string>

chat聊天模型

可选

枚举值:

abab6.5s-chatDoubao-1.5-lite-32kGLM-4-Airdeepseek-v3

tts_model

enum<string>

音频合成模型

可选

枚举值:

MM_TTSL_realtime_speech-01-turboMM_TTSL_realtime_speech-02-turbo

示例

{
    "agent_name": "desktop_assistant_v1",
    "map_name": "modify_device_config",
    "session_token": "cebc7012-6d12-44b2-84c3-60bd7de5001d",
    "upload_format": "pcm",
    "upload_sample_rate": 16000,
    "language": "zh",
    "character_uuid": "mc20250326a54kf",
    "emotion_output": true,
    "profile_data": {"name":"小明","age":16,"gender":"未指定","profession":"学生","hobbies":["看书"]},
    "profile_uuid": "mc20250327a58srl",
    "agent_function": {
        "status": "partial",
        "enabled_function": [],
        "disabled_function": [
            "web_search"
        ]
    },
    "llm_model": "abab6.5s-chat",
    "tts_model": "MM_TTSL_realtime_speech-01-turbo"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200对话数据

text/plain

Body

object {0}

示例

{"socket_status": 1007, "socket_message": "agent_event", "socket_type": "agent_event", "event_name": "agent_action", "socket_data": {"agent_type": "text", "agent_name": "desktop_assistant_v1"}}

{"socket_status": 1007, "socket_message": "agent_event", "socket_type": "agent_event", "event_name": "agent_action", "socket_data": {"agent_type": "text", "agent_output": {"user_input": "你好啊", "llm_response": "", "tts_audio": "http://192.168.1.10/v1/data/redis_stream_tts/c029db0b180d4791ab69c61f9ece036a.mp3", "emotion_output": "happy"}, "agent_name": "desktop_assistant_v1"}}

{"socket_status": 1007, "socket_message": "agent_event", "socket_type": "agent_event", "event_name": "agent_action", "socket_data": {"agent_type": "text", "agent_output": {"user_input": "你好啊", "llm_response": "哈喽哈喽😎 小明同学，今天找我有啥好玩的事儿呀🧐 是想跟我分享趣事，还是有啥问题要我帮忙解答呀🤗 不管啥事儿，咱都能唠得超开心😜", "tts_audio": "http://192.168.1.10/v1/data/redis_stream_tts/c029db0b180d4791ab69c61f9ece036a.mp3", "emotion_output": "happy"}, "agent_name": "desktop_assistant_v1"}}

...


{"socket_status": 1006, "socket_message": "agent_stop", "socket_type": "agent_event", "event_name": "agent_action", "socket_data": {"agent_name": "desktop_assistant_v1"}}

🟢200获取天气

🟢200闹钟数据

🟢200倒计时

🟢200系统设置

AI桌面助手V1(Socket)

流程图示意#

链接socket + 认证#

智能体 desktop_assistant_v1#

socket 返回示例说明#

请求参数

示例代码

返回响应

流程图示意

链接socket + 认证

智能体 desktop_assistant_v1

socket 返回示例说明