Ein KI-Assistent, der über einen API-Schlüssel mit SynCore arbeitet, kann statt vieler einzelner Aufrufe ein kurzes Programm schicken: Es liest Daten, filtert und zählt sie und gibt nur das Ergebnis zurück. Wie dein Assistent damit arbeitet, steht unter So arbeitet der Code-Mode.
Ein Programm darf nur die Werkzeuge benutzen, die es beim Start nennt, und nur mit den Rechten des Benutzers, dem der API-Schlüssel gehört. Es hat kein Netz und keinen Zugriff auf Dateien.
Sofort schreiben oder erst nach Freigabe
Wie ein Programm schreibt, legt der API-Schlüssel fest, unter Programme freigeben:
- Niemand (Standard): Das Programm liest, legt an und ändert sofort, mit den Rechten des Benutzers, genau wie der klassische MCP. Löschen geht nur, wenn am Schlüssel Löschen erlaubt an ist, mit der Grenze je Stunde. Der Lauf steht danach auf Fertig, eine Aufgabe entsteht nicht.
- Eine Person: Liest das Programm nur, ist es sofort Fertig. Will es etwas anlegen, ändern, löschen oder versenden, führt SynCore diese Aufrufe zuerst nicht aus, sondern sammelt sie als Vorschau. Der Lauf steht dann auf Wartet auf Freigabe, und nur diese Person bekommt eine Aufgabe Freigabe Programm: … mit der Anzahl der Schreibaufrufe. Im Aufgaben-Dialog steht die Karte Freigabe eines Programms mit den geplanten Aufrufen und den Knöpfen Freigeben und Ablehnen.
Die Freigabe ist für Schlüssel gedacht, bei denen ein Mensch jeden Schreibvorgang sehen soll, zum Beispiel für einen Agenten, der fremde Mails oder Dokumente liest. Alle folgenden Abschnitte zur Freigabe gelten nur für solche Schlüssel.
Nach der Freigabe läuft dasselbe Programm noch einmal. Weicht dabei ein Schreibaufruf von der Vorschau ab, zum Beispiel weil sich ein Name mit der Uhrzeit ändert, bricht der Lauf ab, ohne diesen Aufruf auszuführen. Er steht dann auf Abgebrochen.
Einen Lauf prüfen und entscheiden
- Öffne die App Automationen und die Seite Programme. Die Tabelle zeigt Status, Benutzer, Werkzeuge, Schreibaufrufe, Gestartet und Freigabe bis. Über Filter grenzt du nach Status ein.
- Klicke auf einen Lauf. Der Dialog zeigt oben Benutzer und Startzeit, darunter Geplante Schreibaufrufe mit Werkzeug und Eingabe, das Ergebnis der Vorschau, die Konsole des Programms, das Programm selbst und alle Aufrufe, getrennt nach Vorschau und Lauf nach Freigabe.
- Prüfe, ob die geplanten Schreibaufrufe das tun, was der Assistent tun soll.
- Klicke Freigeben oder schreibe optional einen Grund und klicke Ablehnen.
Aus der Aufgabe kommst du über Lauf ansehen direkt in diesen Dialog.
Ohne Entscheidung verfällt eine Freigabe nach 24 Stunden. Der Lauf steht dann auf Verfallen, nichts wird geschrieben.
Code-Mode am API-Schlüssel
Programme gibt es nur über einen API-Schlüssel im Code-Mode. Ob Programme sofort schreiben oder auf eine Freigabe warten, stellt ein Plattform-Admin am selben Schlüssel unter Programme freigeben ein. Wie das geht: Code-Mode einschalten und absichern.
Wird der Code-Mode ausgeschaltet, während ein Lauf auf Freigabe wartet, kannst du ihn nur noch ablehnen.
Skills: bewährte Programme wiederverwenden
Ein Skill ist ein Programm mit Beschreibung und Eingabe, das ein Assistent starten kann, statt es neu zu schreiben. Vier liefert SynCore mit: Aufgaben anlegen und Zeiten buchen, Rechnung aus Zeiten, Berichte ziehen und CRM-Import mit Abgleich. Ein Skill schreibt wie jedes Programm: sofort oder, wenn am Schlüssel eine Person eingetragen ist, erst nach ihrer Freigabe.
Eigene Skills entstehen nur aus einem Lauf, der schon fertig ist: Der Assistent schlägt das Programm vor, ein Mensch übernimmt es. Wer das darf, bekommt eine Aufgabe Skill vorgeschlagen: … mit Beschreibung und Programm.
- Öffne die App Automationen und die Seite Skills. Die Tabelle zeigt Titel, Status, Schlüssel, Herkunft, Werkzeuge und Vorgeschlagen.
- Klicke auf einen Vorschlag. Lies Beschreibung (SKILL.md) und Programm.
- Klicke Übernehmen oder schreibe optional einen Grund und klicke Verwerfen.
Übernommen wird ein Skill als nächste Version; die vorige steht danach auf Abgelöst und bleibt lesbar. Einen aktiven Skill nimmst du mit Zurückziehen aus dem Verkehr. Den eigenen Vorschlag übernimmt immer ein anderer Mensch.
Wer was darf
Die Rechte stehen unter Admin › Berechtigungen in der App Automationen:
| Recht | Wofür |
|---|---|
| Programme über einen API-Schlüssel ausführen | Der Benutzer eines API-Schlüssels darf Programme starten. Gib es nur technischen Benutzern mit eng geschnittener Rolle. |
| Schreibaufrufe eines Programms freigeben oder ablehnen | Läufe freigeben oder ablehnen. |
| Seite Programme sehen, dazu Datenobjekt Programm lesen | Die Seite Programme und die Läufe sehen. |
| Skill-Vorschläge übernehmen oder verwerfen, Skills zurückziehen | Über Skills entscheiden. |
| Seite Skills sehen, dazu Datenobjekt Skill lesen | Die Seite Skills sehen. |
Ab Werk hat nur die Admin-Rolle des Mandanten diese Rechte. Den Lauf eines technischen Benutzers gibt immer ein anderer Mensch frei, nie dieser Benutzer selbst. Ist der Benutzer des Schlüssels Plattform-Admin, darf ein Programm dasselbe wie der klassische Weg mit diesem Schlüssel.
Wenn es nicht klappt
| Was du siehst | Grund | Was du tust |
|---|---|---|
| Abgebrochen mit „Eingabe weicht von der Vorschau ab“ | Das Programm hat beim zweiten Durchgang etwas anderes geschrieben als in der Vorschau. | Den Assistenten bitten, feste Werte zu verwenden, und neu starten lassen. |
| Verfallen | Niemand hat binnen 24 Stunden entschieden. | Den Assistenten das Programm neu starten lassen. |
| Abgebrochen mit „Keine Freigabe möglich“ | Die am Schlüssel eingetragene Person kann nicht freigeben (Recht fehlt, nicht mehr Mitglied). | Unter Admin-Konsole › Zugriff › API Keys den Schlüssel bearbeiten und bei Programme freigeben eine andere Person wählen oder das Recht vergeben, dann neu starten lassen. |
| Kein Freigeben im Dialog | Dir fehlt das Recht, es ist dein eigener Lauf, oder am Schlüssel ist eine andere Person für die Freigabe eingetragen (steht als Freigabe durch … im Lauf). | Jemanden mit dem Recht bitten bzw. die eingetragene Person. |
| Freigeben meldet „Code-Mode ist an diesem API-Schlüssel ausgeschaltet“ | Jemand hat den Code-Mode am Schlüssel ausgeschaltet, nachdem der Lauf gestartet war. | Wieder einschalten oder den Lauf ablehnen. |