设置华为云Astro轻应用标准页面智能助手组件属性

数据绑定

基本属性

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

• 品牌名：设置智能助手的品牌名，默认为“智能助手”。
• 品牌Logo：智能助手的品牌Logo，建议使用JPG、JPEG、PNG和GIF格式的图片，且图片的大小不能超过50MB。
• 内容区背景图片：设置智能助手内容区域的背景图片，建议使用JPG、JPEG、PNG和GIF格式的图片，且图片的大小不能超过50MB。
  图4 内容区域
  
• 占位符：设置智能助手输入卡片的占位符。
  图5 占位符
  
• 欢迎语：设置智能助手组件的欢迎语。
  图6 欢迎语
  
• 展示快捷指令：是否展示快捷指令，默认为开启。开启后，需要设置具体的快捷指令。
• 快捷指令：设置快捷指令，提高操作效率、降低操作难道等。开启“展示快捷指令”时，需要设置，必须为Json格式。
  图7 设置快捷指令效果
  

  [
      {
          "key": "text abstract",
          "label": "文本摘要",
          "desc": "低代码具备哪些优势"
      },
      {
          "key": "keyword extraction",
          "label": "关键词提取",
          "desc": "帮我提取文档中的关键词"
      },
      {
          "key": "text translation",
          "label": "文本翻译",
          "desc": "帮我翻译一句话"
      }
  ]

• 展示猜你想问：智能助手界面是否显示猜你想问，默认为开启。开启后，需要设置具体的问题。
• 猜你想问：设置用户想咨询的问题，帮助用户快速定位到感兴趣的内容。开启“展示猜你想问”时，需要设置，必须为Json格式。
  图8 设置猜你所想效果
  

  [
      {
          "label": "低代码典型使用场景",
          "value": "轻应用构建,零代码应用构建,行业应用构建"
      },
      {
          "label": "低代码具备哪些优势",
          "value": "降低应用构建门槛,加速业务敏捷创新,支撑大型企业级应用构建"
      }
  ]

• 描述：设置智能助手的描述信息，必须为Json格式。
  图9 设置描述后效果
  

  [
      "智能助手描述",
      "智能助手可以辅助研发人员编码、查询知识和相关作业信息、编写文档等"
  ]

• 展示点赞：是否在模型回答区域展示点赞，默认为关闭。
• 展示点踩：是否在模型回答区域展示点踩，默认为关闭。
• 展示对话历史：是否展示历史对话，默认为开启。开启后，有助于开发者了解用户的常见问题。
  图10 开启历史对话效果
  
• 对话历史列表：展示的历史对话列表，必须为Json格式。
  图11 历史对话列表
  

  [
      {
          "id": 15453742,
          "sessionId": "c19809****202a4dab1",
          "title": "title",
          "createTime": "2025-03-31 17:37:46",
          "updateTime": "2025-04-01 19:47:14",
          "messages": []
      }
  ]

• 使用条款链接：使用条款链接，不配置则不展示。
  图12 设置使用条款链接后效果
  
• 隐私声明链接：隐私声明链接，不配置则不展示。
  图13 设置隐私声明链接后效果
  

高级属性

• 知识库：是否使用知识库，默认为关闭。对于查询文献资料的场景，当用户自身资料文档数量庞大，使用资料不方便、查询效率低下时，智能助手组件能够协助用户调用大模型接口获取答案。同时，通过RAG这个技术，结合知识库，为用户提供更为智能、自然的对话体验，提升信息检索的准确性和相关性。
  构建知识库功能受限使用，需要提交工单申请开通。

  图14 开启知识库效果
  
• 大模型：是否支持对接大模型连接器，默认为关闭。开启大模型前，需要先在大模型连接器中配置大模型对接的信息，再在智能助手组件中选取对应的大模型连接器。如何创建大模型连接器，请参见使用连接器调用大模型。
  图15 开启大模型效果
  
• 默认大模型：单击“设置默认模型”，添加使用连接器调用大模型中创建的大模型连接器。
• 温度：控制生成内容的随机性和创造性，数值越大生成的内容越随机。
• 多样性：返回概率总和>=top_p的内容，控制生成内容多样性。其中，“top_p”为大模型核采样参数的名称。
• 重复惩罚：“0”表示无惩罚，正值表示增加惩罚，抑制重复，负值表示减少惩罚，允许更多重复。

公共

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

样式

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

事件

选中智能助手组件，在“事件”页签可为组件添加事件。

图16 添加事件

// 当前组件
const _component = context.$component.current;
// 获取当前对话数据
const messages = _component.getMessages()
console.log(messages );

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

// 当前组件
const _component = context.$component.current;
// 获取单击项内容
var currentChat = _component.getCurrentHistoryData();
console.log(currentChat );

// 当前组件
const _component = context.$component.current;
// 获取单击项内容
var currentChat = _component.getCurrentHistoryData();
console.log(currentChat );

// 根据当前组件获取待删除数据
const _component = context.$component.current;
const currentData = _component.getCurrentHistoryData();

// 当前组件
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 messages = _component.getMessages()
console.log(messages );

相关文档

除了直接使用标准页面预置的智能助手组件构建AI工具，华为云Astro轻应用还支持通过自定义标准组件的方式构建AI工具，例如通过对接AI开发平台ModelArts中的DeepSeek模型构建AI工具，详细介绍请参见华为云Astro轻应用构建智能助手模板。