更新时间:2026-06-10 GMT+08:00
分享

意图管理

意图包是意图分类的集中管理单元,用于将一组相关意图类别及其样例统一封装。在工作流的高级意图识别节点中直接引用预定义的意图包,即可高效实现大规模意图分类与智能路由。

意图包基于大模型语义理解能力,通过匹配意图名称、描述、样例、关联词等多维度特征,将用户输入映射到最匹配的意图分类。

核心优势:

  • 一次定义,多处复用:同一意图包(如“通用闲聊包”“银行基础业务包”)可被多个工作流共享引用,避免重复配置,显著提升开发与维护效率。
  • 独立管理,敏捷迭代:意图包独立于工作流存在,支持批量导入/导出、版本管理与持续优化。更新后,所有引用该意图包的工作流将自动同步生效,保障业务逻辑一致。

前提条件

开通AgentArts服务

创建意图包

  1. 登录AgentArts智能体平台
  2. 单击左侧导航栏开发中心 > 开发配置 ,单击左上角“意图管理”页签,进入意图管理界面
  3. 单击界面右上角“新建意图包”
  4. “新建意图包”界面输入意图包名称。

    • 输入意图包名称不允许重复。
    • 支持中英文、数字、下划线和中划线输入。

  5. 单击,可在意图包中添加意图分类,分类信息包含名称和样例,如图1所示,参数说明如表1所示。

    图1 配置意图包
    表1 配置意图包

    参数

    说明

    示例

    意图名称

    意图分类的唯一标识,同一意图包内不允许与已有分类名称重复,支持中英文、数字、下划线和中划线输入。

    查询实时天气

    意图描述(可选)

    针对意图名称的解释,填写后可进一步提升模型对于用户意图的理解准确率。

    用户希望获取指定地点当前时刻的天气概况,包含实时温度、天气状况(晴/阴/雨等)、体感温度、当前风力风向等基础气象信息

    意图样例(可选)

    • 填写和意图名称相关的样例,用于提升意图准确率。为了保证大模型的识别效果,每个意图分类建议至少提供5-10 条不同句式的样例。相似问法的意图样例,用英文分号 “;” 隔开。
    • 意图样例支持输入中文、英文字母、数字、中划线、下划线,最大支持1000个字符。

    北京现在天气怎么样;上海现在几度;外面冷不冷;现在杭州下雨了吗;当前深圳天气如何

    意图关键词(可选)

    对用户输入内容进行关键词拆解,匹配预设的意图关键词。

    • 动作词:描述用户希望执行的操作,用英文分号 “;” 隔开。例如:查;看;查看;播报。
    • 动作对象词:指明动作针对的具体对象,用英文分号 “;” 隔开。如:天气;气温;温度;降水概率。

    例如:用户意图为“我想要查询某天的天气预报

    • 动作词:查;看;查看;播报
    • 动作对象词:天气;气温;温度;降水概率
    意图管理页面支持对意图包重命名,添加意图、导入意图、批量录入、搜索、添加意图样例等。
    • 单击支持对意图包重命名。
    • 单击可添加意图。
    • 单击导入意图。
      • 单个sheet页的导入数据应不超过200条,超过数量不允许导入;
      • 上传文件限xlsx格式,文件不超过5MB,支持下载导入模版。
    • 支持批量导入意图样例,多个意图样例名称须使用英文逗号分隔,最大支持输入1000字符。
    • 搜索框中支持输入搜索。

  6. 添加完成后,单击“保存”。保存后,您可以在“开发中心 > 开发配置 > 意图管理”界面中的“意图包列表”查看已创建的意图包。
  7. 创建完成后,可在意图管理界面的意图包列表查看已创建的意图包。

    如需修改可在意图包列表中单击“编辑”,进入意图包编辑页面。
    图2 编辑意图包

批量导入意图包

当需要从外部文件批量创建意图包或跨环境迁移时,使用导入功能。

  1. 在“意图管理界面,单击页面上角“导入”
  2. 在导入意图包页面,单击“下载模板”可直接下载标准模板文件,按照模板格式填写。填写导入文件时,约束与限制如下:

    • 单个sheet页的导入数据最大支持200条,大于200则不支持导入。
    • 上传文件限xlsx格式,文件不大于5MB。
    • 意图包名称与已配置意图包名称不能重复。
    • 多个意图样例名称须使用英文逗号分隔,最大支持输入1000字符。

  3. 需要导入的文件填写好后,单击“导入”,每个Sheet页将作为独立的意图包显示在“意图管理”页面中。

    导入后的意图包可在意图管理界面的意图包列表查看。

    如果文件中包含多个Sheet页,每个Sheet页将被创建为一个独立的意图包。

批量导出意图包

将意图包导出为xlsx文件,用于备份、跨环境迁移或离线编辑。

  1. 在“意图管理界面,单击页面上角“导出”
  2. 在导出页面,勾选需要导出的意图包(支持多选),单击“导出”。单击页面左上角“导出”,文件将以xlsx格式下载至本地。

    导出文件结构如表2所示。

    下载完成后,打开xlsx文件检查各Sheet页中的意图包名称、分类、样例是否完整。
    表2 导出文件结构

    导出内容

    文件结构

    单个意图包

    单Sheet页,Sheet名称=意图包名称

    多个意图包

    多Sheet页,每个Sheet对应一个意图包

在工作流中使用意图包

意图包创建完成后,可以在工作流中的高级意图识别节点中引用,具体请参见高级意图识别

相关文档