用途:Prefect MCP 服务器为只读,本技能说明在需要执行变更时改用 Prefect CLI,例如触发部署、取消流运行、删除流运行或部署、创建自动化。
读操作建议优先用 MCP 工具(如 get_flow_runs、get_deployments),它们返回带完整 UUID 的结构化 JSON;仅当 MCP 未暴露所需能力时才用 prefect api。
面向智能体的非交互用法:CLI 默认面向交互式终端,非交互场景须把 --no-prompt 作为顶层标志以关闭确认,例如 prefect --no-prompt flow-run delete <uuid> 或 prefect --no-prompt deployment delete <name>。
避免输出被截断:Rich 表格会截断 ID 与名称。获取原始 JSON 可用 prefect api POST /flow_runs/filter --data '{"limit": 5}';查看单个资源可用 prefect flow-run inspect <uuid> -o json 或 prefect deployment inspect <name> -o json。
ID 必须是完整 UUID,部分 ID 无效,需从 JSON 输出中取得完整值,例如用 jq 提取 .id。
常见变更操作:触发部署 prefect deployment run 'flow-name/deployment-name',按 ID 触发加 --id <deployment-uuid>;取消流运行 prefect --no-prompt flow-run cancel <uuid>;删除流运行 prefect --no-prompt flow-run delete <uuid>;删除部署 prefect --no-prompt deployment delete <name>。
直接 API 访问:prefect api 提供完整 API 与 JSON 输出,可 POST /flow_runs/filter 带过滤条件,DELETE /flow_runs/<uuid>,或 POST /flow_runs/<uuid>/set_state 传入 {"state": {"type": "CANCELLING"}}。
创建自动化:可用 prefect automation create --from-json '<json>' 内联创建,或用 --from-file automation.yaml 从文件创建;可先用 MCP 的 get_automations() 查看现有自动化架构。高效检查:get_flow_runs 返回摘要以省 token,会省略完整部署与工作池架构;若看到 Late 运行或需并发细节,再调用 get_work_pools、get_deployments 或 get_dashboard。
限制:官方文本暂未提供;鉴权、版本要求、完整参数说明与错误处理等细节暂未提供。上述命令与用法均依据资料原文,未作扩展。