由 Gemini 智能体在聊天里控制的 Proxmox 服务器

由 Gemini 智能体在聊天里控制的 Proxmox 服务器

一个带聊天窗口的 n8n 工作流。你描述想在 Proxmox 集群上做的事，比如列出某个节点上的虚拟机，或启动其中一台。Gemini 智能体把请求变成一次 Proxmox API 调用，带上方法、路径和请求体。工作流用你的 API 令牌运行这次调用，第二个智能体再用平白的话解释结果。

里面有什么

• workflow.json：n8n 导出的工作流，24 个节点，另有 7 张便签。里面没有任何凭据。
• README.md：这份说明。

我们对原始副本做了哪些改动

Mindket 把这份副本清理并修好了：

• 有三个触发器节点哪里也没接：Telegram、Gmail 和一个 webhook。它们在工作流发布前都会要求一个凭据，所以 Mindket 把它们删了。一张便签仍然说，任何触发器都可以给智能体供数据。
• 一张便签里有一个捐赠链接和个人联系方式。Mindket 的副本把它去掉了。
• 原始副本里有别人自己的 Proxmox 地址：一个公网主机和几个内网主机。它们现在是 <YOUR_PROXMOX_HOST>、<YOUR_PROXMOX_HOST_2> 和 <YOUR_PROXMOX_HOST_3>，另外有一个请求节点原来调用的主机和其余的不同，现在调用同一个。
• GET 分支从 output.properties.url.pattern 读路径，而智能体的回答里没有这个字段。提示和输出示例把它放在 url 里，其他分支也是这样读的，所以 Mindket 的副本在这里和在总结智能体的文本里都读 output.url。
• 三个聊天模型写的是 models/gemini-2.0-flash-exp。Google 的弃用页面（2026 年 11 月 12 日查看）说 gemini-2.0-flash 系列已于 2026 年 6 月 1 日停用，并指定 gemini-3.6-flash 为替代。页面没有列出带 exp 的名字。Mindket 的副本用 models/gemini-3.6-flash。
• 里面没有任何凭据。

开始之前

• 一个 n8n 实例，n8n Cloud 或你自己的服务器都行，要能通过 8006 端口访问你的 Proxmox。
• 一个 Proxmox API 令牌。只能读的令牌是最稳妥的起点。
• 一个 Google Gemini API 密钥，用于 Google Gemini (PaLM) API 凭据。

设置步骤

1. 在 n8n 里新建一个工作流，打开它的菜单，选 Import from File，选中 workflow.json。
2. 在 Proxmox 里创建一个 API 令牌。在 n8n 里添加一个 Header Auth 凭据，名称填 Authorization，值填
   PVEAPIToken=user@pam!tokenname=<token-secret>，换成你自己的用户、登录类型和令牌名。
3. 在 Proxmox、HTTP Request、HTTP Request1、HTTP Request2、HTTP Request3 和 HTTP Request4 里选中这个凭据。
4. 在这六个节点里，把 <YOUR_PROXMOX_HOST> 换成你的某个节点的地址。
5. 在 AI Agent 的提示和 Proxmox 的描述里，把三个主机占位符换成你自己的地址，把 psb1、psb2 和 psb3 换成你的节点名。你没有的节点，就删掉对应的行。
6. 添加 Gemini 凭据，在 Google Gemini Chat Model、Google Gemini Chat Model1 和 Google Gemini Chat Model2 里选中它。
7. 保存，打开聊天，先问一件无害的事，比如列出某个节点上的虚拟机。

一次运行是怎么走的

1. When chat message received 在你发送消息时开始一次运行。
2. AI Agent 是 ReAct 类型的智能体，用 Google Gemini Chat Model。它能调用三个工具：Proxmox 读集群状态，Proxmox API Documentation 和 Proxmox API Wiki 读 Proxmox 网站上的两个页面。它用 JSON 回答，带 response_type、url 和 details。Structured Output Parser 定下这个形状，Auto-fixing Output Parser 请 Google Gemini Chat Model1 修正不合形状的回答。
3. Switch 按 response_type 分发请求：GET、POST、PUT、OPTIONS、DELETE 或 Invalid。
4. 对 GET，HTTP Request 调用这个路径。Structure Response 把每一项变成一行文字，AI Agent1（用 Google Gemini Chat Model2 的 Conversational 类型智能体）再用话讲出来。
5. 对 POST，If 检查回答里有没有 details。有的话，HTTP Request1 把它们作为请求体发出。没有的话，HTTP Request2 不带请求体发出。Merge 把两者合在一起。
6. 对 DELETE，If1 通向 HTTP Request3 或 HTTP Request4。两个都不带请求体发出 DELETE，Merge1 把它们合在一起。
7. Structgure Response from Proxmox 把 Proxmox 返回的任务 ID 拆成节点、操作、用户和时间。Format Response and Hide Sensitive Data 用它们写出一句话。

想改样子，改这里

• 智能体能做什么、怎么写调用：AI Agent 里的提示。
• 去掉删除：删掉 Switch 里的 DELETE 规则，或者它后面的节点。
• 输入：把聊天触发器换成别的触发器。提示读的是 {{ $json.chatInput }}。
• 总结的语气：AI Agent1 里的提示。
• 模型：三个 Gemini 节点。

要知道的

• 它会改动东西。POST 和 DELETE 调用会立刻运行，带着你令牌的权限，依据的是模型的理解。没有确认步骤，所以让它删一台虚拟机，它就会删。用权限窄的令牌，和一个你能重建的实验环境。
• 这五个 HTTP Request 节点打开了忽略 SSL 证书问题的选项，所以信任任何证书。这适合用自带证书的 Proxmox，但如果你的证书有效，就把它关掉。
• PUT、OPTIONS 和 Invalid 后面没有接任何东西，所以运行在没有调用、没有回答的情况下结束。智能体自己的示例里就有 PUT，比如调整磁盘大小，所以这类请求会丢失。
• n8n 把这里用到的 ReAct 和 Conversational 智能体类型标为已弃用，并说它们在 3 版中移除。较新的 AI Agent 节点会取代它们。
• 你的请求和 Proxmox 返回的内容（比如虚拟机名称和状态）会发给 Google 的 Gemini。
• 它在编辑器里的 n8n Chat 窗口运行。文件里没有任何东西会打开公开的聊天。
• 这个 JSON 里没有任何凭据。