Externe Agenten und delegierter Zugriff

Verbinde deinen eigenen Assistenten mit Ennea und lege fest, was diese Verbindung tun darf. Rückfragen und Bestätigungen regelst du mit deinem Agenten. Ennea prüft den Verbindungszugriff, deine aktuellen Berechtigungen, fachliche Regeln, Versionen und Historie. Für externe Agenten gibt es keine zusätzliche Annahmewarteschlange pro Aktion.

Drei Zugriffsstufen

Zugriff	Was der Agent tun darf
Lesen	Erlaubte Datensätze, Konfigurationen und Entwürfe einsehen.
Entwürfe bearbeiten	Lesen sowie normale gemeinsame Studio-Entwürfe erstellen und bearbeiten.
Veröffentlichen	Entwürfe bearbeiten, gespeicherte Versionen ausdrücklich veröffentlichen und operative Befehle ohne natürlichen Entwurf ausführen.

Eine Verbindung bleibt auf den gewählten Arbeitsbereich, die Umgebung und die Datensatztypen beschränkt. Sie erhält keine Rechte, die du aktuell nicht selbst hast. Widerrufe ungenutzte Verbindungen jederzeit. Das beendet zukünftigen Zugriff und macht abgeschlossene Arbeit nicht rückgängig.

Das Speichern eines Entwurfs veröffentlicht ihn niemals, auch nicht mit Veröffentlichungszugriff. Entwürfe erscheinen im normalen Arbeitsbereich, in dem du und dein Agent dieselben Inhalte bearbeiten. Veröffentlichung ist eine explizite Aktion für die genaue gespeicherte Version. Gleichzeitige Änderungen führen zu einem Versionskonflikt; der Agent muss den aktuellen Entwurf neu lesen.

Verbinden

Installiere das unterstützte Ennea-Plugin und nutze die Anmeldung und Freigabe im Browser. Wähle Arbeitsbereich, Zugriffsstufe und erlaubte Datensatztypen. Prüfe vor Arbeitsbeginn den aktuellen Kontext und die Fähigkeiten: Die verfügbaren Bereiche sind enger als der vollständige Funktionsumfang im Browser oder bei Konnie. Tool-Argumente können weder den Arbeitsbereich wechseln noch die Berechtigungen erweitern.

Verwalte Verbindungen unter Betriebsstudio → Integrationen → KI-Agenten → Agentenzugriff. Entwicklerzugangsdaten für die CLI verwenden dieselben Zugriffsstufen und Datensatzbeschränkungen. Wähle ihre Laufzeit; die ausstellende Anmeldesitzung kann sie weiter begrenzen. Gehostete OAuth-Verbindungen zeigen ihre Laufzeit bei der Freigabe und bleiben an deine Sitzung und aktuellen Rechte gebunden.

Speichere CLI-Zugangsdaten in der Ausführungsumgebung oder einer privaten Datei. Tokens gehören niemals in Prompts, Quelldokumente oder Änderungsdaten. Beim unterstützten Plugin verwaltet der Host die OAuth-Zugangsdaten.

Bearbeiten und veröffentlichen

Beschreibe deinem Agenten das gewünschte Ergebnis und gib Quelldaten und bekannte Kennungen mit. Fehlende Mengen, Einheiten und Identitäten soll er erhalten statt erfinden, vorhandene Datensätze prüfen und die ermittelten Schemas verwenden.

Für Studio-Konfiguration liefert ennea_read_draft den normalen gemeinsamen Entwurf und seine aktuelle Bearbeitungsversion. ennea_edit_draft speichert eine neue Entwurfsversion mit Historie. ennea_publish_draft veröffentlicht ausdrücklich die genaue gespeicherte Version, wenn die Verbindung und deine nativen Rechte das erlauben. Die CLI-Befehle heißen draft read, draft edit und draft publish und erhalten strukturierte JSON-Eingaben.

Materialien, Stücklisten und Arbeitspläne verwenden dieselben gespeicherten Fertigungsentwürfe, die du mit Konnie und im Betriebsstudio bearbeitest. Ihre bestehende Versionshistorie, die Zugriffsrechte auf Anhänge und die Veröffentlichungsregeln gelten weiterhin. Ein neues Material steht operativen Abläufen erst nach der Veröffentlichung zur Verfügung. Auch die speziellen Tools ennea_read_manufacturing_draft, ennea_save_manufacturing_draft und ennea_publish_manufacturing_draft verwenden dieselben Entwürfe. In der CLI lautet der Aufruf draft read|save|publish material|bom|routing --stdin. Eigenständige Formulare werden von diesen direkten Entwurfsaktionen nicht unterstützt. Verwende für einen neuen Formularablauf eine App mit eigenen Eingaben.

Für eigene React-Apps speichert ennea_edit_app oder CLI app edit Quellcode, Einstellungen und Verbindungen direkt als gemeinsamen Entwurf. Lies vorher appProgram source und behalte die genaue kombinierte expectedVersion bei. Nicht genannte Dateien und Einstellungen bleiben erhalten. ennea_publish_app oder CLI app publish ist eine eigene explizite Aktion. Es entstehen weder Implementierungsplan noch vorgemerkte Änderung oder Annahmeaufgabe.

Zum Beispiel: „Aktualisiere diese Prüf-App als Entwurf; ich veröffentliche es später.“ Ein Agent mit Entwurfszugriff kann das ohne Veröffentlichungsrechte abschließen. Auch ein Agent mit Veröffentlichungszugriff speichert zunächst den Entwurf und veröffentlicht nur auf ausdrückliche Anweisung.

Operative Befehle und Pakete

Lagerbewegungen, Produktionsmeldungen und ähnliche operative Aktionen haben keinen natürlichen Bearbeitungsentwurf. Eine Verbindung mit Veröffentlichungszugriff kann sie über ennea_execute_command oder CLI command execute direkt ausführen. Nutze die genaue Aktion und das Eingabeschema aus der Fähigkeitenermittlung. Native Freigaben, Validierungen und Anbieterausführung gelten weiter; ein angenommener Befehl kann fachlich noch ausstehende Arbeit melden.

ennea_execute_changes oder CLI operations execute nimmt Pakete nativer create/update/delete-Operationen an. Konfigurationsänderungen mit natürlichem Entwurf speichern nur Entwürfe; die Veröffentlichung bleibt separat. Direkte Datensatzänderungen und Befehle ohne Entwurf benötigen Veröffentlichungszugriff. CLI create, update und delete senden einzelne Operationen. changes execute ist ein kompatibler Name für denselben direkten Paketablauf.

Pakete sind keine atomaren Transaktionen. Prüfe jedes Ergebnis und erhalte genaue Versionen, Quellidentitäten, Mengen und Einheiten. Externe Agenten benötigen keine Schritte zum Vorbereiten, Vormerken, Annehmen oder Anwenden. Ältere Änderungsvorschläge bleiben über die Entwickler-CLI lesbar.

Ergebnisse und Wiederaufnahme

Bewahre operationId, invocationId und idempotencyKey für dieselbe beabsichtigte Anfrage auf. ennea_operation_status oder CLI operations status ID liest das dauerhafte Ergebnis, ohne Schreibaktionen zu wiederholen. Paketergebnisse sind seitenweise verfügbar: Folge nextOffset bis null und lies einzelne operationId-Belege für native Details. Die Anzahlen gelten für das ganze Paket. Dieselbe Anfragekennung mit identischen Daten beobachtet denselben Versuch. Wähle keinen neuen Schlüssel, nur weil eine Antwort verloren ging.

Laufende, fehlgeschlagene, teilweise oder unklare Ergebnisse sind kein Abschluss. Prüfe native Belege und gespeicherte Datensätze, bevor du Erfolg meldest. Native Belege können ausstehende fachliche Freigaben oder Anbieterarbeit getrennt von der Befehlsausführung ausweisen. Prüfe unklare Ergebnisse vor einem neuen Versuch.

Der Fabrikkalender hat Ziel- und Horizontgrenzen; Kalenderkonfiguration plant keine Fertigungsaufträge. Entdecke studioVersion für Veröffentlichungs-/Entwurfshistorie und begrenzte Vergleiche sowie warehouse / materialFlow für native Lager- und Bewegungsabläufe.

Diese Verbindung für externe Agenten ist von Konnies Gesprächssteuerung getrennt. Siehe Berechtigungen, Veröffentlichung und Audit.

Unter Einen externen Agenten verbinden findest du Plugininstallation und eine vollständige lesende CLI-Prüfung mit herunterladbarer JSON-Eingabe.