自定义智能体

1. 参考快速启动操作，登录华为云码道IDE。
2. 单击华为云码道IDE右上角的设置图标 ，进入华为云码道IDE全局设置页面。
3. 在设置页面的左侧导航栏中，选择“智能体”。
4. 单击“创建智能体”，进入创建智能体页面。
5. 设置智能体参数，单击“创建”。
   图1 创建本地自定义智能体
   

   表2 创建智能体参数说明

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

6. 验证自定义智能体。
   • 自定义智能体创建后，在对应类别页签中（如“项目级”），可查看到已创建的智能体，且状态为已开启。
     图2 查看已创建的智能体
     
   • 在聊天界面的输入框中，单击“智能体”，在自定义智能体列表中可查看到目标智能体。
     图3 显示创建的自定义智能体
     
     

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

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

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

   表3 新建智能体参数说明

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

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

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

智能体采用Markdown文件格式编写，文件头部配置YAML Frontmatter元信息，主体承载Prompt角色指令。

---
name: agent-name         # 智能体名称
mode: subagent           # 智能体模式
description: Agent desc  # 智能体功能描述
disable: false           # 智能体启用开关
tools:                   # 工具权限配置
  tool1: true           # 允许使用tool1
  tool2: false            # 禁止使用tool2
---

# 提示词
这里是智能体的系统提示词内容

上述智能体各参数填写规范如下表所示：

tools：
  "*":false    #表示禁止所有工具

为当前项目定制的智能体，随代码库一并分发。项目级智能体添加后立即生效。若为子智能体，其何时被使用由主智能体决定。您可以通过以下任一方法添加项目级智能体。

• 新建项目级智能体
  1. 参考快速启动操作，登录华为云码道。
  2. 在“资源管理器”的“./.codeartsdoer/agents”文件夹上，单击鼠标右键选择“新建文件”，新建一个Markdown格式的文件。

     智能体名称由小写字母、数字和连字符（-）组成，开头和结尾不能是连字符，且连字符不可连续使用，长度1~64字符。例如code-reviewer。

  3. 在code-reviewer.md文件中编写智能体，完成后按快捷键（Windows/Linux：“Ctrl+S”；macOS:“Command(⌘)+S”）保存。
• 将已存在的智能体放置到指定路径

  将本地已存在的智能体放置到项目根目录的“./.codeartsdoer/agents”路径中。

个人级智能体添加后立即生效。若为子智能体，其何时被使用由主智能体决定。您可以通过以下任一方法添加个人级智能体。

• 新建个人级智能体
  1. 在本地的“%USERPROFILE%/.codeartsdoer/agents/”路径中，新建一个Markdown格式的智能体文件。

     智能体名称由小写字母、数字和连字符（-）组成，开头和结尾不能是连字符，且连字符不可连续使用，长度1~64字符。例如code-analyzer。

  2. 在code-analyzer.md文件中编写智能体，完成后按快捷键（Windows/Linux：“Ctrl+S”；macOS:“Command(⌘)+S”）保存。
• 将已存在的智能体放置到指定路径

  将本地已存在的智能体放置到“%USERPROFILE%/.codeartsdoer/agents/”路径中。

下面以创建一个项目级子智能体为例，向您介绍如何创建和使用智能体。

1. 在“资源管理器”的“./.codeartsdoer/agents”文件夹上，单击鼠标右键选择“新建文件”，新建一个Markdown格式的文件，文件名为code-analyzer.md。
2. 在创建的code-analyzer.md文件中，添加如下内容并保存。
   

   .md文件名字需要与.md文件中的“name”字段保持一致，否则您的子智能体会运行失败。例如，示例中的.md文件名字与“name”字段均为“code-analyzer”。

   ---
   name: code-analyzer
   mode: subagent
   description: 代码分析专家，只读取不修改
   disable: false
   tools:
     read: true
     glob: true
     grep: true
     list: true
   ---
   
   你是一个代码分析专家。你的任务是：
   1. 分析代码结构和质量
   2. 识别潜在问题和改进点
   3. 提供优化建议
   请仔细分析代码，但不要修改任何文件。

   文件保存成功后，在华为云码道IDE设置页面的“智能体 > 项目级”页签中，可查看到目标智能体，且状态为已启用。

   图7 查看目标智能体
   

3. 添加待检查的代码文件。

   在华为云码道聊天窗口的输入框中，输入“#”，选择“File”并从列表中选择您需要的文件。如果需要添加多个文件，只需在输入框中再次输入“#”，即可打开上下文窗口继续添加。

   图8 添加代码文件
   

4. 调用子智能体检查代码质量。
   1. 在输入框中，输入相关指令，如“使用code-analyzer检查代码质量”，单击发送图标 或使用“Enter”快捷键发送。
      图9 输入指令
      
   2. 查看子智能体调用结果。

      如下图所示，智能体会调用子智能体，并在回复中显示调用的子智能体名称。

      图10 子智能体使用示例
      

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