Prefect Workflows 技能介绍
用途
本技能用于使用 Prefect MCP 工具检查和排查 Prefect 工作流、部署、工作池与版本发布。Prefect MCP 工具是 Prefect 状态、文档和版本发布说明的权威来源，返回带有完整标识符的结构化数据；除非某个工具明确说明，否则这些操作是只读的。
选择工作区
托管 MCP 服务使用 Prefect Cloud OAuth 进行身份验证。如果某个工具需要 workspace_id，而用户尚未选择工作区：
- 调用 list_authorized_workspaces。
- 当只有一个可用工作区时，自动使用它。
- 当有多个可用时，根据明确的对话上下文选择，或询问用户指的是哪个工作区。
- 在后续工具调用中一致地传入所选 workspace_id。
切勿猜测工作区 ID，也不要从不相关的结果中复制工作区 ID。
诊断运维问题
从宽泛开始，仅在需要时收窄：
- 使用 get_dashboard 获取近期失败、延迟、部署和工作池健康状况的概览。
- 使用 get_flow_runs 检查受影响的运行，并保留其完整 UUID。
- 使用 get_deployments、get_work_pools、get_task_runs 或 read_events 查看该运行牵涉的具体层级。
- 解释证据，区分已观察到的失败与可能原因，并建议范围最小的下一步检查或操作。
当已知具体 ID 时，不要反复获取宽泛列表。
文档与发布说明
使用 Prefect 文档工具获取当前的 CLI、SDK、部署和发布信息。对于版本问题，搜索当前的结构化发布说明，并报告来源返回的确切版本和发布日期。
当文档工具可用时，不要凭记忆回答对版本敏感的问题。
变更操作与 Prefect CLI
托管的 Prefect MCP 接口是只读的。除非某个已暴露的工具实际执行了该操作，否则不要声称它触发、取消、创建、更新或删除了任何内容。
本地 Prefect CLI 是另一条独立的高级路径。仅当以下条件全部为真时才使用它：
- 当前客户端可以执行本地 shell 命令；
- prefect version 成功；
- 本地 Prefect 配置文件已通过身份验证，指向目标工作区；
- 用户明确请求该变更操作。
否则，应说明所连接的 MCP 工具是只读的，并提供用户可自行运行的确切 CLI 命令，而不要假装该命令已执行。
当已配置的本地 CLI 适用时：
- 优先使用从 MCP 结果获取的完整 UUID；
- 对原本会提示交互的命令使用 prefect --no-prompt；
- 需要机器可读输出时优先使用 prefect api 或 -o json；
- 切勿使用渲染表格中被截断的标识符。
常用命令：
prefect deployment run 'flow-name/deployment-name' prefect --no-prompt flow-run cancel <flow-run-uuid> prefect automation create --from-file automation.yaml