# 意图管理
意图包是意图分类的集中管理单元，用于将一组相关意图类别及其样例统一封装。在工作流的[高级意图识别节点](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0069.html)中直接引用预定义的意图包，即可高效实现大规模意图分类与智能路由。
意图包基于大模型语义理解能力，通过匹配意图名称、描述、样例、关联词等多维度特征，将用户输入映射到最匹配的意图分类。
**核心优势：**
- **一次定义，多处复用：**同一意图包（如"通用闲聊包""银行基础业务包"）可被多个工作流共享引用，避免重复配置，显著提升开发与维护效率。
- **独立管理，敏捷迭代：**意图包独立于工作流存在，支持批量导入/导出、版本管理与持续优化。更新后，所有引用该意图包的工作流将自动同步生效，保障业务逻辑一致。
#### 前提条件
已[开通AgentArts服务](https://support.huaweicloud.com/qs-agentarts/agentarts_04_0000.html)。
 #### 创建意图包
1. 登录[AgentArts智能体平台](https://console.huaweicloud.com/agentarts/#/home/overview)。
2. 单击左侧导航栏"开发中心 \> 开发配置 "，选择"意图管理"页签。
3. 单击界面右上角"新建意图包"。
4. 在"新建意图包"界面输入意图包名称。 
   ![](https://support.huaweicloud.com/lowcode-agentarts/public_sys-resources/note_3.0-zh-cn.png)
   - 输入意图包名称不允许重复。
   
   - 支持中英文、数字、下划线和中划线输入。
    
   
   
5. 单击![](https://support.huaweicloud.com/lowcode-agentarts/zh-cn_image_0000002687949900.png)，可在意图包中添加意图分类，分类信息包含名称和样例，如[图1]所示，参数说明如[表1]所示。
   
   图1配置意图包   
   ![](https://support.huaweicloud.com/lowcode-agentarts/zh-cn_image_0000002717389661.png "点击放大")
    表1配置意图包 
   | 参数        | 说明                                                                                                                                                                                                                                                                                                                                                         | 示例                                                                                                                                                                                                                                                                                                  |
   |:---|:---|:---|
   | 意图名称      | 意图分类的唯一标识，同一意图包内不允许与已有分类名称重复，支持中英文、数字、下划线和中划线输入。                                                                                                                                                                                                                                                                                                           | 查询实时天气                                                                                                                                                                                                                                                                                              |
   | 意图描述（可选）  | 针对意图名称的解释，填写后可进一步提升模型对于用户意图的理解准确率。                                                                                                                                                                                                                                                                                                                         | 用户希望获取指定地点当前时刻的天气概况，包含实时温度、天气状况（晴/阴/雨等）、体感温度、当前风力风向等基础气象信息                                                                                                                                                                                                                                          |
   | 意图样例（可选）  | - 填写和意图名称相关的样例，用于提升意图准确率。为了保证大模型的识别效果，每个意图分类建议至少提供**5-10 条**不同句式的样例。相似问法的意图样例，用英文分号 ";" 隔开。  - 意图样例支持输入中文、英文字母、数字、中划线、下划线，最大支持1000个字符。                             | 北京现在天气怎么样;上海现在几度;外面冷不冷;现在杭州下雨了吗;当前深圳天气如何                                                                                                                                                                                                                                                            |
   | 意图关键词（可选） | 对用户输入内容进行关键词拆解，匹配预设的意图关键词。 - 动作词：描述用户希望执行的操作，用英文分号 ";" 隔开。例如：查;看;查看;播报。  - 动作对象词：指明动作针对的具体对象，用英文分号 ";" 隔开。如：天气;气温;温度;降水概率。   | 例如：用户意图为"我想要**查询** 某天的**天气预报**" - 动作词：查;看;查看;播报  - 动作对象词：天气;气温;温度;降水概率   |
      
   ![](https://support.huaweicloud.com/lowcode-agentarts/public_sys-resources/note_3.0-zh-cn.png)
   意图管理页面支持对意图包重命名，添加意图、导入意图、批量录入、搜索、添加意图样例等。
   - 单击![](https://support.huaweicloud.com/lowcode-agentarts/zh-cn_image_0000002687949888.png)支持对意图包重命名。
   
   - 单击![](https://support.huaweicloud.com/lowcode-agentarts/zh-cn_image_0000002687790042.png)可添加意图。
   
   - 单击![](https://support.huaweicloud.com/lowcode-agentarts/zh-cn_image_0000002717389651.png)导入意图。
     - 单个sheet页的导入数据应不超过200条，超过数量不允许导入；
     
     - 上传文件限xlsx格式，文件不超过5MB，支持下载导入模板。
      
   
   - 支持批量导入意图样例，多个意图样例名称须使用英文逗号分隔，最大支持输入1000字符。
   
   - 搜索框中支持输入搜索。
    
   
   
6. 添加完成后，单击"保存"。保存后，您可以在"开发中心 \> 开发配置 \> 意图管理"界面中的"意图包列表"查看已创建的意图包。
7. 创建完成后，可在意图管理界面的意图包列表查看已创建的意图包。 
   如需修改可在意图包列表中单击"编辑"，进入意图包编辑页面。
   图2编辑意图包   
   ![](https://support.huaweicloud.com/lowcode-agentarts/zh-cn_image_0000002687790046.png "点击放大")
   
   
 
#### 批量导入意图包
当需要从外部文件批量创建意图包或跨环境迁移时，使用导入功能。
1. 在"意图管理"界面，单击页面右上角"导入"。
2. 在导入意图包页面，单击"下载模板"可直接下载标准模板文件，按照模板格式填写。填写导入文件时，约束与限制如下： 
   - 单个sheet页的导入数据最大支持200条，大于200则不支持导入。
   
   - 上传文件限xlsx格式，文件不大于5MB。
   
   - 意图包名称与已配置意图包名称不能重复。
   
   - 多个意图样例名称须使用英文逗号分隔，最大支持输入1000字符。
   
   
   
   
3. 需要导入的文件填写好后，单击"导入"，每个Sheet页将作为独立的意图包显示在"意图管理"页面中。 
   导入后的意图包可在意图管理界面的意图包列表查看。
   ![](https://support.huaweicloud.com/lowcode-agentarts/public_sys-resources/note_3.0-zh-cn.png)
   如果文件中包含多个Sheet页，每个Sheet页将被创建为一个独立的意图包。
   
   
 
#### 批量导出意图包
将意图包导出为xlsx文件，用于备份、跨环境迁移或离线编辑。
1. 在"意图管理"界面，单击页面右上角"导出"。
2. 在导出页面，勾选需要导出的意图包（支持多选），单击"导出"。单击页面左上角"导出"，文件将以xlsx格式下载至本地。 
   导出文件结构如[表2]所示。
   下载完成后，打开xlsx文件检查各Sheet页中的意图包名称、分类、样例是否完整。
    表2导出文件结构 
   | 导出内容  | 文件结构                   |
   |:---|:---|
   | 单个意图包 | 单Sheet页，Sheet名称=意图包名称  |
   | 多个意图包 | 多Sheet页，每个Sheet对应一个意图包 |
      
   
   
 
#### 在工作流中使用意图包
意图包创建完成后，可以在工作流中的高级意图识别节点中引用，具体请参见[高级意图识别](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0070.html)。