Passer au contenu principal
Les approbations d’agent enregistrent les décisions humaines concernant une action d’agent proposée dans un environnement d’espace de travail. Elles sont distinctes des approbations du moteur de workflow, des octrois d’autorisations, des reçus d’action cryptographiques et de l’exécution temporelle.

Avant de commencer

  • Utiliser un agent actif du même espace de travail et environnement que votre identifiant.
  • Créez des requêtes en utilisant une clé API d’espace de travail ou un utilisateur d’espace de travail connecté.
  • Les réviseurs doivent être des membres humains actifs de l’espace de travail avec la permission tenant:governance:approve au niveau de l’espace de travail. Un rôle réservé à l’organisation est insuffisant.
  • Le demandeur ne peut pas approuver ou rejeter sa propre demande. Chaque réviseur peut décider une fois. Les clés API ne peuvent pas exprimer de votes humains.
Dans la Console, ouvrez Agents IA → Approbations d’agents. Les formulaires de demande, d’examen et d’annulation ont chacun une page dédiée. Enregistrez le lien de la demande pour y revenir après qu’elle ait quitté la file d’attente en attente.

Créer une demande

Cet exemple demande deux approbations indépendantes dans une fenêtre d’une heure. Remplacez l’identifiant de l’agent par un agent sandbox existant ; un agent de production ne peut pas être utilisé avec une accréditation sandbox.
La réponse 201 contient id, requested_by, status: "pending", current_approvals: 0 et expires_at. Enregistrez id ; la création ne publie pas le rapport et ne crée pas de flux de travail en arrière-plan.

Examiner avec une session humaine

Utilisez la Console pour les décisions interactives. Si votre intégration utilise l’API, fournissez la session de porteur de l’espace de travail de courte durée du réviseur. Ne substituez pas une clé API et n’intégrez pas de jeton de session dans le code source.
La première approbation dans cet exemple renvoie status: "pending" et current_approvals: 1. Un autre réviseur autorisé doit fournir le second vote. La réutilisation du même réviseur renvoie un conflit. Un rejet modifie immédiatement la requête en rejected quelles que soient les approbations antérieures. Le service vérifie les permissions d’adhésion actuelles, la propriété de la demande, l’expiration et les votes existants au sein de la transaction de décision. Les votes et l’événement d’audit sont validés ensemble. Les décisions ne peuvent pas être modifiées ou supprimées via ces API.

Vérifier et appliquer le résultat

La réponse détaillée inclut l’historique du réviseur. Ne continuez que lorsque status est approved et que la requête correspond toujours exactement à l’agent, à l’action, à la ressource et à la portée que votre application a l’intention d’utiliser. Votre application doit également appliquer les autorisations d’accès actuelles, le statut de l’agent et ses propres contrôles d’utilisation unique ou de relecture. Ces enregistrements d’approbation ne fournissent pas de mécanisme d’exécution ou de consommation automatique. La date limite de révision limite le moment où les décisions peuvent être soumises. Elle ne transforme pas une demande déjà approuvée en un jeton d’accès expirant. Définissez toute date limite d’exécution dans votre propre application.

File d’attente, annulation et erreurs

GET /v1/approvals renvoie un tableau d’au plus 100 requêtes en attente les plus anciennes et non expirées. Il n’a pas de pagination ni de filtre d’état historique. La file d’attente omet l’historique des décisions individuelles ; récupérez une requête par ID pour cet historique. Le demandeur original peut envoyer POST /v1/approvals/{approvalID}/cancel avec un reason non vide. Une demande ne peut pas être rouverte après annulation, rejet, approbation ou expiration. Créez une nouvelle demande si l’action proposée change. Ces enregistrements soutiennent votre processus d’examen ; ils n’établissent pas la conformité SOC 2, la certification ISO, la vérification de documents d’identité ou l’exactitude des preuves soumises.