枚举参考
枚举参考
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 |
ILLEGAL | illegal | 无效类型 |
java
AgentCallbackType type = AgentCallbackType.of("audio2tts"); // 字符串转枚举
打招呼信令、状态推送、人脸 UID、视频帧透传不再使用独立的回调类型, 直接在任一已注册的被动回调上重载
onGreetSignal/onState/onFaceInfo/onVideoFrame即可接收。
FlowMode
任务流模式:
| 枚举值 | 说明 |
|---|---|
SIMPLE | 单步模式:startRequest 中携带完整 payload |
COMPLEX | 多步模式:start → task × N → end |
RobotState
机器人在线状态:
| 枚举值 | 说明 |
|---|---|
ONLINE | 机器人在线(触发 onRobotOnline) |
OFFLINE | 机器人离线(触发 onRobotOffline) |
AgentPolicy
交互策略(内部使用,开发者无需关心):
| 枚举值 | 说明 |
|---|---|
PASSIVE | 被动交互(机器人发起) |
ACTIVE | 主动交互(SDK发起) |
TELEOP | 超视距遥操(v1.5.0 新增;远端操作员接管;wire 值 "teleop") |
EXT_SKILL | 扩展技能(v1.5.0 新增;SDK 查询/调用机器人技能;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_SKILL_QUERY_RESPONSE | agentsdk.skill_query.response | 技能查询响应 |
AGENTSDK_STATE_QUERY_RESPONSE | agentsdk.state_query.response | 状态查询响应 |
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.onState) |
AGENTSDK_EXT_SKILL_INVOKE_RESULT | agentsdk.ext_skill.invoke_result | v1.5.0 新增:扩展技能-调用结果 |
AGENTSDK_FUNCTION_CALL_EXPOSE | agentsdk.function_call.expose | v1.5.0 新增:Function Call 透传(网关 → SDK,触发 onFunctionCall) |
AGENTSDK_FUNCTION_CALL_ARBITER | agentsdk.function_call.arbiter | v1.5.0 新增:Arbiter 仲裁决策回传(SDK → 网关,由 onArbiter 发出) |
AGENTSDK_HISTORIES_EXPOSE | agentsdk.histories.expose | v1.5.0 新增:对话历史透传(网关 → SDK,触发 onHistories) |
ArbiterDecision
v1.5.0 新增。Function Call 仲裁决策枚举(
com.agibot.aiem.sdk.enums.ArbiterDecision),作为response.onArbiter(eventId, decision, arbParam)的decision取值。
| 枚举值 | wire 值 | 说明 |
|---|---|---|
DELEGATE | delegate | 委派:交由智能体默认链路处理该 function call |
OVERRIDE | override | 覆盖:由二开应用接管处理,覆盖默认行为 |
ILLEGAL | illegal | 非法 / 兜底值 |
Function Call 与 Arbiter 的接口与用法见 被动交互指南 · Function Call 开放与 Arbiter 仲裁。