AI桌面助手V1(Socket)
开发中
POST
https://api.mindcraft.com.cn
流程图示意#
链接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 创建新对话
示例值:
cebc7012-6d12-44b2-84c3-60bd7de5001d
upload_format
enum<string>
语音识别格式
枚举值:
pcmwavopusspeexaacamr
默认值:
pcm
示例值:
pcm
upload_sample_rate
enum<integer>
语音识别采样率
枚举值:
800016000
默认值:
16000
language
enum<string>
设置语种
枚举值:
autozhenjayueko
默认值:
中文
示例值:
english中文
character_uuid
string
角色uuid
profile_data
object
角色数据
profile_uuid
string
档案uuid
emotion_output
boolean
情绪识别
示例
{
"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"
}示例代码
Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api.mindcraft.com.cn' \
--header 'Authorization: Bearer ' \
--header 'Content-Type: application/json' \
--data-raw '{
"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"
}'返回响应
🟢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系统设置
修改于 2025-05-22 08:05:40