Claude Platform Docs
Managed AgentsSelbst gehostetes Managed Agents

Die Konsole auf deinem Server verwenden

Richte die Anmeldung für die Konsole auf deinem selbst gehosteten Claude Managed Agents-Server ein und erstelle anschließend Agenten und führe Sitzungen in einem Browser aus.

Die Konsole auf deinem Server ist eine Webseite, die ein selbst gehosteter Claude Managed Agents-Server unter derselben Adresse wie seine API bereitstellt. Darin erstellst du Agenten, führst Sitzungen aus und verwaltest Umgebungen, Credential-Vaults, Memory Stores und Skills, ganz ohne SDK oder CLI.

Es handelt sich nicht um die Claude Console unter platform.claude.com. Sie zeigt nur an, was sich auf deinem Server befindet.

Die Anmeldung einrichten

Ein Administrator richtet die Anmeldung einmalig ein. Um die Konsole stattdessen auf einem einzelnen Rechner auszuprobieren, folge Die Konsole auf deinem Server ausprobieren, wobei der „mock sign-in provider“ (Mock-Anmeldeanbieter) des Releases verwendet wird.

  1. Single Sign-on und die Terminal-Anmeldung einrichten

    Folge Single Sign-on, einschließlich Entwicklern die Anmeldung über ein Terminal ermöglichen. Die Konsole meldet Personen über die Anwendung an, die du für die Terminal-Anmeldung registriert hast. Sie prüft jedes Token gegen den ersten Eintrag von audiences im Issuer-Eintrag, also führe die Audience dieser Anwendung an erster Stelle auf.

  2. Die Konsole über HTTPS bereitstellen

    Setze einen Proxy, der TLS terminiert, vor Port 8400. TLS vor den Server setzen listet auf, was der Proxy leisten muss. Über reines HTTP funktioniert die Anmeldung nur unter localhost oder 127.0.0.1.

  3. Die Adresse der Konsole zur Anwendung hinzufügen

    Füge in deinem Identitätsanbieter die HTTPS-Adresse deines Servers als zweite Redirect-URI dieser Anwendung hinzu, mit abschließendem Schrägstrich: https://cma.example.com/. Erlaube außerdem ihren Origin, https://cma.example.com, für Cross-Origin-Anfragen (CORS).

Um die Einrichtung zu überprüfen, öffne die Konsole und melde dich an.

Die Konsole öffnen

Wenn deine Anwendungen https://cma.example.com aufrufen, öffne https://cma.example.com/ in einem Browser und klicke auf Continue with SSO.

Du meldest dich über deinen „identity provider“ (Identitätsanbieter) an. Die Konsole akzeptiert den API-Key des Servers nicht. Wenn die Konsole meldet, dass die Anmeldung auf diesem Server nicht eingerichtet ist, muss ein Administrator die Anmeldung einrichten.

Einen Agenten über die Konsole ausführen

Die integrierten Tools eines leeren Agenten, wie bash, laufen auf einem Worker, also wähle eine Umgebung aus, die von einem Worker abgefragt wird. Was wo läuft erklärt, was ein Worker ist. Ohne Worker wartet der erste Tool-Aufruf, bis einer ihn ausführt. Administratoren erstellen Umgebungen und können die Worker einer Umgebung auf deren Tab Workers sehen.

  1. Einen Agenten erstellen

    Wähle in der Seitenleiste Agents aus und klicke auf Create agent. Wähle einen Ausgangspunkt, etwa Blank agent, und gib einen Namen ein.

    Klicke auf Create agent. Die Seite des Agenten wird geöffnet.

  2. Eine Sitzung starten

    Klicke auf der Seite des Agenten auf Start session. Wähle eine Umgebung aus und klicke auf Create session. Die Seite der Sitzung wird geöffnet.

  3. Eine Nachricht senden

    Gib im Feld unten auf der Seite eine Nachricht ein und sende sie. Die Seite wird aktualisiert, während der Agent arbeitet. Wenn ein Tool-Aufruf auf dich wartet, zeigt seine Karte Approve und Deny an.

Während ein Tool-Aufruf auf dich wartet, zeigt das Badge der Sitzung Idle.

Um eine andere Sitzung zu öffnen, etwa eine, die eine Anwendung über die API gestartet hat, wähle in der Seitenleiste Sessions aus und wähle dann die Sitzung aus.

Wer was sieht

Deine Rolle bestimmt, was die Konsole anzeigt, genau wie in der API:

  • Administratoren sehen und ändern alles auf dem Server.
  • Personen mit der Rolle developer oder user sehen jede Umgebung. Von den Agenten, Sitzungen, Vaults, Memory Stores und Skills sehen sie nur das, was sie unter ihrer eigenen Anmeldung erstellt haben.

Ein Agent oder eine Sitzung, die mit dem API-Key des Servers erstellt wurde, wie die aus dem Schnellstart, ist nur für Administratoren sichtbar. Die vollständige Tabelle findest du unter Was jede Rolle tun kann.

Die Konsole deaktivieren

Der Server stellt die Konsole standardmäßig bereit. Um sie zu deaktivieren, setze console.serve: false in der Einstellungsdatei und starte den Server neu. Der Server stellt dann die Konsole nicht mehr bereit. Agenten und Sitzungen funktionieren weiterhin über die API.

Nächste Schritte

War diese Seite hilfreich?