ChatBot 智能体V3(socket)

流程图示意

链接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输出示例

智能体停止示例

提示

示例JS文件下载

请求参数

Header 参数

Authorization

string

必需

示例值:

Bearer {{api_key}}

Body 参数application/json

agent_name

enum<string>

调用智能体名称

必需

枚举值:

chat_bot_v3

默认值:

chat_bot_v3

示例值:

chat_bot_v3

mode

enum<string>

必需

选择智能体模式，自动选择好llm, tts,和asr参数。

pro为专家模式，默认选择此模式，效果更好支持AI角色和用户设定ID导入。

standard为标准模式，成本较低，采用高性价比的语音识别和语音合成模型，音色效果良好。

customize为自定义模式，用户自己选择llm, tts和asr模型。

只有在customize模式下，llm_model, tts_model,asr_model, max_token参数才可以自己设置。

枚举值:

prostandardcustomize

默认值:

pro

character_uuid

string

可选

AI角色ID，详细在智匠角色广场里查看

示例值:

mc20250326a54kf

profile_uuid

string

可选

用户人设ID，详细在智匠角色广场里查看

示例值:

mc20250327a58srl

emotion_output

boolean

是否启动识别情绪

可选

upload_format

enum<string>

语音识别格式

可选

枚举值:

pcmwavopusspeexaacamr

默认值:

pcm

示例值:

pcm

upload_sample_rate

enum<integer>

语音识别采样率

可选

枚举值:

800016000

默认值:

16000

voice_id

string

必需

pro模式下选择MiniMax音色，standard模式下选择腾讯音色，customize模式下根据选择的tts_model选择音色。
若是调用character_uuid则此字段无效，自动选择character_uuid中的音色
机器人的语音音色。对应的音色请参考TTS 音色列表示例值：female-tianmei 默认值：female-tianmei

示例值:

cute_boy

speed

number

可选

TTS 语音合成语速控制

默认值:

示例值:

user_name

string

可选

机器人对话用户名称，仅在未输入profile_uuid时有效，profile_uuid优先级更高

默认值:

user_name

示例值:

小明

user_age

integer

用户年龄设置

可选

默认值:

示例值:

bot_name

string

可选

机器人姓名设置，仅在未输入character_uuid时有效，character_uuid优先级更高

默认值:

智酱

示例值:

智酱

bot_character_description

string

可选

机器人角色设置，仅在未输入character_uuid时有效，character_uuid优先级更高

示例值:

智酱是一个彩色史莱姆生物。这是一个搞笑的魔法生物，充满活力，喜欢探索新事物，喜欢帮助小朋友学习。

bot_personality

string

可选

机器人性格设置，仅在未输入character_uuid时有效，character_uuid优先级更高

默认值:

活泼,好奇,乐观,善良

示例值:

活泼,好奇,乐观,善良

bot_tone

string

可选

机器人回复风格设定，仅在未输入character_uuid时有效，character_uuid优先级更高

示例值:

用拟人和口语化的方式回答用户，说话习惯附带emoji表情。

llm_model

enum<string>

LLM 大语言模型

可选

枚举值:

GLM-4-AirDoubao-1.5-lite-32kabab6.5s-chat

默认值:

abab6.5s-chat

示例值:

abab6.5s-chat

max_tokens

integer

可选

LLM 大语言模型调用时的max_tokens，standard/pro模式最大为100，customize模式下可随意修改

>= 20<= 8000

默认值:

100

示例值:

100

tts_model

enum<string>

可选

TTS 语音合成模型，pro模式下默认为MM_TTSL_realtime_speech-01-turbo，standard模式下TX_TTSP_realtime

枚举值:

TX_TTSP_realtimeTX_TTSL_realtimeMM_TTSL_realtime_speech-01-turboZJ_TTSL_realtimeALI_TTSL_realtime_cosyvoice-v1XF_TTS_realtimeBD_TTS_realtime_zh

默认值:

TX_TTSP_realtime

示例值:

MM_TTSL_realtime_speech-01-turbo

session_token

string

可选

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

示例值:

0886a1f1-cd25-445a-9f3a-767032da9b84

language

enum<string>

可选

(新)参数语种设定

枚举值:

autozhenjayueko

默认值:

auto

示例值:

auto

示例

{
  "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

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200对话聊天数据

text/plain

Body

object {0}

示例

{"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"}

ChatBot 智能体V3(socket)

流程图示意#

链接socket + 认证#

智能体 chat_bot_v3#

socket 返回示例说明#

示例JS文件下载#

请求参数

示例代码

返回响应

流程图示意

链接socket + 认证

智能体 chat_bot_v3

socket 返回示例说明

示例JS文件下载