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.approveModul 05
Plane-Modul
Human approval queue
Halten Sie einen riskanten Schreib- oder Löschvorgang an, bis eine angemeldete Person ihn freigibt, mit Agent, Ressource und Verb vor Augen.
coordination.approve ist die Warteschlange für menschliche Freigaben. Ein Schreib- oder Löschvorgang, der ohne Bestätigungs-Token eintrifft, wartet hier als ausstehende Anfrage. Ein angemeldeter Administrator oder berechtigter Freigeber gibt ihn frei oder lehnt ihn ab, und die Freigabe stellt ein einmaliges Token aus, mit dem der Agent es erneut versucht.
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.
human_write oder human_delete: welches Gate die Absicht traf.
approval.decidedBy
Wer entschied, und decidedAt erfasst wann.
approval.expiresAt
Wann eine unentschiedene Anfrage verfällt.
approval.hasToken
Ob ein Bestätigungs-Token ausgestellt wurde, mit tokenExpiresAtMs für seine Lebensdauer.
ledgered
Ob die Entscheidung ins Ledger geschrieben wurde.
Mechanismus
Schritt für Schritt
So funktioniert es
Eine Absicht stoppt am Gate
coordination.admit lehnt einen Schreib- oder Löschvorgang ohne Token ab und hinterlässt eine ausstehende Anfrage, deren ID als approvalId zurückkommt.
Eine Person liest sie
GET /api/v1/acp/coordination/approvals listet die Warteschlange, mit Agent, Ressource, Verb und Gate jedes Eintrags, human_write oder human_delete.
Freigeben oder ablehnen
approve nimmt eine id und einen optionalen reason. deny nimmt eine id und einen Pflicht-reason. Beide schreiben ein Ledger-Ereignis, das nennt, wer entschied.
Der Agent versucht es erneut mit einem Token
Eine Freigabe stellt ein einmaliges Bestätigungs-Token aus. Der anfragende Agent oder ein Administrator liest es aus GET /api/v1/acp/coordination/approval.
Ausprobieren
Live-Demo
Direkt auf dieser Seite ausführen
GET/api/v1/acp/coordination/approvals
// Kein Body: Das ist ein GET. Klicken Sie auf Ausführen.
Läuft in einem gemeinsamen Demo-Workspace mit einem Demo-Schlüssel: Jeder kann sehen, was darin liegt, senden Sie also nichts Privates. Doku zu coordination.approve
Antworten
Klicken Sie auf Ausführen, um die Anfrage links an den gemeinsamen Demo-Workspace zu senden.
Läuft in einem gemeinsamen Demo-Workspace mit einem Demo-Schlüssel: Jeder kann sehen, was darin liegt, senden Sie also nichts Privates.
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.
Ein Release-Agent versucht, repo:payments/main ohne Token zu schreiben. Die Anfrage wartet, und ein Bereitschafts-Administrator gibt sie mit der Begründung „erwarteter Batch“ frei.
Mit Begründung ablehnen
Ein Freigeber sieht ein Löschen auf einer Kundentabelle und lehnt es ab. Die Begründung landet an der Anfrage und im Ledger, damit der Eigentümer des Agenten sie lesen kann.
Die Last verteilen
Ein Administrator benennt einen Kollegen als Freigeber, sodass die Warteschlange nicht die Aufgabe einer Person ist. Das Widerrufen des Grants nimmt das Recht zurück.
Eine verfallene Anfrage auffangen
Eine Anfrage, die niemand entschied, verfällt. Der Agent erhält bei seinem nächsten Versuch eine neue Anfrage, und die alte kann nicht verspätet freigegeben werden.
Wann etwas anderes passt
Einen Agenten sich selbst freigeben lassen. Ein Token oder eine Agentensitzung wird abgelehnt, ebenso die Person, die die Anfrage stellte.
Die Zwei-Personen-Freigabe für die sensibelsten Aktionen. Nutzen Sie dual-control.scopes, wo zwei Administratoren zustimmen müssen.
Überhaupt entscheiden, ob eine Absicht erlaubt ist. Zulassungsregeln liegen in coordination.admit und Ihren Mandaten.
Nachweis
Garantien
Was es leistet und was nicht
Ein Modul ist eine starke Aussage über etwas Enges. Verlassen Sie sich genau darauf.
Es leistet
Nur eine angemeldete Person, die Administrator oder berechtigter Freigeber ist, kann entscheiden; ein API-Token oder ein Agent wird abgelehnt.
Niemand kann eine Anfrage freigeben, die er selbst stellte, und eine bereits entschiedene oder verfallene Anfrage liefert 409.
Ein Bestätigungs-Token ist einmalig und an Akteur, Ressource und Verb der Anfrage gebunden.
Jede Entscheidung schreibt ein Ereignis coordination.approval.approved oder coordination.approval.denied ins Ledger.
Es leistet nicht
Dass der Freigeber die Anfrage genau las. Die Warteschlange erfasst die Entscheidung und die angebotene Begründung.
Dass die freigegebene Aktion sicher war. Das Token lässt die Absicht weiterlaufen, und das Ergebnis wird anderswo beurteilt.
Dass das Token verwendet wurde. Der Zustand used wird gesetzt, wenn es verbraucht ist, und ein unbenutztes Token verfällt schlicht.
Details
Bauhinweise
Bevor Sie bauen
Lebensdauern
Eine Anfrage verfällt nach 24 Stunden und ein Token nach 15 Minuten. Ein Administrator kann beides innerhalb von Grenzen ändern: 60 Sekunden bis 30 Tage für eine Anfrage, 10 Sekunden bis 24 Stunden für ein Token.
Wer administriert
approval-settings, grant-approver und revoke-approver sind nur Administratoren vorbehalten. Die Warteschlange behält die jüngsten 200 entschiedenen Einträge.
Tokens sind keine gewöhnlichen Zugangsdaten
Der anfragende Agent oder ein Administrator kann ein Token lesen. Alle anderen sehen nur, dass eines existiert.
Limits und Bemessung
Der Entscheider muss eine angemeldete Person sein; ein API-Token kann weder freigeben noch ablehnen, gleich welche Scopes es hat.
deny ohne reason wird abgelehnt. approve nimmt einen, braucht ihn aber nicht.
Eine Anfrage verfällt nach 24 Stunden und ein Token nach 15 Minuten, sofern ein Administrator sie nicht ändert.
Freigabe-Aufrufe werden nicht gemessen.
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/approveEine ausstehende Anfrage freigeben und ihr Token ausstellen.
POST/api/v1/acp/coordination/denyEine ausstehende Anfrage mit Begründung ablehnen.
GET/api/v1/acp/coordination/approvalsDie Warteschlange, Einstellungen und Freigeber auflisten.
GET/api/v1/acp/coordination/approvalEine Anfrage lesen, mit ihrem Token für den Anfragenden.
MCP-Aktionen
MCPcoordination.approvals.listFreigabeanfragen als MCP-Aktion auflisten.
MCPcoordination.approvals.approveEine Anfrage als MCP-Aktion freigeben.
MCPcoordination.approvals.denyEine Anfrage als MCP-Aktion ablehnen.
Plane-Modul
