使用智能体
CukeTest 智能体（CTAgent）是运行在 CukeTest 中的 AI 智能体插件。它面向软件测试与测试开发场景，能够理解测试需求，并在同一工作区内协助完成测试探索、用例设计、自动化脚本生成、代码优化和工程维护等任务。
与普通 AI 聊天工具不同，智能体可以在授权后读取和修改工作区文件，也可以运行终端命令。因此，它不仅能给出建议，还能直接参与项目开发和测试执行流程。
1. 安装与配置
1.1 安装智能体
- 在 CukeTest 中，点击左侧活动栏的 扩展 图标。
- 在扩展列表中找到 CukeTest 智能体。
点击 安装。
如果扩展列表中没有显示 CukeTest 智能体，请联系产品支持人员获取安装包或启用方式。
1.2 配置 API 信息
智能体依赖大语言模型（LLM）运行。使用前，需要配置兼容 OpenAI 接口格式的 API 信息。
- 在扩展列表中，点击 CukeTest 智能体 进入详情页。
点击 设置 图标。
填写以下关键配置：
- Openai Api Key: 大模型服务的 API 密钥。
- Openai Base Url: API 服务地址。
Model: 使用的模型名称。
配置完成后，建议先发起一个简单问题，确认模型能够正常响应。
2. 启动智能体
使用前，需要先启动智能体，使其能够访问当前工作区。
- 点击活动栏中的 CukeTest 智能体 图标。
- 在 智能体 面板中，点击 启动智能体。
- 启动成功后，底部输入框会变为可输入状态。
3. 基本用法
3.1 提交任务
在输入框中直接描述您的目标，例如：
- 阅读当前自动化测试脚本，并给出改进建议。
- 根据这个功能说明生成 BDD 测试用例。
- 重构这个步骤定义文件，提高可维护性。
- 检查项目中的失败用例，并分析可能原因。
当智能体开始执行任务时，聊天窗口会实时展示执行动态，方便您跟踪进度：
- 实时状态与耗时：在消息卡片上方显示任务的状态（如“正在思考”、“正在执行”）及累计处理时长。
- 工作详情（展开查看）：点击消息卡片中的“展开”可查看详细的工作流：
- 推理思考：智能体分析任务意图、规划方案的逻辑过程。
- 工具执行：记录了智能体执行的具体操作，如
read_file（读取文件）、run_shell_command（运行命令）等。 - 交互请求：展示任务执行中发起的提问或操作确认请求。
- 任务进度 (Plan)：复杂任务会自动开启“计划”模式，通过步骤清单展示整体执行路径及当前所处阶段。
- 完成输出：任务处理结束后，智能体将提供最终的结构化建议、代码变更说明或操作总结。
3.2 使用斜杠命令
在输入框中输入 / 可以打开快捷命令菜单。内置命令包括：
/explore:web：执行网页自动化探索，并生成对应测试用例。/explore:qt：执行 Qt 桌面应用自动化探索，并生成对应测试用例。
3.3 引用工作区文件
当任务需要针对特定文件处理时，可以使用 @ 引用工作区文件。
- 触发引用：在输入框中输入
@符号。 - 搜索文件：输入框上方将弹出文件建议列表。您可以继续输入文件名的一部分进行模糊搜索，缩小范围。
- 完成选择：点击列表项，或使用方向键选中后按回车。被选中的文件将以标签（Pill）的形式显示在输入框内。
添加文件引用后，智能体将获得该文件的上下文，从而能够提供更精准的回答。
3.4 回答交互式提问
处理复杂任务时，智能体可能需要进一步确认目标、框架、执行范围或测试对象。此时，它会在聊天窗口中发起交互式提问。
- 选择式表单：智能体会展示一个包含选项的卡片，您可以直接点击选项来提供所需信息。
- 多步确认：如果有多个问题，卡片上方会显示当前进度，例如
1 / 2，您可以通过导航按钮查看或修改之前的选择。 - 继续或忽略：确认信息后点击 继续，不需要回答时可点击 忽略。
交互式提问可以减少来回沟通，使智能体在执行前获得更准确的上下文。
3.5 查看任务计划
对于多步骤任务，智能体会自动生成任务计划。任务计划用于展示当前目标被拆解后的执行路径。
- 自动拆解：将较大的目标拆分为可执行的子任务。
- 状态跟踪：显示每个步骤的状态，例如待处理、进行中或已完成。
- 过程透明：即使任务涉及多个文件或多次命令执行，也可以清楚看到当前进展。
3.6 管理会话
- 新建会话：点击聊天面板右上角的 + 图标。新任务建议使用新会话，避免旧上下文干扰。
- 查看历史：点击聊天面板右上角的 历史 图标，可以找回之前的对话。
4. 权限与文件变更
4.1 设置执行权限
智能体读取或修改文件、运行终端命令时，可能需要执行权限。您可以在聊天框底部切换权限模式。
- 默认权限：智能体在执行文件读写或命令运行前，会请求确认。
- 完全访问权限：智能体无需逐次确认，可自动执行需要的文件操作和命令。
Warning
安全提示： 只有在您信任当前模型、任务目标明确，并且工作区环境安全时，才建议启用 完全访问权限。如果项目中包含敏感文件、生产配置或高风险脚本，建议使用默认权限并逐项确认操作。
4.2 预览文件变更
当智能体修改文件后，聊天流中会显示 File Changes 卡片。
- 点击文件名，可以进入 Diff 视图 查看修改内容。
- 鼠标悬停在文件名上，点击右侧图标可直接在编辑器中打开该文件。
- 确认修改符合预期后，文件通常已经自动保存到磁盘。
建议在接受智能体修改后执行必要的验证，例如运行测试、检查报告或重新打开相关页面确认结果。
5. 使用建议
- 任务描述越具体，结果越稳定。建议说明目标文件、期望输出、测试框架和限制条件。
- 对复杂任务，优先让智能体先分析并给出计划，再执行文件修改。
- 涉及批量修改或命令执行时，先查看权限提示和任务计划。
- 修改完成后，使用 Diff 视图检查变更，并运行相关测试验证结果。