Plattform Self-hosted Agents

Self-hosted AI Agents

Ein Agent kann auf Hardware laufen, die Ihnen gehört: auf einem Ubuntu-Server, als Container auf Ihrem Docker-Host oder als Pod in Ihrem Cluster. Es ist derselbe Agent, den Kadmo sonst betreibt, und er erreicht die App über eine einzige Verbindung, die er selbst öffnet.

Auf dieser Seite 8 Abschnitte

Wann Sie einen Agenten selbst betreiben

Betreiben Sie ihn selbst, wenn die Maschine Ihre sein soll: Ihre Hardware, Ihr Betriebssystem, Ihre Netzregeln und Ihre Wartung. Die Checkouts und der Desktop, an denen der Agent arbeitet, bleiben auf dieser Maschine, innerhalb Ihres Perimeters, und die App erreicht sie trotzdem ohne eingehenden Port.

Jede Maschine, jeder Container und jeder Pod betreibt einen Agenten, und ein Docker-Host oder ein Cluster kann mehrere davon nebeneinander tragen. Eines bleibt bei Ihnen: Die App kann eine Maschine, die ihr nicht gehört, weder neu starten noch stoppen noch starten.

Ubuntu, Docker oder Kubernetes

Es ist ein Agent, auf drei Arten verpackt. Auf einer eigens dafür bestimmten Ubuntu-Maschine legt der Installer einen Benutzer agent, eine Desktop-Sitzung, Chrome und die Hintergrunddienste an. Das Image kadmoai/kadmo-agent startet Ubuntu mit systemd als erstem Prozess und führt beim ersten Boot denselben Installer aus. Das Chart kadmo-agent-chart betreibt das Image als einen Pod pro Helm-Release, sodass ein Namespace mehrere Agenten aufnehmen kann.

Container und Pods laufen privilegiert, weil systemd zuerst startet und der Agent ein eigenes Docker betreibt. Einmal installiert, bekommt ein Self-hosted Agent dasselbe Self Update und dieselben Komponenten wie einer bei Kadmo.

Eine ausgehende Verbindung

Die Maschine baut jede Verbindung selbst auf. Ihr Agent Channel ist ein WebSocket über HTTPS zur App, der das eigene Token des Agenten trägt, und die App schickt Jobs, Zustandsabfragen, den Live-Desktop und Vorschauen über ihn zurück. Jeder Agent hält einen Channel, und ein neuerer übernimmt vom älteren. Die App hält den Channel am Leben und trennt einen, der verstummt, aber sie wählt die Maschine nie an, und weder ein UDP-Port noch ein VPN ist im Spiel.

Die Maschine öffnet die eine Verbindung zur App; die Arbeit kommt über sie zurück, und nichts wählt sich ein.

Innerhalb Ihres Perimeters heißt nicht, dass nichts ihn verlässt. Die Modellaufrufe des Agenten gehen an den Anbieter, den seine Agent App nennt, und seine Arbeit erreicht Ihre Git-Hosts und Paket-Registries, über Verbindungen, die ebenfalls die Maschine öffnet.

Vom Token zu Online

Wer im Assistenten Your own machine wählt, bekommt bei Launch ein Einmal-Token, das eine Stunde lang gilt, und je einen Befehl für Ubuntu, Docker und Kubernetes. Die Installation bringt Desktop, Chrome, Claude Code und die Kadmo-Runtime auf die Maschine und holt die Einrichtung des Agenten von der App und seine Software aus öffentlichen Paketquellen wie den Ubuntu-Mirrors und npm. Beim ersten Check-in tauscht die App das Token gegen das eigene des Agenten, und der Channel öffnet sich.

Das Panel nach Launch für einen Self-hosted Agenten in Kadmo: die Überschrift, dass er auf seine Maschine wartet, ein Einmal-Token mit Copy und Mint again, Tabs für Ubuntu, Docker und Kubernetes mit dem Installationsbefehl und eine Zeile Waiting. — Nach Launch: das Token, ein Befehl für jede Art, den Agenten zu betreiben, und die Zeile, die zu Online wird.

Die wartende Zeile in der App wird zu Online, und der Agent übernimmt sofort Arbeit, ohne Wartezeit für die Einrichtung. Bis zu diesem ersten Check-in sehen nur die Admins des Kontos, dem der Agent gehört, das Token-Panel, mit Mint again für ein frisches Token.

Was die App weiterhin tut

Die App schickt dem Agenten seine Arbeit, zeigt seinen Desktop live und hält seine Software aktuell, wie bei jedem Agenten. In der Flotte trägt er den Chip Self-hosted, und seine eigene Seite nennt Your machine als Anbieter und den Agent Channel als seine Adresse, mit der Uhrzeit, zu der sich der Channel geöffnet hat.

Die Karte eines Self-hosted Agenten in der Agent Fleet von Kadmo: Noether, online und frei, mit dem Chip Self-hosted, seinen Rollen und seinem Profil, seinem Live-Bildschirm auf dem Warenkorb eines Shops und Run Job, Queue und Jobs. — In der Flotte ist ein Self-hosted Agent eine Karte wie jede andere, markiert mit Self-hosted.

Reboot bleibt deaktiviert, es gibt kein Stop oder Start, und seine Seite bietet keinen SSH-Zugang. Re-install on another machine zieht den Agenten mit einem frischen Token auf neue Hardware um, mit seinem Namen und seiner Geschichte. Destroy widerruft das Token und schließt den Channel, und die Software auf der Maschine bleibt dort, bis Sie sie entfernen.

Fragen

Braucht unsere Firewall eine eingehende Regel?

Nein. Die Maschine öffnet jede Verbindung selbst über ausgehendes HTTPS, und nichts in Ihrem Netz muss eine annehmen.

Können sich mehrere Agenten einen Host teilen?

Ja, mit Docker oder Kubernetes, jeder Agent in einem eigenen Container oder Pod. Auf Ubuntu betreibt eine Maschine einen Agenten.

Was passiert auf der Maschine, wenn wir den Agenten löschen?

Dort nichts. Die App widerruft das Token des Agenten und schließt seine Verbindung, und die Software bleibt auf der Maschine, bis Sie sie entfernen.

Bekommen Self-hosted Agents dieselben Updates?

Ja. Self Update und der Komponentenlauf wirken bei ihnen wie bei jedem Agenten, und ein neues Image-Tag ändert nichts an einem Agenten, der schon läuft.

Einrichten

Der Guide zum Self-Hosting behandelt Ubuntu, Docker, Kubernetes, das Netzwerk und den Agent Channel.