- 新增 OpenAI-compatible LLM client,支持 base_url、api_key、model 配置 - 固化意图识别、参数抽取、部署计划生成的结构化 JSON 提示词 - 增加 MCP client 配置读取和真实 session 接入说明 - 实现 checkpoint 自动保存、resume 断点续跑和已完成步骤跳过 - 实现人工确认流程,支持失败 IP 回滚 approve/reject - 新增 chat 常驻式 CLI 对话框,支持自然语言分析、参数设置、执行确认、状态查看、回滚确认和续跑 - 同步 README,补充 LLM、MCP、checkpoint、confirm/resume、chat 使用方式 - 增加相关单元测试,覆盖 LLM client、MCP 配置、确认/续跑和交互式 CLI
104 lines
3.3 KiB
Python
104 lines
3.3 KiB
Python
"""Shared dataclasses for the PAM deploy agent."""
|
|
|
|
from __future__ import annotations
|
|
|
|
from dataclasses import dataclass, field
|
|
from typing import Any, Literal
|
|
|
|
BackendName = Literal["mcp", "script", "fake"]
|
|
ExecutionStrategy = Literal["hybrid_node_mcp", "script_only", "fake"]
|
|
IntentName = Literal["deploy", "show_usage", "preview", "query_node_ips", "rollback"]
|
|
ModePreference = Literal["MCP", "API脚本", "未指定"]
|
|
StrategyPreference = Literal["hybrid_node_mcp", "script_only", "fake", "未指定"]
|
|
|
|
|
|
@dataclass(slots=True)
|
|
class ActionResult:
|
|
action: str
|
|
backend: BackendName
|
|
ok: bool
|
|
values: dict[str, Any] = field(default_factory=dict)
|
|
exit_code: int = 0
|
|
tool_name: str = ""
|
|
stdout: str = ""
|
|
stderr: str = ""
|
|
raw_output: str = ""
|
|
error_summary: str = ""
|
|
|
|
|
|
@dataclass(slots=True)
|
|
class SkillPolicy:
|
|
name: str
|
|
source_path: str
|
|
description: str = ""
|
|
allowed_modes: tuple[str, ...] = ("MCP", "API脚本")
|
|
allowed_actions: tuple[str, ...] = ()
|
|
required_confirmations: tuple[str, ...] = (
|
|
"params",
|
|
"target_scope",
|
|
"rollback",
|
|
)
|
|
required_params: tuple[str, ...] = ()
|
|
optional_params: dict[str, Any] = field(default_factory=dict)
|
|
action_sequence: tuple[str, ...] = ()
|
|
ip_action_sequence: tuple[str, ...] = ()
|
|
forbidden_actions: tuple[str, ...] = (
|
|
"script-main-flow",
|
|
"auto-rollback",
|
|
"modify-deploy-scripts",
|
|
)
|
|
|
|
|
|
@dataclass(slots=True)
|
|
class LlmIntentResult:
|
|
intent: IntentName
|
|
mode_preference: ModePreference = "未指定"
|
|
strategy_preference: StrategyPreference = "未指定"
|
|
confidence: float = 0.0
|
|
reasons: list[str] = field(default_factory=list)
|
|
needs_clarification: bool = False
|
|
clarification_questions: list[str] = field(default_factory=list)
|
|
|
|
|
|
@dataclass(slots=True)
|
|
class LlmParamResult:
|
|
extracted_params: dict[str, Any] = field(default_factory=dict)
|
|
extracted_control: dict[str, Any] = field(default_factory=dict)
|
|
missing_required_params: list[str] = field(default_factory=list)
|
|
ambiguous_fields: list[str] = field(default_factory=list)
|
|
sensitive_fields_present: list[str] = field(default_factory=list)
|
|
|
|
|
|
@dataclass(slots=True)
|
|
class LlmDeployPlan:
|
|
summary: str
|
|
risk_notes: list[str] = field(default_factory=list)
|
|
planned_actions: list[str] = field(default_factory=list)
|
|
requires_confirmation: bool = True
|
|
execution_strategy: StrategyPreference = "未指定"
|
|
|
|
|
|
@dataclass(slots=True)
|
|
class AgentState:
|
|
run_id: str
|
|
params: dict[str, Any]
|
|
execution_strategy: ExecutionStrategy
|
|
action_backends: dict[str, BackendName]
|
|
script_entry: str = ""
|
|
script_base_dir: str = "."
|
|
config_path: str = ""
|
|
trace_file_path: str = ""
|
|
node_mcp_server_name: str = ""
|
|
node_mcp_tool_names: dict[str, str] = field(default_factory=dict)
|
|
completed_global_steps: list[str] = field(default_factory=list)
|
|
hash_code: str = ""
|
|
node_url: str = ""
|
|
online_ips: list[str] = field(default_factory=list)
|
|
target_ips: list[str] = field(default_factory=list)
|
|
ip_states: dict[str, dict[str, Any]] = field(default_factory=dict)
|
|
pending_confirmation: str = ""
|
|
last_success_step: str = ""
|
|
last_failed_step: str = ""
|
|
checkpoint_path: str = ""
|
|
events: list[dict[str, Any]] = field(default_factory=list)
|