更新时间:2025-08-27 GMT+08:00

设置华为云Astro轻应用标准页面对话历史组件属性

对话历史用于展示用户与大模型的历史对话记录。

图1 对话历史

数据绑定

标准页面中的组件,通过建立不同类型的视图模型,将各种数据源和组件的返回值或者属性值进行关联,实现动态数据效果。
  • 值绑定:值绑定类似Vue中的v-model语法,组件上创建双向数据绑定。值绑定会根据组件类型自动选取正确的方法来更新元素。同时,负责检测各类引起绑定数据变化的事件以更新数据。
    1. “数据绑定”中,单击“值(value)绑定”中的,进入选择模型页面。
    2. 单击“新增模型”,进入新增模型页面。
    3. 设置“模型名称”“来源”,单击“下一步”。
      图2 定义模型

      华为云Astro轻应用支持自定义、对象、服务和事件四类模型,每类模型都包含参数定义和方法定义。方法是在模型上定义的API,通常会在前台组件关联的事件脚本(例如页面加载事件、鼠标单击事件)中调用这些API,以实现某些功能。

      表1 模型来源说明

      分类

      模型说明

      模型参数的定义

      模型方法的定义

      API调用方法

      自定义

      开发者自行定义的模型。

      由开发者自定义,可以添加子节点。

      开发者自定义方法。

      $model.ref("modelName").actionName();

      对象

      由Object对象表映射生成,关于对象模型的详细介绍,请参见对象

      系统自动获取Object所有的字段,开发者可以从中选择部分字段作为参数。

      系统自动生成查询、保存、删除和统计四个方法。

      • 查询:$model.ref("modelName").query(param);
      • 保存:$model.ref("modelName").save();
      • 删除:$model.ref("modelName").delete();
      • 统计:$model.ref("modelName").count();

      服务

      服务模型由后台服务映射生成,当前仅支持与服务编排、脚本进行映射。关于服务模型的详细介绍,请参见服务编排脚本

      参数根据后台服务的入参、出参,映射生成为inputParam和outputParam节点。

      系统自动生成run方法 ,用于执行模型关联的服务编排或脚本。

      $model.ref("modelName").run();

      事件

      事件模型由后台事件的字段映射生成,并且支持websocket刷新模型数据。

      参数根据后台事件的字段映射生成。

      直接使用

      直接使用

      除了在模型中定义的方法,低代码平台还提供了如下标准API,适用于所有的模型。

      • 获取模型数据:$model.ref("modelName").getData();
      • 设置模型数据:$model.ref("modelName").setData();
      • 设置模型字段值:$model.ref("modelName").setValue(key,value);
    4. 在新建模型“设置”页面,执行如下操作。
      • 上一步来源选择“自定义”,需要添加子节点自定义参数及类型。
      • 上一步来源选择“对象”,需要配置模型关联的对象以及字段。
      • 上一步来源选择“服务”,需要配置模型关联的后台服务,可以是脚本、服务编排或者公共接口。
      • 上一步来源选择“事件”,需要配置模型关联的事件以及事件字段。
    5. 单击“下一步”,设置方法。

      方法一般无需添加,如需添加或修改,可参考对象和服务默认生成的方法。

    6. 设置完成后,单击“确定”。
  • 属性值绑定:将容器组件的某个属性,如隐藏、样式、弹性布局等与具体的模型字段绑定,绑定后组件的属性随模型字段的值变化而变化,类似Vue的v-bind。
    1. “数据绑定”中,单击“属性值绑定”后的“+”
    2. “属性”下拉框中,选择容器的某个属性。
    3. 在模型字段中,单击,进入选择模型页面。
    4. 单击“新增模型”,进入新增模型页面。
    5. 设置模型名称与来源,单击“下一步”。
      华为云Astro轻应用支持自定义、对象、服务和事件四类模型,每类模型都包含参数定义和方法定义。方法是在模型上定义的API,通常会在前台组件关联的事件脚本(例如页面加载事件、鼠标单击事件)中调用这些API,以实现某些功能。详细介绍,请参见表1
      图3 定义模型
    1. 在新建模型“设置”页面,执行如下操作。
      • 上一步来源选择“自定义”,需要添加子节点自定义参数及类型。
      • 上一步来源选择“对象”,需要配置模型关联的对象以及字段。
      • 上一步来源选择“服务”,需要配置模型关联的后台服务,可以是脚本、服务编排或者公共接口。
      • 上一步来源选择“事件”,需要配置模型关联的事件以及事件字段。
    2. 单击“下一步”,设置方法。

      方法一般无需添加,如需添加或修改,可参考对象和服务默认生成的方法。

    3. 设置完成后,单击“确定”。

基本属性

基本属性通过数据绑定后,在运行时以数据绑定的值为准。

  • 品牌名:对话历史列表中,是否展示品牌名,不设置则为空。
    图4 品牌名设置效果
  • 品牌Logo:对话历史列表中,是否展示品牌Logo,不设置则为空。建议使用JPG、JPEG、PNG和GIF格式的图片,且图片的大小不能超过50MB。
  • 可搜索:是否支持搜索历史对话,默认为开启。
    图5 可搜索设置效果
  • 可编辑:是否可以编辑历史对话,默认为开启。
    图6 可编辑设置效果
  • 可删除:是否可以删除历史对话,默认为开启。
    图7 可删除效果

公共

  • 控件名称:当前组件的名称。
  • 隐藏:是否隐藏该组件,此方式为静态配置该组件的隐藏。还可以将该组件属性值“隐藏”配置为布尔类型模型字段,在自定义JS代码中来控制模型字段取值,从而设置该组件是否隐藏,这种动态设置优先级是最高的。

样式

  • 布局:设置组件的宽度、高度等。
  • 字体:设置字体大小、字体样式、颜色等。
  • 背景:设置背景颜色、透明度。
  • 边框:设置边框颜色、宽度等,支持“px”、“em”和“%”三种单位。
  • 阴影:设置阴影颜色、模糊、扩散等,支持“px”、“em”和“%”三种单位。
  • 高级设置
    • 样式源码:组件具体样式代码,组件样式设置后,样式代码将自动显示在“样式源码”中,也可以自定义样式代码,对组件进行详细配置,自定义代码支持多行输入,并高亮显示样式参数。
    • 样式类:当前组件使用的CSS样式类名,可在CSS代码中进行引用。

事件

选中对话历史组件,在“事件”页签可为组件添加事件。

图8 添加事件
表2 事件说明

事件

说明

点击历史对话

单机大模型回答区域的点赞按钮时,触发此处事件。按照如下内容,可以获取到点赞区域的内容。

// 当前组件
const _component = context.$component.current;
// 获取当前操作列数据
const currentRecord = _component.getCurrentRecord();console.log(currentRecord);

修改历史对话

单击大模型回答区域的点踩按钮时,触发此处事件。按照如下内容,可以获取到点踩区域的内容。

// 当前组件
const _component = context.$component.current;
// 获取修改后的数据
const currentRecord = _component.getCurrentRecord();
console.log(currentRecord);

删除历史对话

发送过程中,单击停止回答,用于打断调用大模型接口,通常需要主动关闭与大模型的连接。

// 当前组件
const _component = context.$component.current;
// 获取当前操作列数据
const currentRecord = _component.getCurrentRecord();
console.log(currentRecord);