# 通过华为云码道CodeArts代码智能体实现代码检查智能化
代码检查服务（CodeArts Check）支持以"CodeArts工具链插件"形式与[华为云码道CodeArts代码智能体](https://codearts.huaweicloud.com/)集成。CodeArts工具链插件通过灵活配置提示词（Prompt）、技能（Skill）等指令可让智能体更高效完成代码检查相关任务操作。
用户无需学习控制台的相关操作，就可以直接在华为云码道CodeArts代码智能体聊天窗口通过自然语言指令，让代码检查实现智能化，高效地完成代码检查任务的创建、执行及查看检查结果等日常操作。
#### 核心价值
- **免切换操作**：无需登录代码检查控制台，无需在控制台各个界面来回操作切换，即可在智能体聊天窗一站式完成代码检查任务相关操作。
- **自然语言交互**: "对话即操作"，通过指令即可完成任务创建、执行、查询等操作。
- **全场景覆盖**：检查任务管理、检查结果查询、门禁策略设置三大场景。
- **研发流程贯通：**与流水线、代码托管等服务联动，实现端到端研发流程。
 
#### 工作原理
代码检查服务通过CodeArts工具链插件，将自身API能力供暴露给华为云码道CodeArts代码智能体调用。智能体理解用户的自然语言指令后，通过KooCLI调用代码检查API执行对应操作，并将结果返回至聊天窗口。
图1交互流程   
![](https://support.huaweicloud.com/usermanual-codecheck/zh-cn_image_0000002699471446.png "点击放大")
#### CodeArts工具链插件
CodeArts工具链插件将需求管理、代码托管、代码检查、测试、流水线与编译构建、制品管理、部署发布等CodeArts研发服务以技能（Skill）和子代理（SubAgent）形式集成在代码智能体中。用户安装插件后，无需切换控制台，直接在智能体聊天窗口通过自然语言指令即可触发对应服务操作。主Agent接收用户指令后，通过Skill获取执行规范与路由策略：交互式操作由Skill引导完成，复杂编排任务委托SubAgent在隔离上下文中自主执行并返回结果。CodeArts工具链插件包含的skill及subagent详情请查阅[CodeArts全量Subagent和Skill](https://support.huaweicloud.com/bestpractice-codeartsagent/codeartsagent_bp_0055.html#section1)。
代码检查服务在CodeArts工具链插件中提供了一个技能（Skill）和一个子代理（SubAgent）。
技能（codearts-check-expert）是代码检查的交互式执行专家，覆盖创建、执行检查任务、查询检查结果、缺陷管理、规则集管理、门禁策略配置等全场景，能理解用户的自然语言意图并逐步引导完成操作；当操作复杂度高、涉及批量处理或多步编排时，技能会将任务转交给子代理（codearts-check-assistant）执行。子代理在独立上下文中自主运行，不占用主会话资源，可自动完成执行检查任务、查询缺陷统计、给出修复建议、生成检查报告等复杂编排任务，完成后返回结构化结果报告。两者协同构成了代码检查插件的两层执行架构，使智能体能灵活应对从单次查询到批量编排的全场景需求。
#### 适用场景
在进行代码检查时，以下场景均可让华为云码道CodeArts代码智能体完成。
| 场景分类   | 场景说明                        | 自然语言指令示例                                |
|:---|:---|:---|
| 检查任务管理 | 创建、执行检查任务、切换任务规则集并配置编译参数 | 执行检查任务"my-check-task"。                |
| 检查结果查询 | 查询代码检查度量结果，问题列表以及给出修复建议     | 查询检查任务"my-check-task"的问题列表。            |
| 门禁策略设置  | 配置单个任务门禁                    | 更新"my-check-task"任务质量门禁为致命问题数1，严重问题数2。 |
   
#### 前提条件
| 序号 | 条件项                                                                                                       | 说明                                                |
|:---|:---|:---|
| 1 | 已安装[华为云码道CodeArts代码智能体](https://support.huaweicloud.com/wtsnew-codeartsagent/index.html)并完成账号登录。         | 代码检查智能化需在CodeArts代码智能体中体现。                       |
| 2 | 已[购买CodeArts Check](https://support.huaweicloud.com/usermanual-codecheck/codeartscheck_01_9003.html)。       | 通过CodeArts代码智能体使用代码检查服务的相关功能，需已购买CodeArts Check。 |
| 3   | 已[配置CodeArts Check项目级角色权限](https://support.huaweicloud.com/usermanual-codecheck/devcloud_hlp_00101.html)。 | 通过CodeArts代码智能体使用代码检查服务的相关功能，需已先配置完相关权限。           |
   
![](https://support.huaweicloud.com/usermanual-codecheck/public_sys-resources/caution_3.0-zh-cn.png)
本操作执行工具调用、大模型推理会消耗码道代码智能体账号下的Token或者积分。
#### 操作步骤
1. 单击[下载CodeArts工具链插件](https://cnnorth4-cloudide-marketplace.obs.cn-north-4.myhuaweicloud.com/codearts/codeartsplugin/1.0.0/CodeArtsPlugin_resource_26.0924.1549_all.tar.gz)。
2. 单击执行插件包中install.bat脚本，完成插件和KooCLI安装。
3. 完成[KooCLI初始化配置](https://support.huaweicloud.com/usermanual-hcli/hcli_03_002.html)，将常用的永久AK/SK和区域信息存储在配置文件中，避免执行操作时频繁输入这些固定信息。
4. 打开华为云码道代码智能体聊天窗口，用自然语言告诉它你想做什么，就可以开始使用。 
   ![](https://support.huaweicloud.com/usermanual-codecheck/public_sys-resources/note_3.0-zh-cn.png)
   - 首次使用CodeArts Agent执行代码检查任务相关操作时，分析过程时间较长，随着指令使用的次数增加，分析速度会逐步提升，响应时间逐渐缩短。
   
   
   
   - 不同CodeArts代码智能体客户端的界面风格有所差异，实际操作请以所用工具的显示为准。
    
   
   
 
#### 场景一：检查任务管理
以下指令以执行代码检查任务为例：
```
执行Maven-ai-20260902094804检查任务
```
智能体开始分析任务并执行，整个过程在对话流里实时显示。执行成功后，您可以在任务列表查看已执行的任务。
效果示例：
![](https://support.huaweicloud.com/usermanual-codecheck/zh-cn_image_0000002747400937.png "点击放大")
![](https://support.huaweicloud.com/usermanual-codecheck/zh-cn_image_0000002718045530.png "点击放大")
#### 场景二：检查结果查询
以下指令以按级别查询缺陷统计为例：
```
查询“hgf_sonar_AzureResourceManager_检查目录”任务中问题级别为严重的问题
```
智能体开始分析任务并执行，整个过程在对话流里实时显示。执行成功后，您可以看到所查询的内容与在控制台中一致。
效果示例：
![](https://support.huaweicloud.com/usermanual-codecheck/zh-cn_image_0000002708923120.png "点击放大")
![](https://support.huaweicloud.com/usermanual-codecheck/zh-cn_image_0000002738578225.png "点击放大")
#### 场景三：门禁策略设置
以下指令以更新质量门禁为例：
```
更新任务“JavaDemo-20260108173702”的质量门禁为致命问题数0，严重问题数0
```
智能体开始分析任务并执行，整个过程在对话流里实时显示。执行成功后，您可以看到任务的质量门禁值已更新。
效果示例：
![](https://support.huaweicloud.com/usermanual-codecheck/zh-cn_image_0000002718023324.png "点击放大")
![](https://support.huaweicloud.com/usermanual-codecheck/zh-cn_image_0000002718023836.png "点击放大")
#### 相关文档
关于CodeArts工具链插件的更多使用场景，请参考[通过CodeArts工具链插件开发旅游小助手](https://support.huaweicloud.com/bestpractice-codeartsagent/codeartsagent_bp_0052.html)。