AIMA开放平台文档中心Agent SDK (Android)

枚举参考

枚举参考

AgentCallbackType

被动回调类型,决定 SDK 接收哪些事件:

枚举值字符串值说明
AUDIO_2_LLMaudio2llm音频→ASR+LLM
AUDIO_2_TTSaudio2tts音频→ASR+LLM+TTS
ASR_2_LLMasr2llm文本→LLM
ASR_2_TTSasr2tts文本→LLM+TTS
ASR_VIDEO_2_TTSasrVideo2tts文本+视频→VLM+TTS
ASR_VIDEO_2_VLMasrVideo2vlm文本+视频→VLM
AUDIO_VIDEO_2_TTSaudioVideo2tts音频+视频→VLM+TTS
AUDIO_VIDEO_2_VLMaudioVideo2vlm音频+视频→VLM
ILLEGALillegal无效类型
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_SYNCagentsdk.robot_state.sync机器人上下线
AGENTSDK_AUDIO_REQUEST_STARTagentsdk.audio_request.startVAD开始
AGENTSDK_AUDIO_REQUEST_APPENDagentsdk.audio_request.append音频帧
AGENTSDK_AUDIO_REQUEST_COMMITagentsdk.audio_request.commitVAD结束
AGENTSDK_ASR_REQUEST_TEXTagentsdk.asr_request.textASR文本输入
AGENTSDK_TTS_REQUEST_TEXTagentsdk.tts_request.textTTS文本输入
AGENTSDK_SKILL_QUERY_RESPONSEagentsdk.skill_query.response技能查询响应
AGENTSDK_STATE_QUERY_RESPONSEagentsdk.state_query.response状态查询响应
AGENTSDK_STATE_REQUEST_METAagentsdk.state_request.meta状态推送
AGENTSDK_GREET_REQUEST_FACEagentsdk.greet_request.face打招呼-人脸/UID 信号
AGENTSDK_GREET_REQUEST_VIDEOagentsdk.greet_request.video打招呼-视频信号
AGENTSDK_GREET_REQUEST_SIGNALagentsdk.greet_request.signal打招呼-业务信令
AGENTSDK_GREET_RESPONSE_VLM_DELTAagentsdk.greet_response.vlm.delta打招呼 VLM 流式片段
AGENTSDK_GREET_RESPONSE_VLM_DONEagentsdk.greet_response.vlm.done打招呼 VLM 结束
AGENTSDK_GREET_RESPONSE_TTS_DELTAagentsdk.greet_response.tts.delta打招呼 TTS 流式片段
AGENTSDK_GREET_RESPONSE_TTS_DONEagentsdk.greet_response.tts.done打招呼 TTS 结束
AGENTSDK_TELEOP_ENTERagentsdk.teleop.enterv1.5.0 新增:超视距遥操-进入请求
AGENTSDK_TELEOP_ENTER_ACKagentsdk.teleop.enter_ackv1.5.0 新增:超视距遥操-进入回执
AGENTSDK_TELEOP_AUDIO_STARTagentsdk.teleop_audio.startv1.5.0 新增:超视距遥操-音频段开始(可携带 role / threshold 参数)
AGENTSDK_TELEOP_AUDIO_DELTAagentsdk.teleop_audio.deltav1.5.0 新增:超视距遥操-音频增量(audio 字段为 base64)
AGENTSDK_TELEOP_AUDIO_DONEagentsdk.teleop_audio.donev1.5.0 新增:超视距遥操-音频段结束
AGENTSDK_TELEOP_EXITagentsdk.teleop.exitv1.5.0 新增:超视距遥操-退出请求
AGENTSDK_TELEOP_EXIT_ACKagentsdk.teleop.exit_ackv1.5.0 新增:超视距遥操-退出回执
AGENTSDK_EXT_SKILL_QUERYagentsdk.ext_skill.queryv1.5.0 新增:扩展技能-查询请求
AGENTSDK_EXT_SKILL_QUERY_RESULTagentsdk.ext_skill.query_resultv1.5.0 新增:扩展技能-查询结果
AGENTSDK_EXT_SKILL_INVOKEagentsdk.ext_skill.invokev1.5.0 新增:扩展技能-调用请求
AGENTSDK_EXT_SKILL_INVOKE_ACKagentsdk.ext_skill.invoke_ackv1.5.0 新增:扩展技能-调用确认(受理)
AGENTSDK_EXT_SKILL_REPORT_STATEagentsdk.ext_skill.report_statev1.5.0 新增:扩展技能-执行期间状态上报(网关 → SDK,触发 ExtSkillInvokeCallback.onState)
AGENTSDK_EXT_SKILL_INVOKE_RESULTagentsdk.ext_skill.invoke_resultv1.5.0 新增:扩展技能-调用结果
AGENTSDK_FUNCTION_CALL_EXPOSEagentsdk.function_call.exposev1.5.0 新增:Function Call 透传(网关 → SDK,触发 onFunctionCall)
AGENTSDK_FUNCTION_CALL_ARBITERagentsdk.function_call.arbiterv1.5.0 新增:Arbiter 仲裁决策回传(SDK → 网关,由 onArbiter 发出)
AGENTSDK_HISTORIES_EXPOSEagentsdk.histories.exposev1.5.0 新增:对话历史透传(网关 → SDK,触发 onHistories)

ArbiterDecision

v1.5.0 新增。Function Call 仲裁决策枚举(com.agibot.aiem.sdk.enums.ArbiterDecision),作为 response.onArbiter(eventId, decision, arbParam) 的 decision 取值。

枚举值wire 值说明
DELEGATEdelegate委派:交由智能体默认链路处理该 function call
OVERRIDEoverride覆盖:由二开应用接管处理,覆盖默认行为
ILLEGALillegal非法 / 兜底值

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