Quick Agent

Quick Agent 是默认入口 — 提问即答，一次完成。无多步推理，无子 agent。覆盖 80% 的日常网络查询。

功能声明

ID	声明	状态
C-NE-15	olav "R1 的 BGP 邻居？" 从快照数据返回查询结果	🔶 需设备环境
C-NE-16	黑名单命令被 execute_cli 拒绝执行	🔶 需设备环境
C-NE-17	/learn_cmd "show version" --device R1 执行命令并生成 TextFSM 模板	🔶 需设备环境
C-NE-18	take_snapshot 触发增量采集，生成新 snapshot_id	🔶 需设备环境
C-NE-19	Quick Agent 对复杂分析自动建议升级到 Ops Agent	⬜ 待验证

---

何时使用 Quick Agent

任务	Quick Agent	Ops Agent
"有多少 BGP 邻居断开？"	适合	杀鸡用牛刀
"显示 R2 接口"	适合	杀鸡用牛刀
"昨天以来有什么变化？"	可以	更好（用 Diff）
"模拟链路故障影响"	不行	适合（Analysis）
"部署测试实验室"	不行	适合（Lab）

Quick Agent 通过生成 SQL 查询快照数据库或执行单条 CLI 命令来处理简单查询。需要迭代、比较或模拟的问题会建议使用 Ops Agent。

---

查询示例

自然语言转 SQL

olav "R1 上的 BGP 邻居都建立了吗？"

OLAV 转换为：

SELECT neighbor_ip, neighbor_as, state
FROM v_bgp_neighbors_auto
WHERE device_name = 'R1' AND state != 'Established'

直接 SQL

olav "execute_sql: SELECT device_name, count(*) as cmd_count FROM netops.parsed_outputs GROUP BY 1"

CLI 执行

olav "在 R2 上执行 'show ip route'"

Agent 在白名单中查找命令，通过 SSH 连接执行并返回输出。黑名单命令在建立连接前即被拒绝。

---

快照采集

从 Quick Agent 触发按需快照：

olav "对 R1 和 R2 做一次快照"

对指定设备运行采集流水线，生成新的 snapshot_id。数据立即可查询。

---

学习新命令

当 show 命令没有 TextFSM 模板时，用 /learn_cmd 教会 OLAV：

olav --agent ops "/learn_cmd 'show ip bgp community' --device R1"

执行流程：

1. 通过 SSH 在设备上执行命令
2. 分析输出结构
3. 生成 TextFSM 模板
4. 保存到 workspace/ops/config/templates/custom/

模板立即可用于后续采集，无需重启（热重载）。

---

可用工具

Quick Agent 拥有以下工具（均从 ops/tools/ symlink）：

工具	用途
execute_cli	在设备上执行单条 CLI 命令
search_commands	按平台和关键词查找可用命令
diff_configs	比较两次快照间的设备配置
take_snapshot	触发按需采集

加上所有核心平台工具（execute_sql、format_and_export、recall_memory 等）自动继承。

---

升级建议

当 Quick Agent 判断问题需要多步分析时会提示：

"该问题需要跨时间比较多个数据源。建议使用 Ops Agent：olav --agent ops '你的问题'"

涉及模拟、漂移检测或多设备关联时会触发此建议。