Ob ein Assistent Programme schickt oder Werkzeuge einzeln aufruft, entscheidet sein API-Key. Ab Werk ist jeder Key klassisch. Den Code-Mode schaltet ein Plattform-Admin je Key ein, zusammen mit zwei Schaltern, die festlegen, wie weit der Assistent schreiben darf.
Die Code-Ausführung muss auf deiner Instanz eingerichtet sein. Ist sie es nicht, richtet United Synergy sie zuerst auf dem Server ein. Code-Mode, Freigabe und Löschen gibt es nur bei Keys, die als Benutzer handeln (Actor-User).
Code-Mode am Key einschalten
- Öffne Admin-Konsole › Zugriff › API Keys und wähle über der Tabelle den Mandanten.
- Klicke auf die Zeile des Keys (oder ⋯ und Bearbeiten). Der Dialog Key bearbeiten öffnet sich. Beim Erzeugen eines neuen Keys über Key erzeugen stehen dieselben Schalter gleich im Formular.
- Schalte Code-Mode ein.
- Wähle bei Programme freigeben, ob Programme sofort schreiben (Niemand, Programme schreiben sofort) oder ob eine Person jeden Schreibaufruf vorher freigibt.
- Lass Löschen erlaubt aus, wenn der Assistent nichts löschen soll. Schaltest du es ein, legst du die Grenze je Stunde fest.
- Klicke Speichern.
Die Änderung gilt sofort und steht im Protokoll mit den geänderten Feldern. Schaltest du den Code-Mode aus, bricht auch ein laufendes Programm beim nächsten Werkzeugaufruf ab.
Was die Schalter bewirken
| Schalter | Aus | An |
|---|---|---|
| Code-Mode | klassischer MCP, jedes Werkzeug einzeln; Programme starten nicht | nur Programme in der Sandbox; einzelne Aufrufe über MCP und /api/app-tools weist SynCore ab |
| Programme freigeben | Niemand: Programme lesen, legen an und ändern sofort | eine Person: Schreibaufrufe laufen erst als Vorschau, nur diese Person bekommt eine Aufgabe und gibt frei oder lehnt ab |
| Löschen erlaubt | Werkzeuge, die löschen, sind über den Key nicht nutzbar, weder einzeln noch in Programmen | löschen erlaubt, soweit die Rollen des Actor-Users es erlauben, bis zur Grenze je Stunde |
Liegt der Key über der Grenze je Stunde, sperrt SynCore das Löschen über diesen Key, bis ein Plattform-Admin es mit ⋯ und Löschen freigeben wieder freigibt. Dazu kommt ein Alarm.
Der Actor-User des Keys kann seine eigenen Programme nie freigeben. Wie die Freigabe im Alltag abläuft: Programme von Agenten freigeben.
Rechte für Programme
Unter Admin › Berechtigungen in der App Automationen:
| Recht | Wer es braucht |
|---|---|
| Programme über einen API-Schlüssel ausführen | die Rolle des Actor-Users, sonst startet kein Programm |
| Schreibaufrufe eines Programms freigeben oder ablehnen | die Person, die am Key unter Programme freigeben steht |
| Seite Programme sehen, dazu Datenobjekt Programm lesen | alle, die Läufe ansehen sollen |
Ab Werk hat nur die Admin-Rolle des Mandanten diese Rechte. Gib das Recht zum Ausführen nur technischen Benutzern mit eng geschnittener Rolle. Ist die App Automationen im Mandanten nicht aktiv, starten keine Programme, auch wenn Key und Rechte stimmen.
So sicherst du den Assistenten ab
- Eigener technischer Benutzer je Assistent, mit einer Rolle, die nur die nötigen Apps und Datenbereiche enthält.
- Zum Ausprobieren
?nur=lesenan die Adresse hängen. Dann laufen auch im Code-Mode nur lesende Werkzeuge. - Mit Freigabe, wenn der Assistent fremde Inhalte liest, etwa Mails oder Dokumente, und ein Mensch jeden Schreibvorgang sehen soll.
- Löschen aus, solange du keinen Grund hast, es einzuschalten.
- Ablaufdatum am Key setzen und den Key über ⋯ und Rotieren erneuern, wenn er in falsche Hände geraten sein könnte: API-Keys, Scopes und Berechtigungen.
Mit Code-Mode funktionieren Befehle und Anleitungen deines Assistenten nicht mehr, die SynCore-Werkzeuge einzeln aufrufen. Brauchst du beides, gib dem Assistenten zwei Keys: einen klassischen und einen im Code-Mode.