智能体对话

智能体模式是华为云码道（CodeArts）代码智能体核心功能，主要用于理解开发者复杂需求并自主规划执行路径，帮助研发人员在端到端开发任务场景下，实现从需求分析到代码落地的全流程自动化，显著提升开发效率。

核心能力

智能体具备多种核心能力，覆盖需求理解、任务规划、代码实现、工具调用的全流程，具体包括：

复杂任务规划与管理：可将自然语言需求转化为结构化的执行步骤，根据执行进度实时更新任务列表，实现开发任务的有序跟踪与规范管理。
自主代码生成与修改：可实现跨文件的代码编写与编辑，满足复杂场景下多文件同步变更需求。
智能工具调用：可自主完成信息检索与环境操作，支持调用代码搜索、文件读取、Shell命令执行等工具，保障生成的代码能够对接项目现有逻辑与依赖关系。
交互确认机制：在关键执行步骤设置人工确认环节，确保操作过程安全可控。

核心开发模式

智能体提供了如下两种开发模式，您可根据需求灵活选择。

探索模式（Vibe-Coding Mode）：边聊边做，即时验证。适用于头脑碰撞与创意发散，在对话中快速迭代，动态捕捉并明确潜在需求，助力从模糊想法到可行原型的高效转化。
规范驱动模式（Spec-Driven Mode）：以明确的技术或业务规范为基础，指导系统设计、开发及验证的工程方法论。在该模式下，所有开发活动均围绕既定的规范展开，确保最终成果在功能、性能、兼容性等方面与规范高度一致。适用于对一致性、可验证性有高要求的场景。

切换智能体模式。
1. 参考快速启动操作，登录华为云码道。
2. 在聊天界面的输入框下方选择“内置智能体 > 智能体”，切换到智能体模式。右侧显示当前选用的模型，您可在下拉框中切换不同大语言模型。
  
  如果没有正常显示华为云码道的聊天窗口，请在顶部菜单栏的右上方，单击展开AI侧栏图标，即可打开华为云码道。
3. 在聊天界面的模式选择中，单击“探索模式”，切换智能体到探索模式。
输入需求。在对话框输入您想要完成的任务，单击发送图标或使用“Enter”快捷键发送。
```
生成一个轻量化音乐播放器，简约干净、主打深色系沉浸式设计，排版清爽无冗余，黑胶质感，歌词显示空间充足有呼吸感
```
- 在生成回答的过程中，支持在输入框中发起新的对话，新对话会自动加入到任务队列中。任务队列中等待发送的消息最多支持20条，超出部分将不再接收。
- 单击聊天窗右下角的下拉箭头，可以切换发送快捷键。
- 不同的大语言模型在生成结果上可能存在差异，最终效果请以实际输出为准。
查看规划与确认。智能体会根据您输入的需求，为您生成相应的待办事项列表。

图1 执行规划
过程执行与查看。确认计划后，任务开始逐步进行，智能体会引导您一步步确认操作。您也可以展开待办，查看当前事项进展。

图2 查看执行过程

表示事项已完成，表示事项进行中，表示事项未启动。
任务完结。任务完成后，变更的文件放于暂存区。

图3 生成文件
结果确认。单击文件旁的箭头，展开文件信息，请根据实际需要进行操作。

图4 选择所需的操作
- 单击文件名，检视生成的内容。
- 将鼠标移至文件所在行，单击右侧接受文件，单击拒绝文件。
- 存在多个文件可以直接单击“全部接受”，接受全部文件，或者单击“全部拒绝”，拒绝全部文件。

切换智能体模式。
1. 参考快速启动操作，登录华为云码道。
2. 在聊天界面的输入框下方选择“内置智能体 > 智能体”，切换到智能体模式。右侧显示当前选用的模型，您可在下拉框中切换不同大语言模型。
  
  如果没有正常显示华为云码道的聊天窗口，请在顶部菜单栏的右上方，单击展开AI侧栏图标，即可打开华为云码道。
3. 在聊天界面的模式选择中，单击“规范驱动模式”，切换智能体到规范驱动模式。
按照预设的工作流逐步执行操作。在对话框输入您想要完成的任务，单击发送图标或使用“Enter”快捷键发送，智能体会按照“需求规格设计 > 实现方案创建 > 编码任务规划 > 任务执行”流程依次执行，确保每一步都高效、有序地推进。
```
请根据以下规范实现音乐播放器核心逻辑，严格遵循要求，不允许自行省略逻辑。
- 支持播放、暂停、上一曲、下一曲、循环播放（单曲/列表）
- 进度条支持点击跳转与拖动
- 音量范围0~1，默认为0.7，静音切换
- 切歌时自动更新封面、歌名、歌手信息
- 用HTML+CSS+JS实现
```
图5 按照指定工作流执行任务
- 若确认需求文档内容基本符合预期，单击“全部接受”或单击，接受生成的需求文档。
- 若不认可当前生成的需求文档，单击“全部拒绝”或单击，拒绝生成的需求文档。拒绝生成的需求文档后，继续执行下一步时，如果模型没有读取到文档，会再次生成缺失的文档。
- 确认需求文档无误后，单击“开始实施方案创建”，根据生成的规格文档，启动方案生成流程。

选择智能体运行模式

为了确保代码执行的安全性与灵活性，华为云码道为您提供了“沙箱运行”、“白名单运行”、“自动运行”和“手动模式”四种运行策略。您可以根据业务对安全和自动化的需求进行选择。华为云码道默认启用安全的“沙箱运行”模式。

您可按照以下步骤设置智能体运行模式。

参考快速启动操作，登录华为云码道IDE。
单击华为云码道IDE右上角的设置图标，进入华为云码道IDE全局设置页面。
在左侧导航栏中，选择“对话流”。

在“智能体 > 运行模式”中，选择智能体执行终端命令的运行策略。

表1 运行模式参数说明
参数	说明
点文件保护 (Dotfiles)	开启后，禁止智能体修改以点开头的配置文件，如.env、.gitignore等。说明： “运行模式”设置为“白名单运行”、“自动运行”或“手动模式”时，才显示该配置项。
编辑范围保护	开启后，仅允许智能体在当前项目目录范围内增加、修改和删除文件，不允许编辑其他目录中的文件。说明： “运行模式”设置为“白名单运行”、“自动运行”或“手动模式”时，才显示该配置项。
读取范围保护	开启后，仅允许智能体访问和读取当前项目目录中的文件，不允许访问其他目录中的文件。说明： “运行模式”设置为“白名单运行”、“自动运行”或“手动模式”时，才显示该配置项。
运行模式	智能体终端命令的执行策略，您可以根据业务对安全和自动化的需求进行选择。默认情况下，所有终端命令均需经用户手动批准后方可执行。沙箱运行：终端操作默认在安全沙箱环境中自动运行。白名单运行：仅允许智能体自动执行白名单中配置的命令，其他命令需要用户手动确认。如果您需要自动批准某些可信命令，可通过白名单来实现。白名单功能仅提供基本的安全防护，并不能完全避免潜在的绕过或误操作。在将命令加入白名单前，请逐条审查命令内容，确保其行为是安全的、可预期的，并符合您的需求。自动运行：智能体直接执行所有命令，无需征得您的同意。为了确保安全，建议只在必要时启用“自动运行”模式。此模式会绕过所有安全检查，可能在未经提醒的情况下执行高风险操作。手动模式：智能体执行任何命令前，都会向用户发送确认提示，用户需手动确认后，命令才会继续执行。
命令白名单	根据实际需求将特定命令的前缀添加到白名单。被加入白名单的命令将绕过沙箱机制，直接在沙箱外执行。说明： “运行模式”设置为“沙箱运行”或“白名单运行”时，才显示该配置项。
网络访问策略	智能体提供了三种网络访问策略供您选择。请依据实际业务需求及安全等级，配置相应的访问控制规则。全网访问：允许访问所有内部及外部网络资源。本地访问：仅允许访问本地服务网络（局域网/内网），禁止访问外部互联网。禁止网络访问：阻断所有网络连接，禁止访问任何内部或外部资源。说明： “运行模式”设置为“沙箱运行”时，才显示该配置项。

设置自动执行权限

如果未开启自动执行权限，当模型需要调用工具时，会在会话中显示“运行本次”、“添加xxx到白名单”和“跳过所有未运行工具”，需用户手动确认后方可继续。启用自动执行权限后，相关操作将自动通过，无需用户干预。此外，在用户进行手动确认时，还支持设置“每次询问”、“使用白名单”或“始终允许并开启配置”，以满足不同使用需求。

开启自动执行权限存在操作风险，请在开启前充分评估风险，并在安全可信环境中使用。

您可按照以下步骤设置自动执行权限。

参考快速启动操作，登录华为云码道IDE。
单击华为云码道IDE右上角的设置图标，进入华为云码道IDE全局设置页面。
在左侧导航栏中，选择“对话流”。

在“智能体 > 自动批准”中，根据实际需求启用自动化执行权限，允许模型在无需人工确认的情况下，直接执行以下操作。

表2 自动化操作项说明
自动化操作项	说明
编辑	允许智能体调用edit、write、deleteFile等工具来编辑您计算机上的文件。
使用浏览器	允许智能体在浏览器中访问网站。
网页抓取工具	允许智能体访问并抓取指定网页的内容。

优化输入内容

华为云码道通过智能优化用户输入，帮助新手更清晰、专业地提出问题，助力用户一次性获得全面、结构化的高质量回答，有效减少反复追问，提升沟通效率与使用体验。

您可参考以下步骤对输入内容进行优化。

参考快速启动操作，登录华为云码道。
在聊天界面的输入框下方选择“内置智能体 > 智能体”，切换到智能体模式。右侧显示当前选用的模型，您可在下拉框中切换不同大语言模型。

如果没有正常显示华为云码道的聊天窗口，请在顶部菜单栏的右上方，单击展开AI侧栏图标，即可打开华为云码道。
输入相关指令，单击优化输入内容图标，等待优化完成。
图6 优化输入内容

图7 优化后效果

如果优化结果未达到您的预期，可单击撤销优化图标，将问题恢复至原始状态。