ChatBot 智能体V3(socket)
开发中
POST
https://api.mindcraft.com.cn
流程图示意#
链接socket + 认证#
建立websocket链接
ApiKey认证
DeviceToken认证
智能体 chat_bot_v3#
初始创建
停止语音上传
终止流体返回数据
socket 返回示例说明#
情感输出示例
{
"socket_type": "agent_event",
"socket_message": "request_completed",
"socket_status": 1003,
"event_name": "agent_action",
"agent_output": {
"output_type": "emotion",
"emotion_output": "happy"
},
"agent_name": "chat_bot_v3"
}chat_bot_v3完成了一次请求，事件为agent_action，输出类型为情感，识别到的情感为“happy”。LLM输出示例
TTS输出示例
智能体停止示例
请求参数
Header 参数
Body 参数application/json
示例
{
"agent_name": "chat_bot_v3",
"mode": "customize",
"profile_uuid": "mc20250327a58srl",
"character_uuid": "mc20250326a54kf",
"tts_model": "MM_TTSL_realtime_speech-01-turbo",
"speed": 0,
"max_tokens": 100,
"emotion_output": true,
"session_token": "0886a1f1-cd25-445a-9f3a-767032da9b84",
"upload_format": "pcm",
"upload_sample_rate": 16000,
"language": "auto"
}示例代码
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": "chat_bot_v3",
"mode": "customize",
"profile_uuid": "mc20250327a58srl",
"character_uuid": "mc20250326a54kf",
"tts_model": "MM_TTSL_realtime_speech-01-turbo",
"speed": 0,
"max_tokens": 100,
"emotion_output": true,
"session_token": "0886a1f1-cd25-445a-9f3a-767032da9b84",
"upload_format": "pcm",
"upload_sample_rate": 16000,
"language": "auto"
}'返回响应
🟢200对话聊天数据
text/plain
Body
示例
{"socket_type": "agent_event", "socket_message": "request_completed", "socket_status": 1003, "event_name": "agent_action", "agent_output": {"output_type": "emotion", "emotion_output": "happy"}, "agent_name": "chat_bot_v3"}
{"socket_type": "agent_event", "socket_message": "request_completed", "socket_status": 1003, "event_name": "agent_action", "agent_output": {"output_type": "llm", "asr_content": "你好啊", "llm_response": "林小宅你好呀！", "z_index": 0}, "agent_name": "chat_bot_v3"}
{"socket_type": "agent_event", "socket_message": "request_completed", "socket_status": 1003, "event_name": "agent_action", "agent_output": {"output_type": "llm", "asr_content": "你好啊", "llm_response": "(*^▽^*) 今天过得怎么样呢？", "z_index": 1}, "agent_name": "chat_bot_v3"}
{"socket_type": "agent_event", "socket_message": "request_completed", "socket_status": 1003, "event_name": "agent_action", "agent_output": {"output_type": "llm", "asr_content": "你好啊", "llm_response": "我刚刚发现了一部超好看的热血动漫，想不想知道是哪一部？", "z_index": 2}, "agent_name": "chat_bot_v3"}
{"socket_type": "agent_event", "socket_message": "request_completed", "socket_status": 1003, "event_name": "agent_action", "agent_output": {"output_type": "tts", "audio_seconds": 1.26, "tts_audio": "https://api.mindcraft.com.cn/v1/data/get_stream_tts/4a312ef1f4b7422bb6e88ba034132c0c.mp3", "z_index": 0}, "agent_name": "chat_bot_v3"}
{"socket_type": "agent_event", "socket_message": "request_completed", "socket_status": 1003, "event_name": "agent_action", "agent_output": {"output_type": "tts", "audio_seconds": 2.13, "tts_audio": "https://api.mindcraft.com.cn/static/agent/4a312ef1f4b7422bb6e88ba034132c0c/2.mp3", "z_index": 1}, "agent_name": "chat_bot_v3"}
{"socket_type": "agent_event", "socket_message": "request_completed", "socket_status": 1003, "event_name": "agent_action", "agent_output": {"output_type": "tts", "audio_seconds": 4.47, "tts_audio": "https://api.mindcraft.com.cn/static/agent/4a312ef1f4b7422bb6e88ba034132c0c/3.mp3", "z_index": 2}, "agent_name": "chat_bot_v3"}
{"socket_type": "agent_event", "socket_message": "agent_stop", "socket_status": 1006, "event_name": "agent_action", "agent_name": "chat_bot_v3"}
修改于 2025-07-07 05:57:43