Aller au contenu principal

Piloter Proxmox VE en langage naturel avec un agent IA

Pour interroger ou piloter un cluster Proxmox VE en langage courant, ce template place un agent IA entre votre demande et l'API Proxmox. Vous écrivez dans un chat, et l'agent choisit la méthode HTTP et l'URL à appeler, puis renvoie une explication de la réponse. Il faut un jeton d'API Proxmox enregistré dans n8n et une clé Google Gemini. Les notes indiquent que le modèle peut être remplacé par Ollama, OpenAI ou Claude.

Déclencheur
Message de chat
Taille
27 nœuds
Outils
Requêtes HTTP (API), Google Gemini, Telegram, Gmail, Agent IA

Comment fonctionne ce workflow

  1. 1

    Un Chat Trigger reçoit votre demande rédigée en langage courant.

  2. 2

    L'agent IA, alimenté par Google Gemini, s'appuie sur la documentation de l'API Proxmox fournie dans ses ressources pour choisir l'appel à faire.

  3. 3

    Le Structured Output Parser et l'Auto-fixing Output Parser fixent la structure de la sortie pour que l'URL et la méthode soient exploitables.

  4. 4

    Le nœud HTTP Request envoie l'appel à l'API Proxmox avec l'en-tête Authorization enregistré dans vos identifiants.

  5. 5

    Les nœuds Switch, If, Merge et Code assurent l'aiguillage et la mise en forme entre les étapes.

  6. 6

    Un second agent IA transforme la réponse brute de Proxmox en explication lisible.

Quand l'utiliser

  • Demander l'état des machines virtuelles d'un nœud sans ouvrir l'interface Proxmox.
  • Démarrer une VM ou lancer une sauvegarde depuis une conversation Telegram.
  • Traduire une demande de modification de configuration reçue par e-mail en appel PUT.

À préparer avant l'import

  • Un jeton d'API Proxmox créé dans le Datacenter, avec son identifiant et sa valeur secrète
  • Des identifiants de type Header Auth dans n8n, avec pour nom Authorization
  • Une clé d'API Google Gemini configurée dans n8n
  • Un compte Telegram ou Gmail si vous utilisez ces déclencheurs
  • Un Chat Trigger ou un autre déclencheur selon l'entrée que vous voulez utiliser

Bon à savoir

Commencez avec un jeton d'API aux droits limités, car l'agent peut envoyer des requêtes DELETE et PUT qui suppriment ou modifient des ressources. Testez d'abord des requêtes GET pour vérifier la chaîne complète.

Installer ce template dans n8n

  1. Téléchargez le fichier JSON avec le bouton en haut de la page.
  2. Dans n8n, ouvrez le menu d'un workflow vide, choisissez « Import from File » et sélectionnez le fichier.
  3. Reliez vos propres identifiants à chaque nœud qui en demande un, lancez un test, puis activez le workflow.

Ce template fonctionne sur n8n auto-hébergé comme sur n8n Cloud. Les nœuds IA demandent une version récente de n8n.

Vous voulez ce workflow branché sur vos outils ?

Ce template est un point de départ. Nous l'adaptons à vos règles, à vos comptes et à votre hébergement, puis nous le maintenons.

Voir notre accompagnement n8n