智能体
Introduction
智能体（Agent）是你面向不同开发场景的编程助手。CodeSouler 提供内置智能体。同时，你还可以创建自定义智能体，通过灵活配置提示词和工具集，使其更高效地帮你完成复杂任务。
智能体的能力
- 自主运行 - 独立探索你的代码库，识别相关文件并进行必要修改。
- 完整的工具访问权限 - 使用所有可用工具进行搜索、编辑、创建文件及运行终端命令。
- 上下文理解 - 建立对你项目的结构和依赖关系的全面理解。
- 多步骤规划 - 将复杂任务拆分为可执行的步骤，并按顺序逐一处理。
智能体的工作流
- 需求分析：深入理解任务目标及代码库上下文，明确需求要点。
- 代码调研：检索代码库、文档及网络资源，定位相关文件并分析现有实现逻辑。
- 方案设计：根据分析结果拆解任务步骤，并动态优化调整修改策略。
- 实施变更：照计划在整个代码库中进行必要的代码变更，过程中可能涉及：
- 新增依赖库推荐
- 需执行的终端指令
- CodeSouler 外的手动操作指引
- 交付验收：完成验证后移交控制权，同步汇总所有修改内容。
内置智能体
CodeSouler 提供以下内置智能体：
- Ask: Ask可以帮你快速的熟悉项目，回答开发相关的问题。根据你的需求，Ask会调用不同的工具，包括分析代码文件的工具、网络搜索工具等等，从而更加精确且有效地处理你的需求。
- Code: Code可以帮助你从 0 到 1 开发一个完整的项目。根据你的需求，Code 会调用不同的工具，包括分析代码文件的工具、编辑代码文件的工具、运行命令的工具等等，从而更加精确且有效地处理你的需求。
- Plan: Plan可以给你的任务制定一个完整的计划。
创建自定义智能体
- 打开 CodeSouler 设置页面，进入
Settings>Agents模块 - 点击
Create Agent按钮，你将前往以下智能体配置面板。
- 配置智能体
| 配置项 | 说明 |
|---|---|
| Name | 输入智能体的名称。 |
| Role Definition | 输入智能体的角色定义，用于定义智能体的专业领域及角色特性。 |
| Short description | 输入智能体的简介，用于描述智能体的用途。 |
| Tools | 配置智能体处理需求时可以调用的工具，包括：
|
- 点击
Create Agent按钮。
使用智能体
在 AI 对话输入框中，点击 智能体、，然后在智能体列表中选择你想使用的智能体。
修改/删除智能体
你可以按需管理自定义智能体，包括：
- 修改自定义智能体的配置。
- 删除自定义智能体。
在自定义智能体列表中，点击 Edit Agent、Delete Agent 图标完成所需操作。
推荐使用的模型
为了获得最佳的使用体验，我们强烈推荐您在使用Agent模式时选择以下模型：
- DeepSeek-V3
- Claude 3.7 Sonnet
- Claude 4 Sonnet
使用步骤
1. 切换到Code模式
- 在聊天输入框中，切换到Code模式。
2. 输入任务需求描述
- 用清晰、简洁的语言描述您希望AI助手完成的任务。
- 例如："将所有旧的日期格式转换为新的日期格式"，"添加一个新的函数来处理用户登录"。
3. 梳理任务执行计划
- AI助手会根据您的需求，自动梳理出一个详细的任务执行计划。
- 您可以在这一步查看AI助手的规划，确保它理解了您的意图。
4.自动进行代码读取和变更
- 在您确认执行计划后，AI助手会自动读取您的代码，并进行必要的修改。
5. 处理代码变更
- 你可以选择接受或拒绝代码变更，点击输入框上方待审查文件列表中的 Accept All 或 Reject All 按钮，批量接受或拒绝当前项目中的所有代码变更。
回退版本
你可以将项目回退到指定会话轮次发起前的版本。
注意：回退操作不可撤销。
使用以下步骤回退项目的版本：
- 找到目标对话。
- 点击左侧的 Revert 按钮。
对话框中展示本次回退会影响的文件数，编辑器内会打开本次会话文件变更。
- 确认本次回退的影响范围。
- 若本次回退符合预期，点击 Confirm。
智能体开始回退项目。
重要提示
- 为了确保AI助手能够准确理解您的需求，请尽可能提供详细、清晰的任务描述。