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

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

启用AI助理

按照以下步骤操作：

在页面编辑器顶部打开 AI助理 开关并选择一个AI助理。

AI助理配置

启用AI助理后，页面编辑器右侧会显示AI助理配置面板，包含以下配置选项：

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

AI助理事件订阅

在助手中为节点启用可触发的工作区事件后，会有两个事件：到达节点时 和 节点完成后。页面订阅方法如下：

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

在助手中为AI Agent节点启用工具调用事件后，会有两个事件：工具调用前 和 工具调用后。页面订阅方法如下：

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

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，执行某些操作 
    }
});

页面可以订阅聊天区域人机交互节点事件。订阅方法如下：

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

在页面中发送AI消息

在页面中使用AI助理后，页面上会有一个 发送AI消息 功能。调用方法如下：

功能参数请参见发送AI消息功能

直接调用AI助理

此外，页面支持在不启用AI助理的情况下直接调用AI助理。AI助理提供了一个运行方法，可以直接调用。调用方法如下：

此方法也可以在服务/模型函数逻辑中调用。

启用AI助理​

AI助理配置​

AI助理事件订阅​

订阅节点运行事件​

订阅工具调用事件​

订阅聊天区域人机交互节点事件​

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

在页面中发送AI消息​

直接调用AI助理​

启用AI助理

AI助理配置

AI助理事件订阅

订阅节点运行事件

订阅工具调用事件

订阅聊天区域人机交互节点事件

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

在页面中发送AI消息

直接调用AI助理