操作步骤

  1. 进入工程创建界面,工程界面如图1所示。

    • 首次登录MindStudio:在MindStudio欢迎界面单击“New Project”,进入创建工程界面。
    • 非首次登录MindStudio:在顶部菜单栏选择File > New > Project...,进入创建工程界面。
      图1 创建工程界面

      首次创建样例工程时,需确保开发环境已联网,用户也可以下载样例工程模板并解压到MindStudio安装目录/plugins/ascend-foundation/samples/advisor/”路径下,保证正常新建样例工程;若无需新建样例工程,也可以将下载的样例工程模板解压至任意目录,直接使用MindStudioFile > Open...打开。

  2. 创建生态知识库样例工程。

    1. 在左侧导航栏选择“Ascend Advisor”,在右侧配置CANN版本,如图1所示。
    2. 单击“Next”进入配置工程相关参数。如表1所示。
      表1 工程参数说明

      参数

      说明

      Project name

      工程名称,用户自行配置。

      名称必须以字母开头,数字或字母结尾,只能包含字母、数字、中划线和下划线,且长度不能超过64个字符。

      Project location

      工程默认保存路径,用户可自定义。(对于首次使用MindStudio的用户,该项默认为$HOME/MindstudioProjects”。)

      More Settings

      “Module name”:模块名,默认与“Project name”一致。

      “Content root”:根目录下路径。

      “Module file location”:模块文件路径。

      单击“Project format”右侧选框,出现下拉菜单。
      • .idea(directory-based):创建项目的时候创建一个.idea的项目录来保存项目的信息,默认选项。
      • .ipr(file-based):项目配置文件来保存项目的配置信息。
    3. 单击“Finish”,完成知识库样例工程创建。如图2所示。
      图2 生态知识库样例工程
    4. 若工作窗口已打开其他工程,会出现如下提示。
      • 选择“This Window”,则直接在当前工作窗口打开新创建的工程。
      • 选择“New Window”,则新建一个工作窗口打开新创建的工程。

  3. 查看训练工程目录结构和主要文件。

    表2 文件介绍

    文件名

    说明

    ecosystem.json

    生态知识库配置文件,通过该配置文件启动运行生态知识库。详细配置请参见3.a

    requirements.txt

    记录知识库的Python依赖,生态知识库开发者将生态知识库涉及的依赖填写在该文件内,其它用户使用知识库时通过命令pip3 install –r requirements.txt安装依赖。

    model.py

    生态知识库源码文件,生态开发者在此文件中编写业务代码,然后按照指定格式填充结果。源码文件文件名与生态知识库名称保持一致。详细开发指导请通过SDK下载路径获取。

    1. 修改ecosystem.json文件。
      各参数说明清参见表3
      {
          "model_list": [
              {
                  "model_name": "model",
                  "session_list": [
                      {
                          "python_model_path": "./model/src/"
                      }
                  ]
              }
          ]
      }
      表3 ecosystem.json参数说明

      配置项

      说明

      是否必选

      model_name

      生态知识库名称(即源码文件名)。

      python_model_path

      源码文件所在目录。可识别相对路径,配置ecosystem.json文件所在目录即可。

    2. 在其他环境使用生态知识库前,需要通过命令pip3 install –r requirements.txt安装依赖库。
    3. 在model.py文件中完成生态知识库代码开发。

  4. 执行专家系统分析。

    MindStudio IDE当前暂不支持生态知识库的专家系统分析功能。