Skip to content

Externen Agenten registrieren

Was es kann

Ein externer Agent läuft woanders: Claude Code, Cursor, Microsoft Copilot, Copilot Studio oder Ihr eigenes Programm. Mit der Registrierung erhält er einen Namen, einen Zweck und einen Token. Sein Zugriff auf Ihre Konnektoren wird so geregelt wie bei jedem anderen Agenten: Er sieht nur die Konnektoren, die Sie gewählt haben, und jeder Aufruf wird mit dem Zweck protokolliert.

Der Agent läuft nicht auf dem Gateway. Er hat hier kein Modell und keine Anweisungen. Er handelt für die Person, die ihn registriert, mit deren Vollmacht.

So fragen Sie

Sie fragen hier nicht in einer Chatnachricht, sondern nutzen einen Assistenten auf der Seite Agenten.

  • Öffnen Sie Agenten, wählen Sie den Tab Externe Agenten und klicken Sie auf Externen Agenten registrieren.
  • Schritt 1: Geben Sie einen Namen ein, wählen Sie die Plattform und schreiben Sie den Zweck in eine Zeile. Der Zweck steht in jedem Protokolleintrag dieses Agenten.
  • Schritt 2: Wählen Sie mindestens einen Konnektor aus. Erst Registrieren legt den Agenten an.
  • Schritt 3: Kopieren Sie Token und Endpunkt, folgen Sie der Einrichtung für Ihre Plattform, bestätigen Sie, dass Sie den Token gespeichert haben, und klicken Sie auf Fertig.

Tipps

  • Schreiben Sie den Zweck so, dass jemand, der das Protokoll liest, versteht, warum der Agent ein Werkzeug aufgerufen hat.
  • Kopieren Sie zuerst den Token. Er ist nur jetzt sichtbar und wird nie wieder angezeigt.
  • Wählen Sie nur die Konnektoren, die der Agent wirklich braucht. Die Werkzeuge pro Konnektor können Sie danach begrenzen.

  • Wenn Sie unsicher sind, wie Sie die Werte in Ihrer Plattform eintragen, stellen Sie die Einrichtung auf Ihre Plattform um.

  • Damit sich Personen per Anmeldung statt mit eingefügtem Token verbinden können, öffnen Sie den Agenten und verknüpfen unter Anmeldung per OAuth die Client-ID, die Ihnen die Person nennt. Bei einer dcr_-Kennung folgt zuerst eine Rückfrage.

Grenzen

  • Die Schaltfläche ist gesperrt, solange kein Konnektor verbunden ist und solange der gewählte Zugang Aufrufe ohne Token erlaubt oder noch keine Aufrufe annehmen kann.
  • Plattform und Hosting lassen sich danach nicht ändern. Ein interner Agent kann nicht extern werden und umgekehrt.
  • Ein externer Agent kann auf dem Gateway nicht aufgerufen, geplant oder ausgelöst werden.
  • In der Ansicht als andere Person können keine Tokens erstellt werden.
  • Der Systemagent „Nicht verifizierte Clients“ öffnet sich als schreibgeschützte Seite ohne Tokens; jede schreibende Aktion wird zur Freigabe angehalten.

Wenn etwas schiefgeht

  • Die Registrierung ist fehlgeschlagen: Es wurde nichts angelegt. Versuchen Sie es erneut.
  • Der Agent ist angelegt, der Token aber nicht: Klicken Sie im Assistenten auf Token erstellen. Wird der Token abgelehnt, existiert der Agent ohne Token: Öffnen Sie ihn nach Behebung der Ursache und wählen Sie Rotieren (oder Neuen Token erzeugen, wenn er keinen hat).
  • Ihre Abteilung darf diesen Zugang nicht nutzen: Der Agent besteht; bitten Sie eine Administratorin oder einen Administrator um Freigabe.
  • Sie haben den Assistenten ohne gespeicherten Token geschlossen: Öffnen Sie den Agenten im Tab Externe Agenten und wählen Sie Rotieren (oder Neuen Token erzeugen, wenn er keinen hat). Der alte Token wird ungültig, ein neuer wird einmalig angezeigt.
  • Widerrufen oder Rotieren ist fehlgeschlagen: Bei einem Server- oder Netzwerkfehler ist die Aktion möglicherweise nicht wirksam geworden: Prüfen Sie die Token-Liste und nutzen Sie dann Erneut versuchen. Lehnt der Server ab (z. B. weil Ihre Rolle diesen Agenten nicht ändern darf oder weil Agenten für Ihren Workspace ausgeschaltet sind; dann wurde nichts widerrufen), nennt die Seite den Grund und bietet keinen neuen Versuch an: Wenden Sie sich an eine Administratorin oder einen Administrator. Existiert der Agent nicht mehr, zeigt die Seite das an.
  • Das Verknüpfen eines OAuth-Clients ist fehlgeschlagen: Die Meldung am Feld nennt den Grund (ungültige ID, ID schon mit einem anderen externen Agenten verknüpft, unbekannte dcr_-Kennung, Prüfung gerade nicht möglich). Ihre Eingabe bleibt stehen; korrigieren Sie sie oder versuchen Sie es erneut.
  • Kopieren hat nicht geklappt: Markieren Sie den Text und kopieren Sie ihn selbst.

Siehe auch