Portes d'approbation
Certain appels d’outils ne devraient pas se produire sans qu’un humain dise oui — envoyer du courrier, publier dans un canal, apporter des changements ayant des conséquences dans le monde réel. AiHummer’s portes d’approbation mettez une personne dans la boucle avant que de tels outils ne s’exécutent, et associez-les à des effets secondaires idempotents afin que l’approbation d’un tour récupéré ne déclenche jamais la même action deux fois.
Niveau : Les passerelles d’approbation sont un contrôle payant, pas gratuit/à l’échelle de la plateforme.
| Fonctionnalité | Niveau |
|---|---|
| Portes d’approbation | De niveau entreprise (Business+/Enterprise) |
Comment fonctionne la porte
Vous déclarez quels outils nécessitent une approbation avec le AIHUMMER_APPROVAL_TOOLS paramètre — une liste de noms d’outils. Lorsque l’agent décide d’appeler l’un de ces outils, l’exécution s’arrête et une demande d’approbation est générée pour qu’un humain puisse la vérifier.
# /home/.aihummer/etc/gateway.env
# Comma-separated list of tools that require approval before execution
AIHUMMER_APPROVAL_TOOLS=mail,http_requestLa demande en attente apparaît dans l’interface administrateur et l’API administrateur (/v1/admin/approvals), où un examinateur voit l’outil, ses arguments et le contexte, puis l’approuve ou le rejette.
Approuver signifie exécuter, rejeter signifie ne pas exécuter
La porte est sans ambiguïté :
- Approuver — l’outil s’exécute avec exactement les arguments qui ont été examinés.
- Rejeter — l’outil est non exécuté. Il n’y a pas de partiel ni de différé exécution ; un appel rejeté ne se produit tout simplement pas, et le tour continue sans cet effet secondaire.
[!NOTE] Un rejet est un arrêt brutal pour cet appel spécifique. L’agent ne reste pas silencieux réessayer l’action rejetée derrière le dos du réviseur.
Pourquoi cela est sûr pendant la récupération
Les portails d’approbation s’associent avec ceux de AiHummer effets secondaires idempotents. Un tour peut être interrompu (un redémarrage, un plantage) puis récupéré. Sans protection, un tour récupéré pourrait réémettre une action qui s’est déjà produite — envoyer le même e-mail deux fois, publier le même message à nouveau.
AiHummer empêche cela avec un clé de grand livre stable de résumé et un barrière d’effet secondaireChaque effet secondaire est enregistré sous une clé stable, et la barrière refuse de réexécuter un effet que le registre indique comme déjà effectué.
[!TIP] Le gain pratique : approuver un tour récupéré le fait pas double-feu mail ou envoi par canal. La barrière garantit que l’effet se produit exactement une fois, que le tour ait été récupéré ou non.
Voir Multilocativité et idempotence pour la mécanique complète du grand livre et de la barrière des effets secondaires.
Choisir quels outils verrouiller
Outils de porte dont les effets sont visibles de l’extérieur ou difficiles à annuler. Bons candidats :
mail— e-mail sortant.- Envoi via canal / livraison sortante aux clients ou au personnel.
http_requestet d’autres outils qui peuvent muter des systèmes externes.code_execsur des hôtes partagés (également désactivé par défaut là-bas).
Les outils en lecture seule (recherche, consultation des connaissances, temps) n’ont généralement pas besoin de barrières. Combinez les barrières d’approbation avec le mode isolé et contrôles de sortie pour les outils qui atteignent l’internet public.
Où aller ensuite
- Multilocativité et idempotence — le grand livre et la barrière d’effets secondaires derrière les effets exactement une fois.
- Garde-fous et défense contre l’injection d’instructions — garder le modèle d’être dirigé pour appeler un outil protégé de manière malveillante.
- Réseau, audit et réseau isolé — restreindre ce que les outils peuvent atteindre.