IConversationalAIAPIEventHandler 类

onMessageError

Kotlin

fun onMessageError(agentUserId: String, error: MessageError)

消息处理出错回调。

该回调在消息处理过程中发生错误时被触发。例如，聊天消息发送失败时会触发该回调，并返回错误信息。

参数

参数	数据类型	描述
agentUserId	String	智能体用户 ID。
error	MessageError	消息错误信息，包含错误类型和错误内容。详见 MessageError。

onMessageReceiptUpdated

Kotlin

fun onMessageReceiptUpdated(agentUserId: String, receipt: MessageReceipt)

消息回执更新回调。

参数

参数	数据类型	描述
agentUserId	String	智能体用户 ID。
receipt	MessageReceipt	消息回执信息。详见 MessageReceipt。

onAgentStateChanged

Kotlin

fun onAgentStateChanged(agentUserId: String, event: StateChangeEvent)

智能体状态发生变化回调。

参数

参数	数据类型	描述
agentUserId	String	智能体用户 ID。
event	StateChangeEvent	状态变化事件，详见 StateChangeEvent。

onAgentInterrupted

Kotlin

fun onAgentInterrupted(agentUserId: String, event: InterruptEvent)

中断事件发生时触发的回调。

参数

参数	数据类型	描述
agentUserId	String	智能体用户 ID。
event	InterruptEvent	中断事件，详见 InterruptEvent。

onAgentMetrics

Kotlin

fun onAgentMetrics(agentUserId: String, metric: Metric)

性能指标可用时触发的回调。

参数

参数	数据类型	描述
agentUserId	String	智能体用户 ID。
metric	Metric	性能指标。详见 Metric。

onAgentError

Kotlin

fun onAgentError(agentUserId: String, error: ModuleError)

智能体错误发生时的回调。

参数

参数	数据类型	描述
agentUserId	String	智能体用户 ID。
error	ModuleError	错误信息。详见 ModuleError。

onTranscriptionUpdated

Kotlin

fun onTranscriptionUpdated(agentUserId: String, transcription: Transcription)

转写内容更新回调。

注意

该回调可能会高频触发。如果需要去重，请在业务层处理。

参数

参数	数据类型	描述
agentUserId	String	智能体用户 ID。
transcription	Transcription	转写数据。详见 Transcription。

onDebugLog

Kotlin

fun onDebugLog(log: String)

内部调试日志回调。

参数

参数	数据类型	描述
log	String	调试日志信息。