4250a7b221
调整了 agent.py 和 LLM client 协议/实现。 现在只传当前 action 的结构化结果和必要诊断日志，避免历史运行态影响判断。 提示词和文档也已同步说明。 verify-ip 增加健康检查重试 默认 VERIFY_INTERVAL_SEC=10、VERIFY_MAX_ATTEMPTS=12，约 2 分钟。 verify-ip 未通过但未达到最大次数时，会播报进度、保存 checkpoint，并继续从当前 verify-ip 重试，不会进入 download-log。 参数已加入 config.txt.example、脚本配置读取、README、打包 README、Skill 文档和流程图。
102 lines
4.0 KiB
Python
102 lines
4.0 KiB
Python
"""用于 PAM 部署结构化理解和规划的 LLM 提示词。"""
|
||
|
||
SYSTEM_PROMPT = """你是 PAM 智能部署 Agent 的结构化理解与规划组件。
|
||
|
||
必须遵守：
|
||
- 只输出一个 JSON 对象，不输出 Markdown、解释文字或代码块。
|
||
- 不生成 shell、PowerShell、bat、curl 等可执行命令。
|
||
- 不回显密钥、token、CLIENT_SECRET、Authorization 等敏感值。
|
||
- 只能在允许的 action 集合中选择部署动作。
|
||
- 真实执行前必须保留人工确认点：参数确认、目标 IP 范围确认；失败后应暂停，修复后 resume 重试，回滚只能由用户显式触发。
|
||
"""
|
||
|
||
INTENT_PROMPT = """根据用户输入识别意图和执行偏好。
|
||
|
||
输出 JSON schema：
|
||
{
|
||
"intent": "deploy|show_usage|preview|query_node_ips|rollback",
|
||
"mode_preference": "MCP|API脚本|未指定",
|
||
"strategy_preference": "hybrid_node_mcp|script_only|fake|未指定",
|
||
"confidence": 0.0,
|
||
"reasons": ["..."],
|
||
"needs_clarification": false,
|
||
"clarification_questions": ["..."]
|
||
}
|
||
"""
|
||
|
||
PARAM_PROMPT = """从用户输入中抽取 PAM 部署参数和控制信息。
|
||
|
||
输出 JSON schema：
|
||
{
|
||
"extracted_params": {
|
||
"HOME_BASE_URL": "...",
|
||
"CLIENT_ID": "...",
|
||
"AIRPORT_CODE": "...",
|
||
"APP_NAME": "...",
|
||
"MODULE_NAME": "...",
|
||
"VERSION_NUMBER": "...",
|
||
"ZIP_FILE_PATH": "...",
|
||
"ACTION_TYPE": "...",
|
||
"TIMEOUT": "...",
|
||
"LOG_NAME": "...",
|
||
"POLL_INTERVAL_SEC": "...",
|
||
"DOWNLOAD_POLL_MAX_ATTEMPTS": "...",
|
||
"UPGRADE_POLL_MAX_ATTEMPTS": "...",
|
||
"VERIFY_INTERVAL_SEC": "...",
|
||
"VERIFY_MAX_ATTEMPTS": "..."
|
||
},
|
||
"extracted_control": {
|
||
"user_specified_ips": ["..."]
|
||
},
|
||
"missing_required_params": ["..."],
|
||
"ambiguous_fields": ["..."],
|
||
"sensitive_fields_present": ["..."]
|
||
}
|
||
|
||
不要输出或猜测 CLIENT_SECRET 的真实值；如果输入里出现敏感字段，只标记字段名。
|
||
"""
|
||
|
||
PLAN_PROMPT = """生成 PAM 部署计划。
|
||
|
||
输出 JSON schema：
|
||
{
|
||
"summary": "...",
|
||
"risk_notes": ["..."],
|
||
"planned_actions": ["get-token", "create-version"],
|
||
"requires_confirmation": true,
|
||
"execution_strategy": "hybrid_node_mcp|script_only|fake|未指定"
|
||
}
|
||
|
||
计划只能使用允许 action；不要包含可执行脚本命令、命令行参数或密钥。
|
||
PAM_HOME action 仍由脚本 action 执行；PAM_NODE action 在 hybrid_node_mcp 策略下走 MCP。
|
||
"""
|
||
|
||
ACTION_ANALYSIS_PROMPT = """分析一次 PAM action 执行结果。
|
||
|
||
输出 JSON schema：
|
||
{
|
||
"action": "...",
|
||
"has_anomaly": false,
|
||
"severity": "info|low|medium|high",
|
||
"possible_reason": "...",
|
||
"suggested_action": "...",
|
||
"requires_confirmation": false,
|
||
"should_continue": true,
|
||
"progress_complete": null,
|
||
"notes": ["..."]
|
||
}
|
||
|
||
要求：
|
||
- 必须明确给出 `should_continue`：没有问题时为 true；存在需要人工判断的问题时为 false。
|
||
- 如果 exit_code 非 0、ok=false、verify-ip SUCCESS=false、出现 legacy pending_confirmation，应标记异常。
|
||
- 对 `poll-download-progress`、`poll-upgrade-progress` 必须判断 `progress_complete`：已完成为 true；未完成但正常为 false；非进度 action 可为 null。
|
||
- 进度 action 未完成但正常时，`has_anomaly=false`、`should_continue=true`、`progress_complete=false`，建议继续查询进度。
|
||
- 进度 action 完成条件优先看 `STEP=DONE`、`STATUS=completed/done/success`、`SUCCESS=true`、`FINISH=true`，或 `MSG=success` 且 `RATE_OF_PROGRESS=100` 且 `CODE` 为空或 0。
|
||
- 进度 action 出现 `CODE` 非 0，或 `STEP/MSG/STATUS/MESSAGE` 含 fail/error，应标记异常并 `should_continue=false`。
|
||
- 主要依据结构化字段 `ok`、`exit_code`、`values`、`error_summary` 判断；不会提供完整运行态摘要，避免被历史状态误导。
|
||
- `verify-ip SUCCESS=false` 由 runtime 按配置重复检查；单次审核仍应说明当前健康检查未通过。
|
||
- 只有输入里存在 `diagnostic_log` 时，才把它当作异常诊断上下文。
|
||
- 脚本正常过程日志不会作为错误依据，不能因为日志来自 stderr 就判定异常。
|
||
- 不要输出密钥、token、Authorization 或完整日志原文。
|
||
"""
|