Agenten (Agent)

Überblick

Die Agentenseite (Seitenleistenmenü Agenten) ist der Einstiegspunkt zum Durchsuchen und Nutzen von KI-Agenten im Arbeitsbereich. Sie unterstützt zwei Arten von Agenten:

Agenten des A2A-Protokolls: standardisierte Agenten, die von Drittanbietern gemäß dem A2A-Protokoll bereitgestellt werden; das Hinzufügen einer einzigen URL genügt, um ein Gespräch zu beginnen
Klassische Agenten (Typ QuestionAnswer / Flow): Agenten, die auf der GPTBots-Plattform veröffentlicht und per iframe eingebettet werden

Zentraler Unterschied: Anders als bei Work ist die Agentenseite ein App-Marktplatz – Sie rufen einen bereits von anderen oder von Ihnen selbst erstellten Agenten auf, statt eine Aufgabe von Grund auf neu zu starten.

Einstieg

Web: https://www.gptbots.ai/工作区/agent
APP: linkes Menü „Agenten“

Listenansicht

Die Agenten werden in Form eines Kartenrasters dargestellt:

Element	Beschreibung
Symbol + Name	Avatar und Anzeigename des Agenten
Typ-Badge	`Agent` (klassischer Agent) oder `A2A` (Agent des A2A-Protokolls)
Beschreibung	Kurzbeschreibung der Fähigkeiten des Agenten
Statistik	Anzahl der Nutzungen, Anzahl der Favoriten usw.
Favoriten-Stern	Zum Favorisieren anklicken; favorisierte Agenten lassen sich unter „Meine Favoriten“ schnell wiederfinden

Filtern

Kategorie-Tabs oben: Alle / Default / benutzerdefinierte Kategorien (z. B. Finanzen / Verwaltung / Produkt & Forschung / Recht)
Stichwortsuche: Suchfeld oben rechts
Meine Favoriten: Schaltfläche oben rechts, zeigt nur favorisierte Agenten an

A2A-Agenten

Einen A2A-Agenten hinzufügen

Fügen Sie über die Agent-Card-URL einen standardisierten Agenten des A2A-Protokolls hinzu:

Klicken Sie auf der Agentenseite auf die Schaltfläche A2A-Agent hinzufügen (nur für Administratoren)
Geben Sie die Agent-Card-URL des Agenten ein (z. B. https://agent.example.com/.well-known/agent.json)
Das System ruft die Informationen des Agenten automatisch ab (Avatar, Name, Beschreibung, Liste der Fähigkeiten)
Legen Sie Kategorie und Anzeigename fest
Nach dem Speichern erscheint der Agent in der Liste

Was ist eine Agent-Card-URL? Es handelt sich um den HTTP-Endpunkt, den ein A2A-Agent eines Drittanbieters bereitstellt und der die Identitätsbeschreibung des Agenten (im JSON-Format) zurückgibt. Sie wird in der Regel vom Entwickler des Agenten bereitgestellt.

A2A-Gespräch

Klicken Sie auf eine Agentenkarte, um die Gesprächsoberfläche A2aChatView zu öffnen:

Funktion	Beschreibung
SSE-Streaming-Antwort	Antworten des Agenten in Echtzeit empfangen
Strukturierte Antwort	Unterstützt die vier Inhaltsblöcke text / file / data / a2ui
Sitzungsverwaltung	Wiederverwendung einer bestehenden Sitzung oder erzwungene Neuanlage
Nachrichtenverlauf	Frühere Gesprächsverläufe durchsuchen

Typen strukturierter Antworten:

Part-Typ	Darstellungsweise
`text`	Markdown-Rendering (inkl. mathematischer Formeln, Code-Highlighting, Tabellen)
`file`	Dateianhang (eingebettetes Bild oder Download-Link)
`data`	JSON-Daten (Darstellung im Codeblock-Format)
`a2ui`	Agent-to-UI-Interaktionskomponente (Rendering durch A2UIRenderer)

Für die technischen Details des Protokolls siehe A2A-Protokoll.

Kontoübergreifender Aufruf

A2A-Agenten unterstützen die kontoübergreifende Gateway-Verteilung – wenn ein Nutzer über das Web einen Agenten im Enterprise-Bereich aufruft, wird die Anfrage über das Gateway zur Ausführung an den Zielknoten geroutet. Siehe Mehrknoten-Architektur – Verteilungsregeln für Berechtigungs-Popups.

Klassische Agenten

Klassische Agenten (Typ QuestionAnswer / Flow) werden per iframe in die Agenten-Detailseite von Space Web eingebettet.

Typ	Beschreibung
QuestionAnswer	Frage-Antwort-Agent, basierend auf einer RAG-Wissensdatenbank
Flow	Prozessgesteuerter Agent, basierend auf einem orchestrierten Workflow

Nach dem Klick auf die Karte eines klassischen Agenten gelangen Sie zur AgentDetailPage, die die Seite /space/agent-details/{botId} von Space Web einbettet.

Berechtigungssteuerung

Rolle	Aktion
Alle Mitglieder	Liste durchsuchen, suchen, filtern, favorisieren, mit Agenten sprechen
Administrator	Agenten hinzufügen, bearbeiten, löschen

Administratorrechte werden über canManageAgents() geprüft (Rolle Owner / Admin oder Vorhandensein eines bestimmten Berechtigungscodes).

Bedienungsanleitung

So fügen Sie einen A2A-Agenten hinzu

Nachdem Sie im Entwicklungsbereich einen Agenten erstellt und veröffentlicht haben, können Sie ihn auf der Integrationsseite per Klick in den Arbeitsbereich veröffentlichen.
Auf der Seite Arbeitsbereich – Bereichsverwaltung – Unternehmensressourcen – Agent kann der Administrator prüfen, ob der Agent online gehen soll.
Nach erfolgreicher Prüfung wird der Agent in der Arbeitsbereichsliste angezeigt; klicken Sie in der Seitenleiste des Arbeitsbereichs auf Agenten
Suchen Sie den soeben online gestellten Agenten und klicken Sie auf die Karte, um die Gesprächsoberfläche zu öffnen

So sprechen Sie mit einem Agenten

Suchen Sie auf der Agentenseite die Karte des gewünschten Agenten
Klicken Sie auf die Karte, um die Gesprächsoberfläche zu öffnen
Geben Sie eine Nachricht ein und senden Sie sie mit Enter
Warten Sie auf die Antwort des Agenten (SSE-Streaming, Anzeige in Echtzeit)

Tipp: Das System verwendet standardmäßig die vorherige Sitzung erneut. Wenn Sie ein völlig neues Gespräch beginnen möchten, klicken Sie auf die Schaltfläche „Neue Sitzung“.

Häufige Fragen

Verbindung zum Agenten fehlgeschlagen

Stellen Sie sicher, dass die Agent-Card-URL vom aktuellen Netzwerk aus erreichbar ist
Stellen Sie sicher, dass die URL HTTPS verwendet und keine interne Netzwerkadresse ist (das System verfügt über SSRF-Schutz)
Falls der Agent eine Authentifizierung erfordert, stellen Sie sicher, dass authType und die Zugangsdaten korrekt konfiguriert sind

Antwort des Agenten ist leer oder falsch formatiert

Möglicherweise liegt ein Problem auf Seiten des Agenten vor; versuchen Sie, die Nachricht erneut zu senden
Prüfen Sie, ob der Agent Chinesisch unterstützt (manche Agenten unterstützen möglicherweise nur Englisch)