cli

Prefect CLI 技能是唯读 MCP 服务器的核心辅助工具，为您的 Prefect Cloud 或 OSS 工作空间提供执行变更与生命周期管理任务的接口。此技能专为 AI 代理工作流程设计，能对部署、流程执行与自动化策略进行程序化控制。适用于 DevOps 工程师、数据平台团队以及需要执行写入操作或修复任务的自动化代理程序，特别是在观察与分析不足以解决问题时使用。

• 通过 flow-name/deployment-name 模式或特定 UUID 触发部署。

• 使用非交互式标记（non-interactive flags）管理流程执行的生命周期，包含取消与删除。

• 使用结构化 JSON 配置来建立与更新自动化策略。

• 与 Prefect API 接口以进行进阶过滤、资源检查与状态管理。

• 通过标准 Shell 命令执行支持批次作业与自动化错误处理。

• 执行所有 CLI 指令时务必使用 --no-prompt 标记，以确保与非交互式代理的兼容性，防止操作被阻断。

• 应先使用唯读 MCP 服务器中的 get_flow_runs 或 get_deployments 工具获取完整 UUID，因为这些标识符对于变更操作是必须的。

• 优先使用 prefect api 指令配合 --data 输入，以获得精确控制与原始 JSON 输出，确保结果可供后续机器读取与处理。

• 避免依赖 Rich table 输出，因终端格式化可能截断关键 ID；建议尽可能通过 jq 进行管线处理。

• 执行指令前，请确保您的环境已通过 ~/.prefect/profiles.toml 或相关环境变量（如 PREFECT_API_URL 与 PREFECT_API_KEY）完成验证。

• 此技能作为唯读诊断工具的写入侧伙伴，能实现从观察失败执行到自动取消或重新触发的完整反馈闭环。