Hermes Agent VOLLSTÄNDIGER LEITFADEN: Verleihen Sie Hermes ein Unternehmensgehirn für die Zusammenarbeit mit Ihrem Team

Dieser Artikel wurde verfasst von [@chriskim_dev](https://x.com/@chriskim_dev) *

KI-Agenten sind großartig, wenn sie für eine Person arbeiten. Sie werden noch viel interessanter, wenn sie mit deinem gesamten Team zusammenarbeiten können.

Diese Anleitung ist eine schrittweise Entwickler-Tutorial, um genau das zu erreichen: ein „Unternehmensgehirn“ aufzubauen, das @NousResearch Hermes Agent mit den gemeinsamen Dateien, Kommentaren, Versionen und dem Kontext verbindet, mit dem dein Team bereits in @Box arbeitet. Am Ende hast du eine funktionierende Implementierung, bei der Hermes nicht mehr nur ein persönlicher Assistent ist, sondern ein Teammitglied, das aus derselben Quelle der Wahrheit wie alle anderen arbeitet.

Damit dieses Tutorial fokussiert bleibt, gehe ich davon aus, dass du bereits etwas Erfahrung mit der Einrichtung des Hermes Agent Gateway auf einem VPS hast, sodass dein Agent rund um die Uhr verfügbar ist. Eine detaillierte Einrichtungsanleitung findest du in der Hermes Entwicklerdokumentation. Wir verwenden einen DigitalOcean-Droplet, um unsere Hermes-Instanz zu hosten, aber das gleiche Schema funktioniert bei jedem VPS-Anbieter.

Sieh dir zuerst die Demo an

Bevor wir es bauen, sieh dir den Workflow in Aktion an!

https://x.com/chriskim_dev/status/2066898496842846557

Das Problem: KI-Agenten sind immer noch zu isoliert

Wenn du in einem Marketing-, Content-, Produkt- oder kundenorientierten Team arbeitest, kommt dir diese Geschichte wahrscheinlich bekannt vor. Du arbeitest an einem Unternehmensproduktvideo. Jemand wirft ein ZIP in einen Slack-Thread, ein Teammitglied fragt, welche Assets darin enthalten sind, weitere Versionen häufen sich (video_project_v2_FINAL.zip, final_final_revised.mov, launch_copy_v3.txt), Feedback geht unter und jemand bearbeitet die falsche Version.

Dann kommt ein KI-Agent ins Spiel und macht es noch schlimmer, indem er selbstbewusst aus seiner eigenen lokalen Kopie des Projekts arbeitet. Tools wie Hermes sind leistungsstark für die individuelle Produktivität, aber die Übergaben zwischen Agent und Mensch sowie zwischen Agenten scheitern, weil alle – Menschen und Maschinen – aus unterschiedlichen Kontexten arbeiten.

Die Lösung: Gib deinen Agenten denselben gemeinsamen Arbeitsbereich, den dein Team bereits verwendet – eine einzige Quelle der Wahrheit, auf die alle zurückgreifen. Hier kommt Box ins Spiel.

Was du bauen wirst

Am Ende dieser Anleitung wirst du Folgendes haben:

• Hermes Agent läuft auf einem VPS mit Slack als Gateway
• Box CLI auf demselben Server installiert
• Eine Box-App mit Client Credentials Grant (CCG)-Authentifizierung
• Ein dediziertes Box-Dienstkonto für Hermes
• Einen gemeinsamen Projektordner, der zum Arbeitsbereich für Menschen und Agenten wird
• Ein wiederholbares Muster für agentische Workflows, bei denen Hermes in Box hochladen, lesen, analysieren und organisieren kann

Die entscheidende Designentscheidung hier ist, Hermes nicht mit deinem persönlichen Box-Benutzerkonto in der Box CLI zu authentifizieren. Stattdessen erstellen wir eine Box-App mit Client Credentials Grant (CCG), die deinem Agenten eine eigene Service-Identität in Box gibt.

Was ist ein Dienstkonto?

Ein Dienstkonto ist eine dedizierte Identität für eine Anwendung oder Automatisierung. Wenn Hermes dein persönliches Konto verwendet, kann es auf alles zugreifen, was du kannst – das ist in Ordnung für lokale Experimente, aber das falsche Modell für Team- oder kundenorientierte Workflows. Mit einem Dienstkonto erhält Hermes eine eigene Box-Identität, und du teilst nur die Ordner, die es benötigt. Das schafft eine klare Sicherheitsgrenze: Hermes handelt als Hermes und sieht nur das, was du mit ihm geteilt hast.

Eine Box CCG-App ist die Methode, um diese serverseitige Identität zu erstellen. CCG ermöglicht deiner App die Authentifizierung ohne interaktiven Benutzer-Login. Du erstellst eine App in der Box Developer Console, autorisierst sie in der Admin Console und verwendest ihre Client-ID, ihr Client-Secret und ihre Enterprise-ID, um dich von deinem Server aus zu authentifizieren. Du erfährst weiter unten, wie du die App erstellst. Für weitere Details lies die Box-Dokumentation zu Client Credentials Grant.

Voraussetzungen

Du benötigst:

• Ein kostenloses Box-Entwicklerkonto
• Ein DigitalOcean-Konto (oder einen anderen VPS-Anbieter)
• Einen Slack-Workspace, in dem du Apps erstellen und installieren kannst
• Hermes Agent mit einem konfigurierten Modell-Anbieter
• Grundlegende Terminalkenntnisse

Melde dich zunächst für ein kostenloses Box-Entwicklerkonto an. Nach der Anmeldung wirst du zur Box Developer Console weitergeleitet, wo du die CCG-App erstellst, die Hermes seine Service-Identität gibt.

Schritt 1: Erstelle einen DigitalOcean Droplet

Für dieses Tutorial verwenden wir einen DigitalOcean Droplet als VPS. DigitalOcean hat eine vollständige Anleitung zum Erstellen eines Droplets.

Für eine Entwicklungsdemo reicht ein kleiner Ubuntu Droplet:

• Ubuntu 24.04
• 1 vCPU
• 2 GB RAM
• SSH-Key-Authentifizierung
• Überwachung aktiviert

Sobald der Droplet erstellt ist, verbinde dich per SSH:

1ssh root@YOUR_DROPLET_IP

Aktualisiere die Pakete und installiere die Grundlagen:

1apt update
2apt upgrade -y
3apt install -y curl git unzip jq build-essential nodejs npm

Schritt 2: Installiere Hermes Agent

Installiere Hermes Agent auf dem Droplet, indem du der offiziellen Hermes-Dokumentation folgst.

Überprüfe nach der Installation, ob es funktioniert:

1hermes --version

Führe dann die Einrichtung aus:

1hermes setup

Wähle den gewünschten KI-Modell-Anbieter aus und folge den Aufforderungen. Hermes unterstützt verschiedene Modell-Anbieter, daher werde ich keinen vorgeben (jeder größere Anbieter funktioniert). Wichtig ist, dass Hermes erfolgreich läuft, bevor wir es mit Slack und Box verbinden.

Überprüfe kurz, ob Hermes richtig eingerichtet ist:

1hermes

Sende dann „Hello“, um zu sehen, ob Hermes antwortet. Eine funktionierende Einrichtung antwortet im Terminal. Wenn du keine Antwort erhältst, führe hermes setup erneut aus und bestätige, dass dein Modell-Anbieter-Schlüssel konfiguriert ist.

Schritt 3: Erstelle die Slack-App und richte das Hermes-Gateway ein

Hermes Gateway ermöglicht es deinem Agenten, in Messaging-Plattformen wie Slack zu laufen. Lass uns Slack als Messaging-Plattform für unseren Hermes-Agenten einrichten. Lies die detaillierte Slack-Einrichtungsanleitung in der Hermes-Entwicklerdokumentation. Am Ende solltest du Folgendes haben: ein Slack-Bot-Token, ein Slack-App-Token, die Slack-App ist in deinem Workspace installiert und das Gateway ist konfiguriert.

Hinweis: Da Hermes auf einem VPS läuft, installiere Hermes Gateway bei Aufforderung als Systemdienst. So startet es beim Booten und läuft weiter, nachdem du dein Terminal geschlossen hast.

Überprüfe den Dienst mit:

1systemctl status hermes-gateway

Nützliche Befehle:

1systemctl restart hermes-gateway          # Gateway neustarten
2journalctl -u hermes-gateway -f            # Logs des Gateways live anzeigen
3journalctl -u hermes-gateway -n 100 --no-pager   # Die letzten 100 Logzeilen anzeigen

Sobald die Slack-App installiert und als dein Hermes-Gateway konfiguriert ist, starte Hermes auf dem VPS neu:

1systemctl restart hermes-gateway

Teste es in Slack, indem du eine Nachricht mit [@Hermes](https://x.com/@Hermes) sendest:

1@Hermes hello

Schritt 4: Installiere die Box CLI

Jetzt, da dein Hermes-Agent in Slack funktioniert, verbinden wir ihn mit Box über Box CLI. Box CLI macht Box im Wesentlichen vollständig kopflos, und du ermöglichst deinem Hermes-Agenten, alle Box-Operationen wie das Lesen von Dateien, Erstellen/Hochladen von Dateien und Verwalten von Inhalten auf Box über CLI-Befehle durchzuführen.

Installiere die Box CLI auf dem VPS (über das Terminal, mit dem du dich remote mit dem VPS verbunden hast):

1npm install --global @box/cli

Überprüfe:

1box --version

Großartig! Box CLI ist auf deinem VPS installiert. Wir werden uns später damit authentifizieren. Weitere Informationen findest du in der Box CLI-Dokumentation.

Schritt 5: Erstelle eine Box CCG-App

Gehe zur Box Developer Console und erstelle eine neue App mit Client Credentials Grant. Diese App ist die Service-Identität, die im Namen deines Hermes-Agenten handelt.

Sobald sie erstellt ist, findest du in der Seitenleiste App Details auf der rechten Seite diese Anmeldeinformationen:

• clientID
• clientSecret
• enterpriseID

Erstelle nun eine Konfigurationsdatei auf deinem VPS:

1nano /root/box-ccg-config.json

Füge Folgendes ein:

1{
2  "boxAppSettings": {
3    "clientID": "YOUR_CLIENT_ID",
4    "clientSecret": "YOUR_CLIENT_SECRET"
5  },
6  "enterpriseID": "YOUR_ENTERPRISE_ID"
7}

Speichern und beenden:

1Ctrl+O or Cmd+O
2Enter
3Ctrl+X or Cmd+X

Jetzt konfigurieren wir die Box CLI-Umgebung, um unsere CCG-App zur Authentifizierung zu verwenden. Dadurch kann sich Hermes mit der CCG-App bei der Box CLI anmelden und nicht mit einem persönlichen Benutzerkonto.

Füge die Umgebung zur Box CLI hinzu:

1box configure:environments:add /root/box-ccg-config.json --ccg-auth --name service

Setze sie als aktuell:

1box configure:environments:set-current service

Überprüfe die Service-Identität:

1box users:get

Du solltest einen Automatisierungsbenutzer sehen, nicht deinen persönlichen Benutzer. Es könnte etwa so aussehen:

1Name: my-app
2Login: [email protected]

Das ist die Identität, die dein Hermes-Agent in Box verwenden wird. Wenn du deinem Hermes-Agenten nun sagst, er solle Box-Operationen durchführen, kann Hermes die Box CLI dazu verwenden.

Schritt 6: Gib einen Projektordner für das Dienstkonto frei

Erstelle einen Ordner in Box für dein Projekt – zum Beispiel „Product Launch Video Project“.

Gehe zur Seite der erstellten CCG-App in der Box Developer Console und kopiere die E-Mail des Automatisierungsbenutzers aus der Seitenleiste App Details.

Teile nun diesen Ordner mit dem Automatisierungsbenutzer aus dem vorherigen Schritt.

Dies ist die entscheidende Sicherheitsgrenze. Hermes benötigt keinen Zugriff auf dein gesamtes Konto; es benötigt nur Zugriff auf diesen Projektordner.

Überprüfen wir, ob die eingeschränkte Zugriffseinrichtung funktioniert! Frage deinen Hermes-Agenten in Slack:

1@Hermes Can you check what folders and files you see on the root level?

Wenn du nur den zuvor erstellten Projektordner siehst, können wir loslegen!

Herzlichen Glückwunsch! Box ist jetzt bereit, als das Unternehmensgehirn für deinen Hermes-Agenten zu fungieren. Verwende diesen Ordner als deine einzige Quelle der Wahrheit und lass Hermes daraus Kontext für die Aufgaben ziehen, die du ihm gibst.

Lass Hermes die Box CLI erlernen

Hier ist einer meiner Lieblingsteile von Hermes: seine Selbstverbesserungsschleife. Du musst nicht jeden Box CLI-Befehl perfekt von Hand erstellen. Gib Hermes stattdessen eine Aufgabe und lass es lernen.

Zum Beispiel in Slack:

1@Hermes use the Box CLI to figure out who you are authenticated as, then list the files in the shared project folder.

Versuche dann:

1@Hermes create a reusable skill for common Box CLI operations like listing folders, uploading files, downloading files, and checking the current service account.

In der Videodemo hat Hermes herausgefunden, wie man effizient mit der Box CLI arbeitet und sich eine eigene wiederverwendbare box-cli-Fähigkeit erstellt. Ich habe diese Fähigkeit nicht zuerst erstellt. Hermes hat aus der Umgebung gelernt und sein zukünftiges Verhalten verbessert.

Du kannst es trotzdem mit einer kurzen Anweisung anleiten:

• Verwende immer die Box CLI-Service-Umgebung.
• Arbeite nur innerhalb des genehmigten Projektordners.
• Frage, bevor du Inhalte löschst oder überschreibst.
• Bewahre nach Möglichkeit die Versionshistorie auf.
• Behandle Box als die dauerhafte Quelle der Wahrheit.

Bitte Hermes, die Box CLI zu verwenden, beobachte, wo es Schwierigkeiten hat, korrigiere es und lass es einen besseren Workflow für das nächste Mal erstellen.

Wo dies wirklich glänzt: reale Anwendungen, bei denen Teams das gemeinsame Gehirn nutzen

Meine Demo zeigte die Zusammenarbeit an einem Videostart, aber sobald Hermes und dein Team dieselbe Quelle der Wahrheit in Box teilen, kannst du es für jede Arbeit verwenden, bei der Menschen und Agenten auf dem gleichen Stand bleiben müssen. Hier sind ein paar Szenarien, um Ideen zu wecken. Probiere sie aus und erfinde dann deine eigenen!

Content- & Marketing-Zusammenarbeit (dein Videostart, aufgewertet). Dein Editor legt den finalen Schnitt in Box ab, ein Autor hinterlässt Feedback als Kommentar, und Hermes nimmt es auf, ohne dass jemand das Projekt neu erklären muss:

1@Hermes the V2 cut is approved — generate captions, a YouTube description, and 3 thumbnail concepts, then save them in the launch folder.

Ein zweiter Agent auf dem Rechner eines Teammitglieds kann später denselben Ordner abrufen, um die Beiträge zu planen. Niemand fragt jemals wieder „Welche Datei ist die finale?“

Produktstart-Koordination. PM, Design und Marketing rennen alle auf dasselbe Datum zu. Anstatt eines Startdokuments, das veraltet, sobald es geschrieben ist, lass Hermes es live aus dem gemeinsamen Arbeitsbereich zusammenstellen:

1@Hermes read the spec, the latest mockups, and the QA notes in the Launch folder, then draft a go/no-go checklist and a one-page launch brief.

Wenn sich die Spezifikation ändert, führe es erneut aus – das Gehirn liest immer die aktuelle Wahrheit, nicht die Kopie von letzter Woche.

Engineering-Arbeit. Richte Hermes auf die Repository-Exporte, Designdokumente und Incident-Notizen in Box aus, sodass das gesamte Team aus einem Kontext arbeitet:

1@Hermes summarize the open issues and the design doc in the Auth-Service folder, then draft release notes for the v3.2 deploy.

Neue Ingenieure einarbeiten? Sie (und ihr Agent) lesen denselben Ordner wie das Senior-Team – kein stilles Wissen, das in DMs gefangen ist.

Persönliche Nebenprojekte. Auch solo zahlt sich die Einrichtung aus – dein „Team“ besteht nur aus dir auf einem Laptop, einem Telefon und ein paar Agenten:

1@Hermes here are my workout logs and recipes for the month — build me a meal-and-training plan and drop it in my Side Projects folder.

Starte die Idee auf deinem Telefon, beende sie auf deinem Laptop und lass einen anderen Agenten sie morgen aufgreifen.

Rechtliches & Vertragsarbeit. Legal lebt und stirbt mit der Versionskontrolle, daher ist eine einzige Quelle der Wahrheit hier ein Geschenk:

1@Hermes compare the redlined V2 of the vendor MSA against V1, list every changed clause, and flag anything that touches liability or termination.

Der Rechtsberater kommentiert direkt die Datei in Box; Hermes (und der Agent jedes Prüfers) zieht immer die neueste signierte Version, nicht eine verirrte E-Mail-Anlage.

Der rote Faden, der sich durch alle diese Beispiele zieht, ist der, auf den du hingearbeitet hast:

Verschiedene Teams. Verschiedene Agenten. Verschiedene Schnittstellen. Derselbe gemeinsame Arbeitsbereich.

Wähle das Szenario aus, das am nächsten an deiner Welt ist, und führe es heute aus. Dann werde kreativ! Der beste Anwendungsfall ist fast immer der, den du entdeckst, sobald die Reibung verschwunden ist. Viel Spaß damit und teile in den Kommentaren, was du gebaut hast!