Rauto Usage
Execute rauto operations directly for users whenever possible.
Do not default to tutorial-style answers.
Core Mode
Prefer action-first behavior:
- 1. Parse user goal and classify it as read-only or config-changing.
- For read-only operations, run the relevant
rauto command immediately. - For config-changing operations, prefer
tx/tx-workflow/orchestrate with rollback-aware planning. - If commands are generated by the agent, ask for human confirmation before execution.
- Return key results (not raw noise), plus command used.
Execution Rules
- 1. For read/query requests, execute immediately:
- examples:
device list,
connection list,
history list,
templates list,
replay --list.
- 2. For config-changing requests, prefer rollback-capable execution:
- single block:
tx
- multi-step/multi-resource:
tx-workflow
- multi-device staged rollout:
orchestrate
- 3. For generated change commands, do not execute immediately:
- show planned command(s), rollback strategy, and require user confirmation.
- 4. For explicit read-only commands (for example
show), tx/workflow is not required. - Resolve connection in this priority:
- explicit command args >
--connection <name> > ask for missing fields.
- 6. Do not ask the user to manually run commands if agent can run them.
- Summarize outputs with important fields:
- target, mode, success/failure, key errors, next action.
Risk Guardrails
Require explicit user confirmation before destructive actions:
- - INLINECODE14
- profile/template/connection delete operations
- tx/workflow execution that changes config when user intent is ambiguous
Additional safety requirements for config changes:
- - Prefer
tx/tx-workflow/orchestrate with rollback-aware planning over direct apply patterns. - Run/offer
--dry-run first for workflow-based changes. - For
orchestrate, review target scope, fail_fast, concurrency, and rollback boundary before execution. - Never auto-run agent-generated change commands without confirmation.
- Include rollback path in the proposal before execution.
If user explicitly asks to execute destructive action, proceed.
Missing Input Strategy
Ask only for missing must-have fields:
- - For
exec/template/tx/tx-workflow/orchestrate/connection test:
- need either full host credentials or usable
--connection.
- need record file path or JSONL source.
- need connection name.
Response Format
When command is executed, report:
- 1.
Operation: what was run - INLINECODE25 : exact rauto command
- INLINECODE26 : key output summary
- INLINECODE27 : risk, errors, or follow-up actions
Navigation (Load References On Demand)
- - Agent execution decision tree and command templates: INLINECODE28
- Full CLI command cookbook: INLINECODE29
- Runnable multi-device orchestration JSON templates (EN): INLINECODE30
- Multi-device orchestration pre-flight review: INLINECODE31
- Runtime storage paths: INLINECODE32
- Troubleshooting and recovery: INLINECODE33
- End-to-end operation scenarios: INLINECODE34
- English Q/A examples: INLINECODE35
- Runnable workflow JSON templates (EN): INLINECODE36
- Web tab/card mapping (only when user asks for Web operations): INLINECODE37
Rauto 使用指南
尽可能直接为用户执行rauto操作。
不要默认采用教程式回答。
核心模式
优先采用行动优先的行为方式:
- 1. 解析用户目标,并将其分类为只读操作或配置变更操作。
- 对于只读操作,立即执行相关的rauto命令。
- 对于配置变更操作,优先使用tx/tx-workflow/orchestrate并制定回滚感知计划。
- 如果命令由代理生成,在执行前需请求人工确认。
- 返回关键结果(而非原始噪音),以及所使用的命令。
执行规则
- 1. 对于读取/查询请求,立即执行:
- 示例:device list、connection list、history list、templates list、replay --list。
- 2. 对于配置变更请求,优先使用支持回滚的执行方式:
- 单个块:tx
- 多步骤/多资源:tx-workflow
- 多设备分阶段部署:orchestrate
- 3. 对于生成的变更命令,不要立即执行:
- 展示计划命令、回滚策略,并要求用户确认。
- 4. 对于明确的只读命令(例如show),不需要使用tx/workflow。
- 按以下优先级解析连接:
- 明确的命令参数 > --connection <名称> > 询问缺失字段。
- 6. 如果代理可以运行命令,不要要求用户手动运行。
- 使用重要字段总结输出:
- 目标、模式、成功/失败、关键错误、下一步操作。
风险防护措施
在执行破坏性操作前,需要明确的用户确认:
- - rauto backup restore ... --replace
- 配置文件/模板/连接的删除操作
- 当用户意图不明确时,执行会更改配置的tx/workflow
配置变更的额外安全要求:
- - 优先使用tx/tx-workflow/orchestrate并制定回滚感知计划,而非直接应用模式。
- 对于基于工作流的变更,先运行/提供--dry-run。
- 对于orchestrate,在执行前审查目标范围、fail_fast、并发性和回滚边界。
- 未经确认,切勿自动运行代理生成的变更命令。
- 在执行前的提案中包含回滚路径。
如果用户明确要求执行破坏性操作,则继续执行。
缺失输入策略
仅询问缺失的必填字段:
- - 对于exec/template/tx/tx-workflow/orchestrate/connection test:
- 需要完整的主机凭据或可用的--connection。
- 需要记录文件路径或JSONL源。
- 需要连接名称。
响应格式
当命令执行后,报告:
- 1. 操作:执行了什么
- 命令:确切的rauto命令
- 结果:关键输出摘要
- 备注:风险、错误或后续操作
导航(按需加载参考文档)
- - 代理执行决策树和命令模板:references/agent-execution.md
- 完整CLI命令手册:references/cli.md
- 可运行的多设备编排JSON模板(英文):references/orchestration-json-template.md
- 多设备编排预检检查:references/orchestration-risk-check.md
- 运行时存储路径:references/paths.md
- 故障排除与恢复:references/troubleshooting.md
- 端到端操作场景:references/scenarios.md
- 英文问答示例:references/examples.md
- 可运行的工作流JSON模板(英文):references/workflow-json-template.md
- Web标签/卡片映射(仅当用户询问Web操作时):references/web.md