Zum Hauptinhalt springen
Agentengenehmigungen erfassen menschliche Entscheidungen über eine vorgeschlagene Agentenaktion in einer Arbeitsbereichsumgebung. Sie sind getrennt von Workflow-Engine-Genehmigungen, Berechtigungsvergaben, kryptografischen Aktionsbelegen und temporärer Ausführung.

Bevor Sie beginnen

  • Einen aktiven Agenten aus demselben Arbeitsbereich und derselben Umgebung wie Ihre Anmeldeinformationen verwenden.
  • Anfragen mit einem Workspace-API-Schlüssel oder einem angemeldeten Workspace-Benutzer erstellen.
  • Prüfer müssen aktive menschliche Workspace-Mitglieder mit der Workspace-Berechtigung tenant:governance:approve sein. Eine reine Organisationsrolle ist nicht ausreichend.
  • Der Anfragende kann seine eigene Anfrage nicht genehmigen oder ablehnen. Jeder Prüfer kann einmal entscheiden. API-Schlüssel können keine menschlichen Stimmen abgeben.
Öffnen Sie in der Console KI-Agenten → Agenten-Genehmigungen. Die Antrags-, Überprüfungs- und Stornierungsformulare haben jeweils eine eigene Seite. Speichern Sie den Antragslink, um dorthin zurückzukehren, nachdem er die Warteschlange verlassen hat.

Eine Anfrage erstellen

Dieses Beispiel fordert zwei unabhängige Genehmigungen innerhalb eines einstündigen Fensters an. Ersetzen Sie den Agent-Bezeichner durch einen vorhandenen Sandbox-Agenten; ein Produktions-Agent kann nicht mit einem Sandbox-Anmeldeinformationen verwendet werden.
Die 201-Antwort enthält id, requested_by, status: "pending", current_approvals: 0 und expires_at. Speichern Sie id; die Erstellung veröffentlicht den Bericht nicht und erstellt keinen Hintergrund-Workflow.

Überprüfung mit einer menschlichen Sitzung

Verwenden Sie die Console für interaktive Entscheidungen. Wenn Ihre Integration die API verwendet, geben Sie die kurzlebige Bearer-Sitzung des Prüfers für den Arbeitsbereich an. Ersetzen Sie keinen API-Schlüssel und betten Sie kein Sitzungstoken in den Quellcode ein.
Die erste Genehmigung in diesem Beispiel gibt status: "pending" und current_approvals: 1 zurück. Ein anderer autorisierter Prüfer muss die zweite Stimme abgeben. Die Wiederverwendung desselben Prüfers führt zu einem Konflikt. Eine Ablehnung ändert die Anfrage sofort in rejected, unabhängig von früheren Genehmigungen. Der Dienst überprüft aktuelle Mitgliedschaftsberechtigungen, Anfragenbesitz, Ablauf und bestehende Abstimmungen innerhalb der Entscheidungstransaktion. Abstimmungen und das Audit-Ereignis werden zusammen festgeschrieben. Entscheidungen können über diese APIs nicht bearbeitet oder gelöscht werden.

Ergebnis prüfen und durchsetzen

Die Detailantwort enthält die Prüferhistorie. Fahren Sie nur fort, wenn status approved ist und die Anfrage immer noch dem genauen Agenten, der Aktion, der Ressource und dem Umfang entspricht, die Ihre Anwendung verwenden möchte. Ihre Anwendung muss auch die aktuellen Zugriffsberechtigungen, den Agentenstatus und ihre eigenen Einmal- oder Wiederholungssteuerungen durchsetzen. Diese Genehmigungsdatensätze bieten keinen automatischen Ausführungs- oder Verbrauchsmechanismus. Die Überprüfungsfrist begrenzt, wann Entscheidungen eingereicht werden können. Sie verwandelt eine bereits genehmigte Anfrage nicht in ein ablaufendes Zugriffstoken. Definieren Sie jede Ausführungsfrist in Ihrer eigenen Anwendung.

Warteschlange, Stornierung und Fehler

GET /v1/approvals gibt ein Array von höchstens 100 ältesten ausstehenden, nicht abgelaufenen Anfragen zurück. Es hat keine Paginierung oder historischen Statusfilter. Die Warteschlange lässt die individuelle Entscheidungshistorie aus; rufen Sie eine Anfrage nach ID ab, um diese Historie zu erhalten. Der ursprüngliche Anfragende kann POST /v1/approvals/{approvalID}/cancel mit einem nicht leeren reason senden. Eine Anfrage kann nach Stornierung, Ablehnung, Genehmigung oder Ablauf nicht wieder geöffnet werden. Erstellen Sie eine neue Anfrage, wenn sich die vorgeschlagene Aktion ändert. Diese Aufzeichnungen unterstützen Ihren Überprüfungsprozess; sie begründen keine SOC 2-Konformität, ISO-Zertifizierung, Verifizierung von Identitätsdokumenten oder die Korrektheit der eingereichten Nachweise.