Intramedial befindet sich in der eingeschränkten Beta. Bei der Registrierung oder Anmeldung müssen Sie das erhaltene Beta-Tester-Passwort angeben oder unter preview@intramedial.com eines anfordern. Vielen Dank.
Wird geladen…
coordination.haltModul 06
Plane-Modul
Emergency stop switches
Stoppen Sie einen Agenten, ein Mandat oder eine Ressource sofort, mit aktenkundigem Grund, und heben Sie den Stopp auf, wenn es sicher ist.
coordination.halt setzt einen Stopp auf dem Hot Path der Zulassung auf einer von drei Ebenen – agent, mandate oder resource. Die nächste Zulassung antwortet mit einer Ablehnung. Nur ein angemeldeter Administrator kann einen Stopp setzen oder aufheben; der Stopp für den ganzen Workspace ist der separate Schalter .
Intralock · Leases · Parley · Fleet Map
A Trustvice Product
Agenten handeln, wenn die Ebene Ja sagt – und das Protokoll sagt, warum.
Leiten Sie Agent-Aktionen, Inhalts-Hashes, API-Checks, DNS-Abfragen, Webhooks, LLM-Aufrufe und Git-Commits über Intramedial – für einen signierten Beleg, den jeder prüft, ohne uns zu vertrauen.
StatusAktionsschemata benennen anders als die Route
Das Schema coordination.stops.halt listet why, aber die Route liest reason und lehnt einen Stopp ohne ab. unhalt nimmt die id des Stopps, nicht scope und target. Agenten und Tokens werden in beiden Fällen abgelehnt.
Protokoll
Das Protokoll
Was erfasst wird
scope
Pflicht. agent, mandate oder resource. Alles andere ist ein 400, das auf den Kill-Switch verweist.
target
Pflicht. Die DID, der Mandatsname oder die Ressource, die gestoppt werden soll.
Pflicht. Warum der Stopp besteht, damit wer ihn aufhebt weiß, wofür er war.
halt
In der Antwort: der Stopp, mit id (Präfix hlt_), scope, target, reason, by und at.
created
In der Antwort: false, wenn derselbe Scope und dasselbe Ziel bereits gestoppt waren; der bestehende Stopp wird geliefert.
ledgered
In der Antwort: ob das Ereignis coordination.halt das Ledger erreichte. Der Stopp gilt in beiden Fällen.
id
Für unhalt. Der aufzuhebende Stopp. Ein bloß unter Quarantäne gestellter Agent erscheint in switches als q:<did>.
Mechanismus
Schritt für Schritt
So funktioniert es
Formen und Phasen
A
Agent
scope: agent, target eine DID. Der Agent tritt dem Quarantäne-Set bei, sodass jede Zulassung für ihn quarantine antwortet.
B
Mandat
scope: mandate, target ein Mandatsname. Die Zulassung antwortet mandate_halted für jede Aktion, deren Grant aus diesem Mandat stammt.
C
Ressource
scope: resource, target eine Ressource. Sie deckt ab, was darunter liegt, sodass repo:acme auch repo:acme/x stoppt. Die Zulassung antwortet resource_halted.
Schritt für Schritt
Den Scope wählen
halt nimmt scope, target und reason. Alle drei sind Pflicht, und ein Ressourcenstopp kann nicht auf * oder / zielen.
Er wirkt sofort
Der Stopp wird im Speicher gehalten und in den Policy-Store geschrieben. Die nächste Zulassung sieht ihn, bevor ein Grant oder eine Lease gelesen wird.
Lesen, was gestoppt ist
switches listet den Workspace-Kill-Switch, jeden geltenden Halt mit Setzer und Grund, und ob Sie sie ändern dürfen.
Mit Start (oder ⌘/Strg + Enter) signieren Sie die Anfrage links.
Der erste Lauf erzeugt in diesem Browser einen Testschlüssel: rund 35 Aufrufe in 7 Tagen, ohne Konto. Der Beleg erscheint hier und wird gegen die öffentlichen Schlüssel geprüft, ohne uns zu vertrauen.
Code
Live-Beispiel
Eine echte Anfrage
Eine Anfrage in der Form, die die API akzeptiert, und eine Beispielantwort in der Form, die das Modul liefert.
Stoppen Sie den Agenten mit einem Grund. Sein nächster Schreibvorgang wird bei der Zulassung mit quarantine abgelehnt, ohne Änderung an seinen Grants.
Ein schlechtes Mandat
Halten Sie das Mandat per Namen an. Seine Grants lassen sofort nicht mehr zu, während Grants anderer Mandate weiterarbeiten.
Ein Repository einfrieren
Stoppen Sie repo:payments. Alles darunter wird mit resource_halted abgelehnt, bis der Stopp aufgehoben ist.
Alles stoppen
Nutzen Sie kill. Es löst den Coordination-Schalter des Workspace aus, und die Zulassung antwortet für jeden Agenten kill_switch, bis resume.
Wann etwas anderes passt
Einen Agenten unter Freigabe oder Urteil unter Quarantäne stellen. Das ist coordination.quarantine, das Dual Control oder einen adjudizierten Fall braucht.
Für eine menschliche Entscheidung zu einer Aktion pausieren. Angehaltene Schreibvorgänge gehen an coordination.approve; ein Stopp ist eine pauschale Ablehnung.
Herausfinden, was sich fehlverhält. watchdog.check markiert Anomalien; ein Halt ist, was Sie tun, sobald Sie es wissen.
Nachweis
Garantien
Was es leistet und was nicht
Ein Modul ist eine starke Aussage über etwas Enges. Verlassen Sie sich genau darauf.
Es leistet
Ein Stopp wird auf dem Hot Path der Zulassung ohne Modellaufruf geprüft, sodass die nächste Entscheidung nach seinem Setzen die Ablehnung ist.
Jeder Stopp trägt einen Grund und den Administrator, der ihn setzte, und jeder neue Stopp hängt ein Ereignis coordination.halt ans Ledger an.
Ein wiederholter Halt auf demselben Scope und Ziel erzeugt nichts und liefert den bestehenden Stopp.
Das Aufheben eines Stopps wird als coordination.unhalt mit Administrator, Scope und Ziel im Ledger erfasst.
Es leistet nicht
Dass der Agent aufgehört hat zu laufen. Ein Halt lehnt seine Zulassungen ab; der Prozess wird nicht beendet und kann außerhalb der Plane weiter handeln.
Dass bereits zugelassene Aktionen rückgängig gemacht werden. Ein Halt ist kein Rollback, und eine früher gewährte Lease wird dadurch nicht freigegeben.
Dass der Kill-Switch verfügbar ist. Er braucht ein gebundenes KILL_SWITCH_KV; ohne antworten kill und resume 503.
Details
Bauhinweise
Bevor Sie bauen
Wer stoppen darf
halt, unhalt, kill und resume sind für eine angemeldete Person, die den Workspace administriert. Ein Agent oder API-Token wird mit 403 abgelehnt.
Reihenfolge der Zulassung
Quarantäne- und Ressourcenstopps werden zuerst geprüft, dann Bestätigung, Grants und schließlich ein Mandatsstopp. Ein Kill-Switch lehnt vor allen ab.
Der Kill-Switch
kill nimmt ein optionales reason und erfasst coordination.kill im Ledger. resume löscht ihn; ein vom Betreiber gesetzter Schalter ist vom Betreiber aufzuheben und liefert 409.
Die Liste lesen
switches zeigt auch unter Quarantäne stehende Agenten ohne Halt-Zeile, etwa einen durch ein Urteil unter Quarantäne gestellten, als q:<did> mit leerem Grund.
Limits und Bemessung
Es gibt drei Scopes: agent, mandate und resource. Den ganzen Workspace zu stoppen ist der Kill-Switch.
Ein Stopp ohne reason oder ohne target liefert 400, ebenso ein Ressourcenstopp auf * oder /.
Eine Rolle, die kein Administrator ist, erhält bei halt und unhalt 403; das Lesen von switches braucht keine Rolle.
Die aufgehobenen IDs werden bis zu den letzten 200 gemerkt.
Zugriff
API & MCP
REST und MCP
Authentifizieren Sie sich mit einem Workspace-API-Schlüssel als Bearer-Token. Die Basis-URL ist https://api.intramedial.com.
REST-Endpunkte
POST/api/v1/acp/coordination/haltEinen Agenten, ein Mandat oder eine Ressource stoppen.
POST/api/v1/acp/coordination/unhaltEinen Stopp per id aufheben.
GET/api/v1/acp/coordination/switchesDen Kill-Switch und jeden geltenden Halt lesen.
POST/api/v1/acp/coordination/killDen Coordination-Kill-Switch des Workspace auslösen.
POST/api/v1/acp/coordination/resumeDie Coordination des Workspace wieder einschalten.
MCP-Aktionen
MCPcoordination.stops.haltEinen Stopp aus einem Aktionsaufruf setzen; abgelehnt, sofern der Aufrufer kein Administrator ist.
MCPcoordination.stops.unhaltEinen Stopp aus einem Aktionsaufruf aufheben.
MCPcoordination.stops.switchesDie Stopp-Schalter von einem Agenten aus lesen.
MCPcoordination.killDen Kill-Switch aus einem Aktionsaufruf auslösen.
unhalt nimmt die id des Stopps und ein optionales why. Die Aufhebung wird als coordination.unhalt im Ledger erfasst; eine unbekannte ID liefert 404.
iam.assume31
Cloud credential broker
Geben Sie einem Agenten ein kurzlebiges Cloud-Credential nur, solange er eine aktive Lease auf die Rolle hält, und lassen Sie das Credential mit der Lease sterben.
Plane-Modul
