ConvoAIClient 类

create

Java

public static synchronized ConvoAIClient create(ConvoAIConfig convoAIConfig)

创建一个具有指定配置的对话式 AI 引擎 REST Client。

信息

自 v0.3.0 版本新增。

参数

参数	数据类型	描述
convoAIConfig	ConvoAIConfig	配置参数，详见 ConvoAIConfig。

返回值

返回对话式 AI 引擎 REST Client 实例。

join

Java

public abstract Mono<JoinConvoAIRes> join(JoinConvoAIReq request);

创建一个智能体实例并加入指定的 RTC 频道。

信息

自 v0.3.0 版本新增。

参数

参数	数据类型	描述
request	JoinConvoAIReq	加入对话式 AI 引擎请求的参数，详见 JoinConvoAIReq。

返回值

返回加入响应结果，详见 JoinConvoAIRes。

leave

Java

public abstract Mono<Void> leave(String agentId);

停止指定的智能体实例并离开 RTC 频道。

信息

自 v0.3.0 版本新增。

注意

在使用此方法前，请确保通过调用 join API 获取智能体 ID。

参数

参数	数据类型	描述
agentId	String	智能体 ID。

list

Java

public abstract Mono<ListConvoAIRes> list(ListConvoAIReq request);

检索符合指定条件的智能体列表。

信息

自 v0.3.0 版本新增。

参数

参数	数据类型	描述
request	ListConvoAIReq	用于列出智能体的参数，详见 ListConvoAIReq。

返回值

返回列表响应结果，详见 ListConvoAIRes。

query

Java

public abstract Mono<QueryConvoAIRes> query(String agentId);

查询指定智能体实例的当前状态。

信息

自 v0.3.0 版本新增。

注意

在使用此方法前，请确保已通过调用 join API 获取智能体 ID。

参数

参数	数据类型	描述
agentId	String	智能体 ID。

返回值

查询响应结果，详见 QueryConvoAIRes。

update

Java

public abstract Mono<UpdateConvoAIRes> update(String agentId, UpdateConvoAIReq request);

在运行时调整智能体的参数。

信息

自 v0.3.0 版本新增。

注意

在使用此方法之前，请确保通过调用 join API 获取智能体 ID。

参数

参数	数据类型	描述
agentId	String	智能体 ID。
request	UpdateConvoAIReq	用于更新对话式智能体的参数，详见 UpdateConvoAIReq。

返回值

更新响应结果，详见 UpdateConvoAIRes。

getHistory

Java

public abstract Mono<HistoryConvoAIRes> getHistory(String agentId);

获取指定智能体实例的短期记忆。

信息

自 v0.4.0 版本新增。

参数

参数	数据类型	描述
agentId	String	智能体 ID。

返回值

方法调用成功，返回指定智能体实例的短期记忆。详见 HistoryConvoAIRes。

interrupt

Java

public abstract Mono<InterruptConvoAIRes> interrupt(String agentId);

中断指定的智能体实例。

信息

自 v0.4.0 版本新增。

参数

参数	数据类型	描述
agentId	String	智能体 ID。

返回值

方法调用成功，返回中断响应结果，详见 InterruptConvoAIRes。

speak

Java

public abstract Mono<SpeakConvoAIRes> speak(String agentId, SpeakConvoAIReq request);

为指定的智能体实例播报自定义消息。

信息

自 v0.4.0 版本新增。

参数

参数	数据类型	描述
agentId	String	智能体 ID。
request	SpeakConvoAIReq	指定智能体播报自定义消息的请求体，详见 SpeakConvoAIReq。

返回值

方法调用成功，返回 SpeakConvoAIRes 对象。