跳到主要内容

在组件化页面中使用AI助理

在组件化页面中使用AI助理后，会在页面右侧显示一个AI对话框。同时页面可以订阅AI助理事件。以此实现页面及AI之间的交互，用户与AI之间的协同。

开启AI助理​

操作步骤如下：

组件化页面-绑定AI助理

打开页面编辑器顶部AI助理开关，选择一个AI助理即可。

AI助理配置​

开启AI助理后会在页面编辑器右侧显示AI助理配置框，有以下配置项：

  • AI助理：可切换页面中使用的AI助理
  • 欢迎语与开场白：设置个性化的欢迎语与开场白
  • 输入参数：如果使用的助理设置了自定义输入参数，则需为这些参数赋值。
  • 输出运行过程日志：可自定义助理运行时输出的运行过程日志内容。

组件化页面-绑定AI助理

AI助理事件订阅​

订阅节点运行事件​

助理中的节点开启可触发工作区事件后，会有两个事件: 到达节点时、节点完成后。页面订阅方式如下：

AI助理-工作区事件-订阅

在事件处理逻辑中，可使用事件输出的参数：

AI助理-工作区事件-订阅

订阅工具调用事件​

助理中的AI Agent节点开启工具调用事件后，会有两个事件: 工具调用前、工具调用后。页面订阅方式如下：

AI助理-工具调用事件-订阅

目前，可视化工具中无法使用工具调用事件的输出参数，需要开发者在源码模式中通过写代码使用。使用方式如下：

this.subscribeEvent("AI:aiagents.ClientManagementagent.callTool.preEvent", async ({ data}) => {
    // AI: AI助理事件固定前缀；aiagents.ClientManagementagent: 助理中的节点ID；callTool.preEvent: 工具调用前事件，callTool.postEvent: 工具调用后事件
    // data该工具事件携带的参数
    if(data.toolName.value === "services.ASvc.func1"){
        //TODO：如果工具名称是xxxx， do something 
    }
});

订阅对话区人机交互节点事件​

页面中可以订阅对话区人机交互节点事件。 订阅方式如下：

AI助理-对话区人机交互事件-订阅

订阅工作区人机交互节点事件​

页面中可以订阅工作区人机交互节点事件。 订阅方式如下：

AI助理-工作区人机交互事件-订阅

页面中发送AI消息​

在页面中使用AI助理后，页面上会有一个发送AI消息的函数。调用方式如下：

AI助理-发送AI消息

函数参数请见发送AI消息函数

直接调用AI助理​

同时，页面也支持在不开启AI助理时直接调用AI助理。AI助理提供了一个运行方法，可直接调用，调用方式如下：

AI助理-发送AI消息

服务/模型的函数逻辑中也可以通过该方式调用。