使用智能体

CukeTest 智能体（CTAgent）是可以在 CukeTest 中使用的 AI 智能体插件。它专为软件测试场景设计，能够理解测试需求，帮助您在同一界面内完成测试探索、用例设计、自动化脚本生成、代码优化以及工程管理任务。

与传统的 AI 聊天机器人不同，CukeTest 智能体具备读写工作区文件和运行终端命令的能力，可以直接参与到您的开发与测试流程中。

一、安装与配置

1.1 安装智能体

1. 在 CukeTest 中，点击左侧活动栏的 扩展 图标。
2. 在列表中找到 CukeTest智能体，点击 安装。

如果没有在扩展列表中列出，可能需要联系我们单独获取。

1.2 配置 API 信息

智能体依赖大语言模型（LLM）驱动，您需要配置 OpenAI 兼容的 API 信息。

1. 在扩展列表中，点击 CukeTest智能体 进入详情页。

2. 点击 设置 图标（齿轮）。

3. 填写以下关键配置：

   • Openai Api Key: 填入您的 API 密钥。
   • Openai Base Url: API 代理地址。
   • Model: 指定使用的模型名称。

二、启动与连接

使用前需启动智能体进程，确保它能够与您的工作区通信：

1. 点击活动栏中的 CukeTest 智能体 图标。
2. 在“智能体”面板中，点击界面中的 [启动智能体] 按钮。
3. 连接成功后，底部的输入框将变为激活状态。

三、基本用法

3.1 会话管理

• 新建会话：点击聊天面板右上角的 + 图标。开启新话题可以避免旧上下文的干扰。
• 查看历史：点击面板右上角的 时钟图标，可快速找回之前的对话。

3.2 交互与执行过程

输入您的需求（如：“阅读这个自动化测试脚本，并提供改进建议”），智能体会展示其执行过程：

1. 已处理时长：在界面顶部显示任务的累计耗时（如“已处理 1m 9s”）。
2. 思考与工具调用：智能体在处理任务时，会展示其实时推理逻辑。点击“思考用时...”可展开查看：
   • 思考内容：智能体对当前步骤的任务意图说明。
   • 工具调用：智能体为了完成任务而执行的具体操作（如 read_file 读取文件、run_shell_command 运行终端命令等）。
3. 执行计划 (Plan)：对于复杂任务，智能体会将任务分解为多个步骤（如：扫描文件 -> 写入代码 -> 验证运行）。
4. 最终输出：处理完成后，智能体将提供结构化的回复结果（如“代码审查结果”）。

3.3 斜杠命令

在输入框输入 / 触发命令快捷菜单：

• /explore:web：执行网页自动化任务并生成对应测试用例。

四、权限与文件变更

4.1 设置执行权限

当智能体需要读取敏感文件或运行终端命令时，通常会先请求您的批准。

您可以在聊天框底部点击并快速切换执行权限：

• 🛡️ 默认权限：智能体在执行读写文件或运行命令前，会逐一请求您的确认。
• ⚠️ 完全访问权限：智能体无需询问即可全自动执行所有推理过程。

4.2 预览文件变更

当智能体修改代码后，聊天流中会展示 File Changes 卡片。

• 点击文件名即可进入 Diff 视图。
• 鼠标悬停在文件名上时，点击右侧出现的图标可直接在编辑器中打开该文件。
• 确认无误后，文件通常已经自动保存到磁盘。