枚举参考

← 返回首页

所有枚举位于 linksoul_agentsdk.enums，并从顶层 linksoul_agentsdk 再次导出。

AgentCallbackType

被动回调类型，决定 SDK 接收哪些事件：

枚举值	字符串值	说明
`AUDIO_2_LLM`	`audio2llm`	音频→ASR+LLM
`AUDIO_2_TTS`	`audio2tts`	音频→ASR+LLM+TTS
`ASR_2_LLM`	`asr2llm`	文本→LLM
`ASR_2_TTS`	`asr2tts`	文本→LLM+TTS
`ASR_VIDEO_2_TTS`	`asrVideo2tts`	文本+视频→VLM+TTS
`ASR_VIDEO_2_VLM`	`asrVideo2vlm`	文本+视频→VLM
`AUDIO_VIDEO_2_TTS`	`audioVideo2tts`	音频+视频→VLM+TTS
`AUDIO_VIDEO_2_VLM`	`audioVideo2vlm`	音频+视频→VLM
`PUSH_LISTEN`	`pushListen`	推流监听（保留枚举但 v1.4.0 暂未公开 register）
`ILLEGAL`	`illegal`	无效类型

python

from linksoul_agentsdk import AgentCallbackType

ct = AgentCallbackType.of("audio2tts")
# → AgentCallbackType.AUDIO_2_TTS

打招呼信令、状态推送、人脸 UID、视频帧透传不再使用独立的回调类型，直接在任一已注册的被动回调上重载 on_greet_signal / on_state / on_face_info / on_video_frame 即可接收。

FlowMode

任务流模式：

枚举值	说明
`SIMPLE`	单步模式：`start_request` 中携带完整 payload
`COMPLEX`	多步模式：start → task × N → end

RobotState

机器人在线状态：

枚举值	说明
`ONLINE`	机器人在线（触发 `on_robot_online`）
`OFFLINE`	机器人离线（触发 `on_robot_offline`）

AgentPolicy

交互策略（内部使用，开发者无需关心）：

枚举值	说明
`PASSIVE`	被动交互（机器人发起）
`ACTIVE`	主动交互（SDK 发起）
`SIGNAL`	信令交互

AgentEventType

WebSocket 消息事件类型（内部使用），关键事件：

枚举值	事件类型字符串	说明
`AGENTSDK_ROBOT_STATE_SYNC`	`agentsdk.robot_state.sync`	机器人上下线
`AGENTSDK_AUDIO_REQUEST_START`	`agentsdk.audio_request.start`	VAD 开始
`AGENTSDK_AUDIO_REQUEST_APPEND`	`agentsdk.audio_request.append`	音频帧
`AGENTSDK_AUDIO_REQUEST_COMMIT`	`agentsdk.audio_request.commit`	VAD 结束
`AGENTSDK_ASR_REQUEST_TEXT`	`agentsdk.asr_request.text`	ASR 文本输入
`AGENTSDK_TTS_REQUEST_TEXT`	`agentsdk.tts_request.text`	TTS 文本输入
`AGENTSDK_STATE_REQUEST_META`	`agentsdk.state_request.meta`	状态推送
`AGENTSDK_GREET_REQUEST_FACE`	`agentsdk.greet_request.face`	打招呼-人脸/UID 信号
`AGENTSDK_GREET_REQUEST_VIDEO`	`agentsdk.greet_request.video`	打招呼-视频信号
`AGENTSDK_GREET_REQUEST_SIGNAL`	`agentsdk.greet_request.signal`	打招呼-业务信令
`AGENTSDK_GREET_RESPONSE_VLM_DELTA`	`agentsdk.greet_response.vlm.delta`	打招呼 VLM 流式片段
`AGENTSDK_GREET_RESPONSE_VLM_DONE`	`agentsdk.greet_response.vlm.done`	打招呼 VLM 结束
`AGENTSDK_GREET_RESPONSE_TTS_DELTA`	`agentsdk.greet_response.tts.delta`	打招呼 TTS 流式片段
`AGENTSDK_GREET_RESPONSE_TTS_DONE`	`agentsdk.greet_response.tts.done`	打招呼 TTS 结束
`AGENTSDK_FLOW_START_REQUEST_ACK`	`agentsdk.flow_start.request_ack`	任务流 start 请求确认
`AGENTSDK_FLOW_START_EXECUTE_ACK`	`agentsdk.flow_start.execute_ack`	任务流 start 执行确认
`AGENTSDK_FLOW_TASK_REQUEST_ACK`	`agentsdk.flow_task.request_ack`	任务流 task 请求确认
`AGENTSDK_FLOW_TASK_EXECUTE_ACK`	`agentsdk.flow_task.execute_ack`	任务流 task 执行确认
`AGENTSDK_FLOW_END_REQUEST_ACK`	`agentsdk.flow_end.request_ack`	任务流 end 请求确认
`AGENTSDK_FLOW_INTERRUPT_REQUEST_ACK`	`agentsdk.flow_interrupt.request_ack`	任务流打断请求确认
`ILLEGAL`	`illegal`	未知 / 不识别

反查与默认值

每个枚举都提供 of(value) 类方法：传入字符串时返回对应成员，未匹配时回退到 ILLEGAL（或 RobotState.ILLEGAL 等）。传入 None 同样回退到 ILLEGAL。