Ein Agent-Token erstellen

Was ein Token ist ​

• Es gehört der Person, die es erstellt hat (seinem Besitzer), und handelt mit einer Teilmenge der Gruppen dieser Person.
• Es wird einmal angezeigt. obop speichert nur einen Hash, ein verlorenes Token lässt sich also nicht wiederherstellen; erstellen Sie ein neues.
• Es beginnt mit obop_. Behandeln Sie es wie ein Passwort.
• Nur eine Person kann Tokens erstellen. Ein Agent kann kein weiteres Token ausstellen.
• Es läuft nicht ab und funktioniert nicht mehr, sobald sein Besitzer gelöscht wird. Einen Befehl, um ein einzelnes Token zu widerrufen, gibt es noch nicht (siehe Sicherheit).

Die Scopes wählen ​

Scopes sind Berechtigungsgruppen. Überlegen Sie, was der Agent tun soll, und geben Sie ihm nur diese Gruppen. Gängige Gruppen der integrierten Apps:

Installierte Pakete bringen eigene Gruppen mit, zum Beispiel helpdesk.agent. Die App-Seiten listen die Gruppen jeder App auf.

Über REST ​

Melden Sie sich als Person an und fordern Sie dann ein Token an. Dafür brauchen Sie eine laufende Instanz; die Beispiele nutzen eine lokale auf Port 8080.

curl -s -X POST http://127.0.0.1:8080/api/auth/login \
  -H 'content-type: application/json' \
  -d '{"username":"alice","password":"your password"}'

Die Antwort ist {"token":"obop_..."}: ein Sitzungs-Token, das 12 Stunden gültig ist. Verwenden Sie es als Bearer-Token, um das Agent-Token zu erstellen:

curl -s -X POST http://127.0.0.1:8080/api/auth/agent-token \
  -H "Authorization: Bearer $SESSION_TOKEN" \
  -H 'content-type: application/json' \
  -d '{"scopes":["base.user","crm.user"],"label":"triage-bot"}'

{ "token": "obop_1e00c3..." }

scopes ist erforderlich und muss mindestens eine Gruppe nennen, die Sie selbst haben. label ist freier Text. Bei einer gehosteten Instanz verwenden Sie deren Adresse statt 127.0.0.1:8080 und melden sich mit Ihrer Registrierungs-E-Mail-Adresse als Benutzernamen an.

Mit der CLI ​

Wenn Sie obop selbst betreiben, können Sie ein Token direkt auf der Kommandozeile ausstellen. Der Befehl greift direkt auf die Datenbank zu, führen Sie ihn also dort aus, wo die Datenbank erreichbar ist:

obop agent-token alice --scopes base.user,crm.user --label triage-bot

obop_1e00c32430532fdcef...
shown once; store it like a password

Fügen Sie --db postgres://... hinzu (oder setzen Sie OBOP_DATABASE_URL), wenn die Instanz nicht die Standarddatenbank sqlite://obop.db verwendet.

Sicher aufbewahren ​

• Legen Sie es in einer Umgebungsvariablen oder einem Secret-Store ab, nicht in einem Repository.
• Verwenden Sie lieber ein Token pro Agent und pro Aufgabe, damit Sie sie unterscheiden und eines entfernen können, ohne die übrigen zu beeinträchtigen.
• Ein Token in der Konfigurationsdatei eines Clients ist für alles lesbar, was diese Datei lesen kann.

Fehler ​

Weiter geht es mit Über MCP verbinden oder Die REST-API nutzen.