枚举参考

← 返回首页

所有枚举位于 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 发起）
`TELEOP`	超视距遥操（v1.5.0 新增；wire 值 `"teleop"`）
`EXT_SKILL`	扩展技能（v1.5.0 新增；wire 值 `"extskill"`）
`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_TELEOP_ENTER`	`agentsdk.teleop.enter`	v1.5.0 新增：超视距遥操-进入请求
`AGENTSDK_TELEOP_ENTER_ACK`	`agentsdk.teleop.enter_ack`	v1.5.0 新增：超视距遥操-进入回执
`AGENTSDK_TELEOP_AUDIO_START`	`agentsdk.teleop_audio.start`	v1.5.0 新增：超视距遥操-音频段开始（可携带 `role` / `threshold` 参数）
`AGENTSDK_TELEOP_AUDIO_DELTA`	`agentsdk.teleop_audio.delta`	v1.5.0 新增：超视距遥操-音频增量（`audio` 字段为 base64）
`AGENTSDK_TELEOP_AUDIO_DONE`	`agentsdk.teleop_audio.done`	v1.5.0 新增：超视距遥操-音频段结束
`AGENTSDK_TELEOP_EXIT`	`agentsdk.teleop.exit`	v1.5.0 新增：超视距遥操-退出请求
`AGENTSDK_TELEOP_EXIT_ACK`	`agentsdk.teleop.exit_ack`	v1.5.0 新增：超视距遥操-退出回执
`AGENTSDK_EXT_SKILL_QUERY`	`agentsdk.ext_skill.query`	v1.5.0 新增：扩展技能-查询请求
`AGENTSDK_EXT_SKILL_QUERY_RESULT`	`agentsdk.ext_skill.query_result`	v1.5.0 新增：扩展技能-查询结果
`AGENTSDK_EXT_SKILL_INVOKE`	`agentsdk.ext_skill.invoke`	v1.5.0 新增：扩展技能-触发请求
`AGENTSDK_EXT_SKILL_INVOKE_ACK`	`agentsdk.ext_skill.invoke_ack`	v1.5.0 新增：扩展技能-触发回执
`AGENTSDK_EXT_SKILL_REPORT_STATE`	`agentsdk.ext_skill.report_state`	v1.5.0 新增：扩展技能-执行期间状态上报（网关 → SDK，触发 `ExtSkillInvokeCallback.on_state`）
`AGENTSDK_EXT_SKILL_INVOKE_RESULT`	`agentsdk.ext_skill.invoke_result`	v1.5.0 新增：扩展技能-触发结果
`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`	任务流打断请求确认
`AGENTSDK_FUNCTION_CALL_EXPOSE`	`agentsdk.function_call.expose`	v1.5.0 新增：Function Call 透传（网关 → SDK，触发 `on_function_call`）
`AGENTSDK_FUNCTION_CALL_ARBITER`	`agentsdk.function_call.arbiter`	v1.5.0 新增：Arbiter 仲裁决策回传（SDK → 网关，由 `on_arbiter` 发出）
`AGENTSDK_HISTORIES_EXPOSE`	`agentsdk.histories.expose`	v1.5.0 新增：对话历史透传（网关 → SDK，触发 `on_histories`）
`ILLEGAL`	`illegal`	未知 / 不识别

ArbiterDecision

v1.5.0 新增。Function Call 仲裁决策枚举（linksoul_agentsdk.ArbiterDecision），作为 response.on_arbiter(event_id, decision, arb_param) 的 decision 取值。

枚举值	wire 值	说明
`DELEGATE`	`delegate`	委派：交由智能体默认链路处理该 function call
`OVERRIDE`	`override`	覆盖：由二开应用接管处理，覆盖默认行为
`ILLEGAL`	`illegal`	非法 / 兜底值

python

from linksoul_agentsdk import ArbiterDecision

ArbiterDecision.of("delegate")   # → ArbiterDecision.DELEGATE
ArbiterDecision.of("unknown")    # → ArbiterDecision.ILLEGAL

Function Call 与 Arbiter 的接口与用法见被动交互指南 · Function Call 开放与 Arbiter 仲裁。

反查与默认值

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