Questions pour développeurs

HumanLayer est une API d'orchestration de décisions humaines.

Elle permet à un système (agent IA, backend, workflow engine) de :

• soumettre un dossier de décision
• attendre une validation humaine qualifiée
• recevoir une réponse structurée
• avec un audit trail complet

👉 Pour un développeur, HumanLayer est un service externe appelable, comme Stripe, Twilio ou Auth0 — mais pour la décision humaine.

Quand ton système arrive à un point où :

• une décision engage une responsabilité humaine
• une règle n'est plus suffisante
• une signature ou une validation est requise
• ou quand tu veux une preuve formelle de validation

Règle simple :

Si tu hésites à automatiser → appelle HumanLayer.

Oui, nativement.

HumanLayer est conçu pour :

• être appelé comme un tool
• fonctionner dans des boucles agentiques
• être utilisé par des LLMs sous contrôle

Exemple mental :

if confidence < threshold or risk == "high":
    decision = humanlayer.request(...)

Les deux.

Asynchrone (recommandé)
Tu crées une demande de décision, tu continues ton workflow, tu écoutes les webhooks.

Synchrone (bloquant)
Possible pour des décisions rapides avec SLA court.

Dans tous les cas, les délais sont explicitement déclarés et contractuels.

Une décision est un objet structuré, avec :

• un type (compliance_check, expert_judgment, authorized_decision)
• un niveau (1, 2 ou 3)
• un contexte fourni par l'IA
• un statut (pending, approved, rejected, escalated, timeout)
• une justification humaine
• des métadonnées d'audit

👉 Ce n'est pas un texte libre. C'est un artefact exploitable par un système.

Uniquement :

• le contexte strictement nécessaire
• les éléments préparés par l'IA
• les champs requis pour décider

Pas d'accès global au système, pas de données inutiles.

👉 Minimisation by design.

Oui.

HumanLayer peut fonctionner avec :

• des Sentinels internes
• des Sentinels externes
• ou un mix des deux

Dans tous les cas, HumanLayer reste :

• la couche d'orchestration
• la source de vérité
• la preuve d'audit

HumanLayer gère :

• timeouts
• escalades automatiques
• refus par défaut
• fallback configurables

Le comportement est déterministe et configurable.

Ton code ne reste jamais bloqué indéfiniment.

Oui.

Tu peux définir :

• décisions binaires
• décisions conditionnelles
• décisions avec champs obligatoires
• décisions avec seuils

HumanLayer ne laisse pas de décisions ambiguës.

Oui.

Nativement :

• escalade automatique
• second Sentinel
• validation multi-signature
• quorum (selon configuration enterprise)

Non. Jamais.

HumanLayer :

• ne génère pas de décision
• ne modifie pas la réponse humaine
• ne "corrige" pas le Sentinel

Il orchestre, structure et trace.

• Authentification par API key / OAuth
• Scopes par type de décision
• Isolation par organisation
• Journaux d'accès
• Chiffrement en transit et au repos

Les Sentinels n'ont accès qu'aux dossiers qui leur sont assignés.

Tu peux extraire :

• l'historique complet des décisions
• les justifications
• les horodatages
• les identités Sentinels

👉 Pas besoin de reconstituer à partir de logs applicatifs.

Un workflow classique :

• ne vérifie pas les qualifications
• n'engage pas la responsabilité
• ne fournit pas de preuve opposable
• n'est pas pensé pour l'IA

HumanLayer traite la décision comme un acte engageant, pas un clic.

Oui — là où c'est volontaire.

HumanLayer est appelé :

• uniquement sur des points critiques
• quand ralentir est préférable à prendre un risque

Partout ailleurs, ton système reste entièrement automatisé.

Parce que tu devrais construire :

• un système d'assignation
• une gouvernance humaine
• une traçabilité audit-grade
• des SLA décisionnels
• une intégration agent-native

👉 HumanLayer te fait gagner des mois, voire des années.