跳到主要内容

子代理

功能概述：子代理是心流AI CLI的智能代理系统，根据任务类型自动选择最合适的专业代理处理请求。

学习时间：10-15分钟

前置要求：已安装心流AI CLI，了解基本的斜杠命令使用

什么是子代理​

子代理是心流AI CLI中的智能分工系统，类似于拥有一个专业团队，每个成员都有自己的专长领域。系统能够根据不同的任务类型自动选择最合适的专业代理来处理您的请求，确保每个任务都能得到最专业的处理。

核心特点​

特点说明优势
专业化分工每个子代理针对特定领域优化提高任务处理质量
工具访问控制不同代理访问不同工具集合安全性和效率兼顾
智能调度根据任务描述自动选择代理用户无需手动选择
模型验证自动验证模型兼容性确保最佳性能表现
动态扩展支持自定义和第三方代理满足个性化需求

工作原理​

任务分析与代理选择​

用户请求 → 任务分析 → 代理匹配 → 工具授权 → 任务执行
    ↓
[描述内容] → [领域识别] → [最佳代理] → [工具集合] → [专业处理]

代理类型分类​

  • 开发类代理：代码审查、前端开发、后端开发、测试等
  • 分析类代理：数据分析、性能分析、安全分析等
  • 创作类代理：文档编写、内容创作、翻译等
  • 运维类代理：部署管理、监控报警、故障诊断等

详细功能说明​

代理管理​

查看可用代理​

命令功能说明
/agents show列出本地代理显示已安装的代理列表
/agents show desc详细描述显示代理的详细功能说明
/agents online在线市场浏览可安装的代理
/agents refresh刷新代理从源文件重新加载代理配置

代理市场导航​

在线浏览操作

操作快捷键说明
向下浏览j 或 ↓移动到下一个选项
向上浏览k 或 ↑移动到上一个选项
返回上级h返回上级目录
进入选中项l 或 Enter查看详细信息或安装
退出浏览q退出浏览模式
刷新列表r重新加载代理列表
# 进入在线代理市场
/agents online

代理安装管理​

通过CLI命令安装

# 添加项目级别的代理
iflow agent add <agent-name-or-id> --scope project

# 添加用户级别的代理（全局作用域）
iflow agent add <agent-name-or-id> --scope global

# 实际示例
iflow agent add python-expert --scope project
iflow agent add code-reviewer --scope global

# 其他管理命令
iflow agent list              # 列出所有已配置的代理
iflow agent remove <name>     # 移除指定代理
iflow agent get <name>        # 查看代理详细信息
iflow agent online            # 浏览在线代理市场

重要提醒：使用第三方子代理时请谨慎选择！确保您信任要安装的代理配置，特别是那些可能访问敏感数据的代理。

注意：心流AI CLI会使用Task工具调用子代理

快速调用功能​

使用 $ 符号快速调用​

心流AI CLI支持使用 $ 符号快速调用子代理，类似于 @ 符号选择文件的方式：

基本语法

$<agent-type> <任务描述>

使用示例

$code-reviewer 对当前项目进行代码审查
$frontend-developer 创建一个响应式的导航组件
$python-expert 优化这个算法的性能
$data-scientist 分析这个数据集的趋势

快速调用特性​

特性说明优势
智能补全输入 $ 后显示可用代理列表快速选择合适代理
快速执行直接在当前对话中执行无需额外配置步骤
实时反馈显示代理执行状态和过程了解任务进展情况
可视化界面工具调用过程可视化展示提高用户体验
结果展示代理响应直接显示在对话中无缝集成到工作流

使用技巧​

  1. 快速选择：输入 $ 后使用方向键或鼠标选择代理类型
  2. 明确任务：提供清晰、具体的任务描述
  3. 上下文感知：代理会自动获取当前项目的上下文信息
  4. 工具权限：代理根据其配置获得相应的工具访问权限

预置代理类型​

内置代理​

代理类型功能描述适用场景
general-purpose通用代理复杂的多步骤任务

扩展代理​

更丰富的代理可以通过心流AI在线市场进行快速安装，包括：

  • 代码审查专家：专门用于代码质量检查
  • 前端开发专家：专注于前端技术和UI开发
  • 数据分析专家：处理数据分析和可视化任务
  • 文档编写专家：专业的技术文档创作

使用示例​

常见使用场景​

代码审查​

$code-reviewer 请对当前项目进行全面的代码审查，关注代码质量和最佳实践

前端开发​

$frontend-developer 创建一个响应式的用户登录组件，支持表单验证

数据分析​

$data-scientist 分析sales_data.csv中的销售趋势，生成可视化图表

文档编写​

$doc-writer 为这个API端点编写详细的技术文档和使用示例

代理协作场景​

多个代理可以在同一个项目中协作工作：

# 首先进行代码审查
$code-reviewer 检查当前代码的安全性问题

# 然后优化性能
$performance-expert 基于审查结果优化代码性能

# 最后生成文档
$doc-writer 为优化后的代码生成完整文档

智能模型管理​

自动模型验证​

功能说明优势
兼容性检测执行前自动检查模型支持情况避免执行错误
智能推荐推荐最佳替代模型保证任务质量
用户选择提供模型选择对话框保持用户控制权
偏好记忆记住用户的模型选择偏好简化后续操作

模型切换模式​

交互模式（默认）

  • 显示模型选择对话框
  • 用户可以从可用模型列表中选择替代模型
  • 支持"一次性"和"永久记住"两种选择

YOLO模式

  • 自动使用推荐的替代模型
  • 显示警告信息说明模型切换情况
  • 无需用户干预，快速执行

自定义代理配置​

配置文件管理​

在项目的 .iflow/agents/ 目录中创建自定义代理配置：

---
agentType: "custom-expert"
systemPrompt: "你是一个自定义领域的专家..."
whenToUse: "当需要处理特定领域任务时使用"
model: "claude-3-5-sonnet-20241022"
allowedTools: ["*"]
proactive: false
---

# Custom Expert Agent

这是一个自定义专家代理的详细说明...

配置属性说明​

必需属性​

属性类型说明
agentType字符串代理的唯一标识符
systemPrompt字符串代理的系统提示词
whenToUse字符串何时使用此代理的说明

可选属性​

属性类型说明默认值
model字符串偏好的AI模型-
allowedTools数组可使用的工具列表[]
proactive布尔值是否主动推荐使用false
color字符串UI中的显示颜色-
name字符串显示名称agentType
description字符串简短描述-

故障排除​

常见问题及解决方案​

问题可能原因解决方案
代理不响应模型不兼容或网络问题检查模型设置，确认网络连接
工具权限错误allowedTools配置错误检查代理配置中的工具权限设置
代理列表为空配置文件路径错误确认.iflow/agents/目录存在且有配置文件
快速调用失败代理类型不存在使用/agents show查看可用代理
模型切换失败目标模型不可用选择其他可用模型或检查配置

诊断步骤​

  1. 基础检查

    /agents show              # 查看已安装的代理
    /agents refresh           # 刷新代理配置

  2. 配置验证

    • 检查.iflow/agents/目录是否存在
    • 验证配置文件格式是否正确
    • 确认代理类型命名规范

  3. 权限验证

    • 检查工具访问权限设置
    • 验证模型访问权限
    • 确认网络连接状态

  4. 日志检查

    /log                      # 查看详细日志
    /stats                    # 查看使用统计

平台兼容性​

平台支持程度特殊说明
Windows完全支持配置文件路径使用反斜杠
macOS完全支持可能需要文件系统权限
Linux完全支持依赖系统包管理器

下一步​