智能体设置

仅码道代码智能体基础版和专业版套餐支持创建云端自定义智能体。

1. 进入码道代码智能体控制台。
2. 在左侧导航栏中，选择“智能体设置 > 智能体中心”，进入智能体中心页面。
3. 单击“新建智能体”，进入新建智能体页面。
4. 设置智能体参数，单击“新建并启用”。

   表2 新建智能体参数说明

   参数	说明
   智能体头像	系统预置了多种风格的自定义智能体头像。单击头像上的编辑按钮，即可根据需求选择合适的风格。
   智能体名称	新建自定义智能体的名称。 命名规范：长度2~20字符，由中文、英文字母、数字、下划线和中划线（-）组成，且必须以中文或英文字母开头。
   智能体类型	选择智能体的工作模式，影响其行为逻辑和能力边界。 主/子智能体：既可以被主智能体调用，也可以主动调用子智能体。 主智能体：独立运行处理用户请求，不能被其他主智能体、子智能体调用。 子智能体：可被其他主智能体调用来执行特定任务。
   描述	简要说明这个智能体能做什么，帮助用户理解其功能，长度不能超过5000个字符。
   可用范围	定义自定义智能体的可用范围，创建后不可修改。 个人：仅创建者可用。 企业：企业全员可用，仅企业管理员可创建。 团队：仅指定团队可用，企业管理员或团队管理员可创建。
   可用团队空间	指定可使用该智能体的团队，仅展示当前账号所属团队。 “可用范围”设置为“团队”时，才会显示该配置项。
   提示词	设定智能体的角色、语气、工作流程、规则规范等系统指令，相当于给AI的“人设+行为准则”。
   内置工具	智能体本身自带的、开箱即用的工具。 阅读：检索并查看文件内容。 编辑：对文件进行新增、修改或删除操作。 终端：在命令行环境中执行系统命令。 预览：实时预览生成的前端页面效果。 访问网页：抓取并读取网页内容。
   技能	为智能体关联技能，使其具备执行某些专业任务的能力。 说明： 华为云码道对智能体关联的技能数量没有硬性限制，建议不要超过20个，确保获得最优使用体验。

5. 查看创建的智能体。
   • 返回智能体中心，在智能体列表中可查看到已创建的智能体。
     图1 在智能体中心查看目标智能体
     
   • 在华为云码道IDE设置页面的“智能体”中，单击刷新图标 ，进行手动刷新。刷新完成后，进入目标页签（如个人级），即可查看到目标智能体。
     图2 在华为云码道IDE查看目标智能体
     
   • 在聊天界面的输入框中，单击“智能体”，在自定义智能体列表中可查看到目标智能体。
     图3 在聊天输入框查看目标智能体
     
     

     如果您创建的是子智能体，则不会在自定义智能体中显示。

仅创建者可管理云端自定义智能体。

在云端支持创建企业级、团队级与个人级三类技能，具体步骤如下。创建云端技能前，请确保您已购买码道代码智能体基础版或专业版套餐。

1. 进入码道代码智能体控制台。
2. 在左侧导航栏选择“智能体设置 > 技能和规则中心”，进入技能和规则列表页面。
3. 在“技能”页签，单击右上角的“新建技能”，弹出“新建技能”对话框。
4. 在蓝色框区域单击鼠标右键，从本地上传技能zip包。或将本地技能zip包直接拖入蓝色框区域，然后单击“确定”。
   

   • 技能zip包需符合技能的目录结构，否则可能会导入失败。例如，每个技能文件夹的根目录均须包含对应的SKILL.md文件，此文件中须包含YAML格式的技能名称与描述等。
   • 每次仅支持上传一个zip包，包内可存放多个技能文件夹，且包的总大小不能超过5M。
   图4 上传技能zip包
   

5. 参考表6设置云端技能参数。
   图5 新建云端技能
   

   表6 云端技能参数说明

   参数	说明
   更换	若您需要重新上传技能zip包，单击“更换”，参考4重新上传zip包。
   可用范围	个人：仅限本人使用，不会共享给其他用户。 企业：整个企业所有成员都可用，仅企业管理员可创建。 团队：指定的团队可用，企业管理员或团队管理员可创建。
   可用团队	仅“可用范围”设置为“团队”时，展示此参数。 在下拉列表中选择团队，仅展示当前账号所属团队。 若尚未创建团队，请先创建团队。
   标签	可选，华为云码道已预置了几类标签，请根据实际需求在下拉列表中选择。

6. 单击“确定并启用”，完成技能的创建。

   在“技能”页签中，查看新创建的技能。如需立即在本地华为云码道中查看云端创建的技能，请进入“技能与规则”下对应技能页签（企业级/团队级/个人级），单击技能后的 或“ > 刷新”，同步云端技能到本地客户端。

   

   • 华为云码道客户端每24小时自动同步一次云端技能。
   • 华为云码道客户端仅同步已启用的技能。

仅创建者可编辑、删除、启用及禁用技能。

在云端创建企业级、团队级与个人级三类规则，具体步骤如下。

1. 进入码道代码智能体控制台。
2. 在左侧导航栏选择“智能体设置 > 技能和规则中心”，进入技能和规则列表页面。
3. 在“规则”页签，单击右上角的“新建规则”，弹出“新建规则”对话框。
4. 参考表8设置规则参数。
   图6 新建云端规则
   

   表8 云端规则参数说明

   参数	说明
   名称	新建规则的名称。 命名规范：长度1~64字符，且仅允许包含字母、数字、下划线、中文、连字符（-）和点号。
   内容	自定义一条或多条规则的内容，长度不能超过50000个字符。 例如，始终使用Python语言回答。
   使用范围	指定规则的适用范围，即规则在哪里生效。 自动应用：规则将默认应用于所有会话，包括华为云码道编辑区，系统自动识别，无需重复配置。 手动触发：规则不会自动生效。用户需在对话中输入“#”，并从列表中选择特定规则，方可启用。
   可用范围	个人：仅限成员本人使用，不会共享给其他用户。 企业：整个企业所有成员都可用，仅企业管理员可创建。 团队：指定的团队的可用，企业管理员或团队管理员可创建。
   可用团队	仅“可用范围”设置为“团队”时，展示此参数。 在下拉列表中选择团队，仅展示当前账号所属团队。若尚未创建团队，请先创建团队。
   标签	可选，华为云码道已预置了几类标签，请根据实际需求在下拉列表中选择。
   简要描述	可选，规则的描述信息，长度不能超过1024个字符。

5. 单击“确定并启用”，完成规则的创建。

   在“规则”页签中，查看新创建的规则。如需立即在华为云码道客户端中查看云端创建的规则，请进入“技能与规则”下对应规则页签（企业级/团队级/个人级），单击规则后的 ，同步云端规则到客户端。

   

   • 华为云码道客户端每24小时自动同步一次云端规则。
   • 华为云码道客户端仅同步已启用的规则。

仅创建者可编辑、删除、启用及禁用规则。

1. 新建知识空间。

   知识空间用于集中管理多个知识库。在创建知识库之前，须先创建一个知识空间。

   1. 在知识空间页面，单击“新建空间”，参考表10完成参数配置。
      图7 新建空间
      

      表10 新建知识空间参数说明

      参数	说明
      知识空间名称	新建知识空间的名称。 命名规则：不能以下划线开头，支持中文、英文、数字、下划线（_）和中划线（-），长度不超过18个字符。
      可见范围	对成员访问权限进行管控。 个人：仅成员本人可用。 团队：知识空间关联的团队下所有成员可用，由企业管理员或团队管理员创建。 企业：整个企业所有成员都可用，由企业管理员创建。
      可用团队	仅“可见范围”设置为“团队”时，展示此参数。 在下拉列表中选择团队，仅展示当前账号所属团队。
      标签	可选，为知识空间添加标签，用于分类和管理内容，最多可选择10个标签。 若尚未创建标签，参考以下步骤创建。否则，请执行下一步。 在下拉列表中单击“添加”，弹出“新增标签”对话框。输入标签名称，长度不超过32个字符，单击“确定”。 勾选目标标签。
      描述	可选，输入知识空间的描述信息，长度不超过300个字符。完善的描述有助于华为云码道准确地理解内容范围，提升检索匹配的精准度。

   2. 单击“确定”，完成知识空间的创建。
      在知识空间列表中，可查看到已创建的知识空间。

      图8 查看已创建的知识空间
      

2. 新建知识库。

   基于已创建的知识空间创建知识库，并根据知识的类型和来源进行分类，确保信息结构清晰、易于检索。

   1. 在知识空间列表中，单击已创建的知识空间，进入知识空间详情页面。
   2. 单击右上角的“新建知识库”，弹出“新建知识库”对话框。
   3. 参考表11完成基本信息配置。
      图9 新建知识库

      

      表11 知识库基本信息参数说明

      参数	说明
      知识库名称	新建知识库的名称。 名称规则：不能以下划线开头，支持中英文、数字、下划线（_）和中划线（-），长度不超过32个字符。
      知识类型	选择知识库的类型，支持“非结构化格式”和“结构化格式”。 非结构化格式：数据没有固定的格式。 结构化格式：数据有固定格式、字段、结构。
      数据来源	选择知识库的数据来源，包括“本地文件”和“代码”两种类型。 “知识类型”为“非结构化格式”时，支持的数据来源如下。 本地文件：主要包含文本内容，可以包括文章、报告、书籍等，支持TXT、DOCX、PDF、MD、CSV、XLS和XLSX格式文件。 代码：仅支持ZIP格式的压缩包，内含Java 、Python、C、C++或Vue代码文件。 “知识类型”为“结构化格式”时，仅支持“本地文件”，文件格式为JSON。
      知识库描述	可选，输入知识库的描述信息，介绍知识库中包含的内容，长度不超过300个字符。详细的描述有助于指导智能体更准确地调用知识库。

   4. 单击“下一步”，参考表12完成入库信息的配置。
      图10 入库配置（非结构化格式）
      
      图11 入库配置（结构化格式）
      

      表12 入库配置参数说明

      参数	说明
      Embedding模型	选择Embedding模型，对上传的文件/代码进行向量化，提供以下模型可供选择： bge-m3：多语种的1024维文本嵌入模型，支持向量/稀疏/多表征混合检索，最大支持8192 tokens长文本，适合复杂多语言场景。 m3e-base：中英文文本的通用型768维的嵌入模型，适用于大多数中英文基础语义理解与检索任务。 bge-large-zh-v1.5：中文专用模型，适用于检索、分类、聚类及语义匹配等任务。 paraphrase-multilingual-MiniLM-L12-v2：中英文文本的364维嵌入模型，在文本相似度计算中表现优异，适合对速度有要求的场景。 VESO-v1.3：代码专用模型，针对代码数据深度优化，在代码数据向量化与搜索任务中表现突出。
      切分器	“知识类型”为“非结构化格式”，且“数据来源”为“本地文件”时，展示此参数。 不同切分器的切片方式和结果不同，在不同的语言场景下可以选择不同的切分器，当前支持以下切分器。 基于段落的切分器：按照两个连续的换行符（\n\n）分割或文本段落结构分割。 基于行的切分器：按照换行符（\n）分割。 基于句子的切分器（适用于英文文本）：将文本按照英文句子分割。 基于字符的切分器：逐个字符（含空白字符）分割。
      分段预计长度	“知识类型”为“非结构化格式”，且“数据来源”为“本地文件”时，展示此参数。 分片长度的取值范围为50~1200，默认值为1000。
      分段重叠长度	“知识类型”为“非结构化格式”，且“数据来源”为“本地文件”时，展示此参数。 当前分片与上一个分片重叠的文本长度，取值范围为0到分片的长度，默认值为0。
      子切分器	“知识类型”为“非结构化格式”，且“数据来源”为“本地文件”时，展示此参数。 切片长度超过最大长度时应用子切分器。当前支持以下切分器： 基于字符的切分器：逐个字符（含空白字符）分割。 基于句子的切分器（适用于英文文本）：将文本按照英文句子分割。 基于单词的切分器（适用于英文文本）：将文本按照空白字符分割。
      需建立索引的字段	“知识类型”设置为“结构化格式”时，展示此参数。 请输入JSON中的Key，作为检索时的索引字段。最多支持20个字段，多个字段间请用英文逗号（,）分隔。
      过滤配置字段	“知识类型”设置为“结构化格式”时，展示此参数。 请输入JSON中的Key，作为检索时的过滤条件。最多支持2个字段，字段之间请用英文逗号（,）分隔。
      索引字段	“数据来源”设置为“代码”时，展示此参数。 选择索引的字段，即智能体在进行搜索时，主要对哪个数据字段建立索引并进行匹配。 假设，索引字段选择函数体，则当用户输入关键词进行搜索时，智能体会优先在代码的“函数体”部分进行查找和匹配。
      使用滑动窗口	“数据来源”设置为“代码”时，展示此参数。 开启后，可进一步将复杂函数切分成多个片段，提高搜索的准确性。

   5. 单击“确定”，完成知识库的创建。

      在知识库列表中，可查看到已创建的知识库。

3. 导入文件。

   知识库创建后，您可以将存储在本地的各类文档上传至知识库。上传后，系统将自动进行数据清洗与索引构建，确保您导入的内容能够被快速检索和调用，从而实现知识的即时沉淀。

   1. 在知识库列表中，单击已创建知识库的名称，进入知识库详情页面。
   2. 单击右上角的“导入文件”，进入“导入文件”页面。
   3. 选择本地要导入的文件或代码，单击“确定”，返回知识库页面。
      图12 上传文件或代码
      

      请根据所需知识类型上传相应的文件或代码。单个文件或压缩包最大支持20MB，单个知识库最大支持50MB。

      表13 导入文件说明

      知识类型	数据来源	说明
      非结构化格式	本地文件	支持TXT、DOCX、PDF、MD、CSV、XLS和XLSX格式文件。
      	代码	仅支持ZIP格式的压缩包，内含Java、Python、C、C++或Vue代码文件。
      结构化格式	本地文件	支持JSON格式文件。

   4. 查看导入结果。

      当“导入状态”由“上传中”变更为“入库成功”时，表示文件已成功导入。

1. 进入码道代码智能体控制台。
2. 在左侧导航栏选择“智能体设置 > 代码库索引”，进入“代码库索引”页面。
3. 单击“新建索引”，进入新建代码库索引页面。
4. 参考表16，设置代码库索引参数。
   图13 新建代码库索引
   

   表16 代码库索引参数说明

   参数	说明
   可见范围	定义代码库索引的可见范围。 个人：仅成员本人可用。 团队：仅本团队成员可用，由企业管理员或团队管理员创建。 企业：整个企业所有成员都可用，由企业管理员创建。
   可用团队	“可见范围”设置为“团队”时，才会显示该配置项。 指定可使用该代码库索引的团队。
   代码源	选择您想要索引的代码仓库来源。 Repo：可能指内部自研的“代码仓库”系统。 Git：通用Git仓库。 Github：GitHub上的公开或授权私有仓库。
   选择项目	“代码源”设置为“Repo”时，才会显示该配置项。 从已关联的代码源中，选择具体要索引的项目。
   获取授权	选择一种方式来授权系统访问您的代码源。 通过服务授权：在下拉框中选择服务扩展点，该扩展点对应Repo、Github或Git仓库的连接信息。 若还未创建服务扩展点，单击“添加”，参考表17创建服务扩展点。 通过个人访问令牌：使用用户个人账户生成的访问令牌进行认证。
   默认分支	“代码源”设置为“Git”时，才会显示该配置项。 输入Git仓库的分支名称，分支名称不能超过200个字符。

   图14 新建服务扩展点
   

   表17 服务扩展点参数说明

   参数	说明
   连接名称	自定义连接仓库的名称。 命名规范：由中文、英文、数字、下划线和中划线组成，不能以下划线开头。
   Git仓库Url	“代码源”设置为“Repo”或“Git”时，才显示该配置项。 Repo/Git仓库的HTTPS访问地址。
   用户名	“代码源”设置为“Repo”或“Git”时，才显示该配置项。 Repo/Git仓库HTTPS协议的认证用户名。
   密码或Access Token	“代码源”设置为“Git”时，才显示该配置项。 Git仓库HTTPS协议的认证密码或Access Token。
   Access Token	“代码源”设置为“Repo”或“Github”时，才显示该配置项。 Repo/Github仓库HTTPS协议的Access Token。

5. 单击“验证并确定”，完成代码库索引的创建。

   在代码库仓索引页面，查看新创建的代码库索引。当该代码库索引的状态由“解析中”变为“解析完成”时，表示解析代码库索引成功。

6. 返回到JetBrains界面，打开Git/Repo/Github仓库项目，华为云码道自动从云端下载团队代码库索引。

   团队代码库索引下载成功后，页面显示进度为100%。

7. 在智能问答模式下使用代码库索引时，需先打开代码库索引开关。

   代码索引完成后（图标为 ），在聊天窗口的输入框下方单击代码库索引搜索图标 ，即可一键启用代码库索引功能。