智能体 Web SDK （AI 助教专版）方法说明

静态方法

init

方法签名

init(options: object): Promise<instance>

示例代码

提示

options 参数是初始化智能体实例的选项，详细说明见 概览-初始化参数 章节。

const options = {
  // ...
};
CxRobotSdkJs.init(options).then((robot) => {
  console.log(robot);
});

实例方法

setLocale

设置语言，查看可选值

方法签名

setLocale(locale: string) => void

setTranslate

设置形象（窗口）位置；基于原始位置的坐标偏移量，可以通过 robot.translate 获取用户拖放后的偏移信息。

方法签名

setTranslate(x: number, y: number) => void

示例代码

robot.setLocale("zh-CN");

on

注册一个事件监听

方法签名

on(event:string, callback:function) => void

示例代码

robot.on("progress", (progress) => {
  console.log("progress", progress);
});

once

监听事件(仅触发一次)

方法签名

once(event:string, callback:function) => void

示例代码

robot.once("progress", (data) => {
  // 以下代码只会打印一次
  console.log(data);
});

off

取消指定事件的监听回调，callback 为空时取消所有同名事件

方法签名

off(eventName: string, callback?: function) => void

示例代码

const foo = () => {
  // to do something
};
const bar = () => {
  // to do something
};

// 监听 progress 事件
robot.on("progress", foo);
robot.on("progress", bar);

// 取消 progress 事件的 foo 回调，保留 bar 回调
robot.off("progress", foo);

// 取消所有 progress 事件的回调
robot.off("progress");

emit

触发事件，data 为可选参数

方法签名

emit(eventName: string, ...data?: any) => void

示例代码

// 监听 hello 事件
robot.on("hello", (...data) => {
  console.log(...data);
});

// 触发 hello 事件并传递参数
robot.emit("hello", "world");

// 触发 hello 事件并传递多个参数
robot.emit("hello", "world", "!");

// 触发 hello 事件并传递对象参数
robot.emit("hello", { name: "world" });

notify

展示一条通知消息

提示

调用该方法前请确保已触发 initSuccess 事件

方法签名

notify(message:string)

示例代码

robot.notify("你好，我是小星");

stopNotify

关闭通知

提示

调用该方法前请确保已调用过 notify 方法

方法签名

stopNotify() => void;

示例代码

robot.stopNotify();

talk

朗读指定文本

提示

仅在 options.useToonFigure 为 1 时可用

方法签名

talk(text: string) => void

示例代码

robot.talk("你好，我是小星, 有什么我能帮你的？");

hide

隐藏入口形象

方法签名

hide() => void

示例代码

robot.hide();

show

展示入口形象

方法签名

show() => void

示例代码

robot.show();

openWin

打开聊天窗口

方法签名

openWin() => void

示例代码

robot.openWin();

closeWin

关闭聊天窗口

方法签名

closeWin() => void

示例代码

robot.closeWin();

invoke

调用智能体页面能力，查看智能体页面能力

提示

调用该方法前请确保已触发 wsConnected 事件

方法签名

invoke(name: string, data?: any) => void

示例代码

robot.invoke("send", { text: "hello" });

destroy

销毁实例

提示

1. 请在页面卸载时调用该方法，防止内存泄漏
2. 销毁实例后，无法再使用该实例，请重新创建实例

方法签名

destroy() => void

示例代码

robot.destroy();