智能体循环

什么是智能体循环？

YeePilot 的标准模式遵循一个简单的模式：您提问，AI 提议一个命令，您批准，它执行。智能体循环则更进一步。它允许 AI 通过读取文件、执行命令、分析输出和决定下一步操作来处理复杂的多步骤任务 -- 同时在每个命令执行时都保持您的审批权。

可以将其理解为：一次给一个指令与描述一个目标让对方自行规划步骤之间的区别。

启用智能体循环

有两种方式激活智能体模式：

使用斜杠命令

在聊天中输入 /think 来为当前会话启用扩展思考：

> /think
Agent mode enabled (thinking: on)

您还可以指定思考强度：

> /think high
Agent mode enabled (thinking: high)

使用配置

要默认启用智能体模式，请在配置文件（~/.yeepilot/config.yaml）中设置：

ai:
  agent_mode: true

工作原理

当您在智能体模式下描述一个复杂任务时，YeePilot 遵循以下循环：

1. 分析 -- AI 拆解您的请求并确定第一步
2. 提议 -- 为当前步骤生成一个或多个命令
3. 审批 -- 您审查并批准（或拒绝）提议的命令
4. 执行 -- 批准的命令运行并捕获输出
5. 评估 -- AI 读取输出，判断目标是否达成，并决定下一步
6. 重复 -- 步骤 2-5 重复直到任务完成或达到迭代限制

AI 每个任务最多可执行 25 次迭代。此限制可防止失控循环并保持费用可预测。

示例：诊断慢速服务器

> The application at port 8080 is responding slowly. Diagnose the issue.

在智能体模式下，YeePilot 可能按以下顺序工作：

1. 检查进程是否运行及其资源使用情况（ps, top）
2. 检查最近的应用日志中的错误
3. 检查系统资源（CPU、内存、磁盘、I/O）
4. 查看网络连接和套接字状态
5. 审查最近的系统变更或部署
6. 总结发现并建议修复方案

在每一步，您都能看到提议的命令，批准它们，并在 AI 进入下一步之前查看结果。

扩展思考模式

/think 命令接受一个模式参数，控制 AI 在生成命令之前进行多少推理：

较高的思考模式每步使用更多 Token，但产生更彻底的分析。对于日常任务，low 或默认的 on 通常足够。对于诊断疑难问题，high 给 AI 更多空间来考虑各种可能性。

AI 在智能体模式下的能力

在智能体循环中，AI 可以使用多种工具：

执行命令

主要工具。AI 提议 shell 命令供您批准和执行。每个命令仍然经过风险验证并需要您的确认。

读取文件

AI 可以读取系统上的文件以获取上下文。例如，在建议更改之前读取配置文件，或检查日志文件以了解错误。

Reading /etc/nginx/nginx.conf ...
 
Based on the configuration, the worker_processes is set to 1.
Given this server has 8 CPU cores, I recommend increasing it.
 
Plan:
  1. sed -i 's/worker_processes 1/worker_processes 8/' /etc/nginx/nginx.conf
 
Execute? [Y/n]

列出文件

AI 可以列出目录内容以了解项目结构、查找相关文件或验证预期文件是否存在。

搜索

AI 可以搜索文件内容中的特定模式，帮助它定位配置值、错误消息或代码引用。

保持控制

智能体模式不会绕过任何安全机制：

• **每个命令都需要您的批准。**AI 未经您按 Enter 就无法执行任何操作。
• **风险分类仍然适用。**DANGEROUS 命令会被标记。BLOCKED 命令会被拒绝。
• **您可以随时停止。**按 Ctrl+C 或输入 "stop" 来结束智能体循环并返回标准模式。
• 25 次迭代限制防止无限循环。如果 AI 在 25 步内未完成任务，它会停止并总结其进展。

何时使用智能体模式

智能体模式对以下场景最有价值：

• 诊断工作流，下一步取决于上一步的输出
• 多服务设置，需要按顺序配置多个组件
• 故障排除，根本原因未知且需要调查
• 系统审计，检查服务器配置的多个方面

对于简单的单命令任务（"show me disk usage"），标准模式更快更高效。

智能体模式使用技巧

• 明确您的目标。"Set up a reverse proxy for the app on port 3000 with SSL via Let's Encrypt" 给 AI 一个清晰的工作目标。
• **大多数任务从 /think medium 开始。**如果 AI 似乎遗漏了重要考虑因素，可以升级到 high。
• **关注 Token 使用量。**智能体模式比单步模式消耗更多 Token。使用 Ctrl+S 检查使用情况。
• 让 AI 完成分析后再用新指令打断。如果在循环中途改变方向，AI 会丢失调查线索。