AI 功能

gocron 内置了一套 AI 能力,全部基于你自己配置的 OpenAI 兼容大模型(云端或本地皆可),包括:自然语言转 cron、失败日志诊断、AI 运维助手对话,以及 MCP 协议集成。

前置:配置大模型

进入 系统管理 → AI 配置,填写并启用:

字段	说明
启用	打开后 AI 功能才可用
Base URL	OpenAI 兼容接口地址,如 `https://api.openai.com/v1`、或本地 `http://localhost:8000/v1`
API Key	访问密钥,仅保存在服务端,绝不回传前端
模型	模型名称,如 `gpt-4o`、`qwen2.5` 等

支持任意 OpenAI 兼容的端点:云端 API,或本地模型服务(Ollama、vLLM、LM Studio、MLX 等)。本地模型可实现完全离线的 AI 能力。

提示:带"思考(reasoning)"的模型在多步任务上较慢,属正常现象;对话面板会实时显示思考过程,并可随时停止。

自然语言转 Cron

新建 / 编辑任务时,可以用自然语言描述执行时机(例如"每天早上 9 点半""工作日每小时"),AI 会生成 gocron 的 6 字段秒级 cron 表达式并给出执行时间预览,确认后填入。

失败日志 AI 诊断

任务执行失败后,在 任务日志 中点击「诊断」,AI 会根据任务配置与失败输出,给出:

根本原因(一句话)
可操作的修复建议

AI 运维助手(对话)

点击右上角的机器人图标,打开对话面板,用自然语言询问运维问题:

"最近哪些任务失败了?" / "任务 X 为什么失败?" / "我有哪些任务模板?"
流式输出,并实时展示模型的思考过程
AI 会自动调用只读工具查询真实数据(任务、执行日志、节点、模板),基于结果作答,不臆造
触发任务执行(run_task)需要你点击确认,且会记录审计——AI 不会自动执行任务
支持 Markdown 渲染、消息复制、面板宽度拖拽、随时停止
思考与回答跟随你的界面语言

MCP 集成

gocron 内置 MCP(Model Context Protocol) server,可供外部 MCP 客户端(如 Claude Desktop)直接接入,把 gocron 作为工具来管理任务。

端点:https://<你的地址>/mcp
在 系统管理 → MCP 密钥 创建访问令牌(令牌只在创建时完整显示一次,请妥善保存)
客户端配置示例:

json

{
  "mcpServers": {
    "gocron": {
      "url": "https://<你的地址>/mcp",
      "headers": {
        "Authorization": "Bearer <你的 MCP 令牌>"
      }
    }
  }
}

可用工具:

工具	说明
`list_tasks`	列出任务(可按名称/标签/状态过滤)
`get_task`	查看单个任务详情
`query_task_logs`	查询执行日志(可按任务/状态/关键字/时间范围过滤)
`list_hosts`	列出执行节点
`list_templates`	列出任务模板
`diagnose_task_log`	对失败日志做归因诊断
`run_task`	立即执行任务(需要管理员令牌)

安全:run_task 是唯一的"写"操作,需管理员令牌;其余均为只读。建议通过 TLS(HTTPS)暴露 /mcp 端点。

AI 功能 ​

前置:配置大模型 ​

自然语言转 Cron ​

失败日志 AI 诊断 ​

AI 运维助手(对话) ​