# Notifications push avec validation humaine : approuvez un agent IA depuis votre téléphone

> Laissez un agent se mettre en pause avant toute action irréversible, recevez un bouton Approuver sur votre téléphone et attendez votre réponse. Un point de terminaison d’approbation de 25 lignes, un assistant Python et les limites à connaître.

*13.10.2026*

<!-- source: https://pocketalert.app/fr/blog/human-in-the-loop-notifications -->

Un agent capable de déployer, rembourser, supprimer ou envoyer des e-mails seul est utile jusqu’au moment où il fait l’une de ces choses de travers. La solution n’est pas de l’empêcher d’agir. Il faut lui faire demander avant, et rendre la demande assez simple pour que vous y répondiez réellement.

La validation humaine (human-in-the-loop) signifie exactement cela : l’agent s’arrête à un point de contrôle, une personne approuve ou refuse, et l’agent poursuit en fonction de la réponse. La difficulté ne vient pas de la logique. Elle tient à la façon de vous transmettre la question quand vous n’êtes pas à votre bureau, et de récupérer votre réponse sans ordinateur portable.

Ce guide s’appuie sur une notification push qui contient un bouton **Approuver**. L’agent l’envoie, attend, puis lit votre décision sur un petit point de terminaison appelé par le bouton.

## Fonctionnement de la boucle

Quatre éléments, tous simples :

1. L’agent atteint une étape risquée et crée une demande avec un identifiant aléatoire.
2. Il envoie une notification push Pocket Alert avec deux [boutons d’action](https://info.pocketalert.app/features/action-buttons.html). Chaque bouton est une requête HTTP vers votre point de terminaison d’approbation, qui transporte cet identifiant.
3. Vous appuyez sur la notification, lisez ce que l’agent veut faire, puis appuyez sur **Approuver** ou **Refuser**. Votre téléphone appelle directement le point de terminaison.
4. L’agent interroge le point de terminaison, prend connaissance de la décision, puis poursuit ou s’arrête.

Si personne ne répond avant l’expiration du délai, l’agent considère la réponse comme un refus. Une étape d’approbation qui part du principe que la réponse est « oui » n’est pas une garantie, seulement une notification.

## Ce dont vous avez besoin

- Un compte Pocket Alert avec une offre payante. Les boutons d’action sont retirés des messages sur l’offre gratuite : la notification arriverait donc sans eux. Starter coûte 6 $ par mois.
- Une clé API, à créer depuis [Clés API](/account/apikeys), idéalement une clé distincte pour l’agent.
- Un endroit où héberger un petit point de terminaison HTTPS accessible depuis votre téléphone. L’exemple utilise un Cloudflare Worker, gratuit à ce volume ; n’importe quel serveur convient.

## Étape 1. Le point de terminaison d’approbation

Le point de terminaison fait deux choses : il enregistre une décision lorsque le téléphone l’appelle, et il la communique lorsque l’agent la demande. Ce Worker conserve les décisions dans Workers KV pendant une heure :

```js
export default {
  async fetch(request, env) {
    if (request.headers.get('X-Approval-Secret') !== env.SECRET) {
      return new Response('forbidden', { status: 403 });
    }

    const [, action, id] = new URL(request.url).pathname.split('/');
    if (!/^[a-f0-9]{32}$/.test(id ?? '')) {
      return new Response('bad id', { status: 400 });
    }

    if (request.method === 'POST' && (action === 'approve' || action === 'decline')) {
      const existing = await env.DECISIONS.get(id);
      if (!existing) await env.DECISIONS.put(id, action, { expirationTtl: 3600 });
      return new Response(existing ?? action);
    }

    if (request.method === 'GET' && action === 'status') {
      return new Response((await env.DECISIONS.get(id)) ?? 'pending');
    }

    return new Response('not found', { status: 404 });
  },
};
```

Liez un espace de noms KV sous le nom `DECISIONS`, ajoutez un `SECRET` long et aléatoire comme secret du Worker, puis déployez. Trois détails sont volontaires :

- **La première réponse l’emporte.** Un second appui, ou un appui sur l’autre bouton, ne peut pas modifier une décision déjà enregistrée. Pocket Alert ne bloque pas les appuis répétés sur un bouton `http`, c’est donc au point de terminaison de le faire.
- **Le secret voyage dans un en-tête**, défini dans le bouton lui-même. Le téléphone l’envoie, l’agent l’envoie, personne d’autre ne le possède.
- **Les décisions expirent.** Une approbation d’hier ne doit rien débloquer aujourd’hui.

Workers KV est à cohérence à terme : l’agent peut ne pas voir une décision avant 60 secondes ou plus après votre appui. Pour une étape d’approbation, cela convient ; si vous avez besoin d’un résultat instantané, n’importe quel serveur avec une base de données ou un Durable Object fait le même travail.

## Étape 2. Demander depuis l’agent

L’assistant ci-dessous envoie la notification, interroge le point de terminaison pour obtenir une décision et ne renvoie `True` qu’en cas d’approbation explicite. Il fonctionne avec n’importe quel agent Python : un outil LangChain, une fonction du SDK OpenAI Agents, une simple boucle.

```python
import json
import os
import time
import uuid

import requests

PUSH_API = "https://api.pocketalert.app/v1/messages"
APPROVALS = "https://approvals.YOUR_SUBDOMAIN.workers.dev"
SECRET = os.environ["APPROVAL_SECRET"]

def ask_human(title: str, details: str, timeout: int = 900) -> bool:
    request_id = uuid.uuid4().hex

    def button(label: str, action: str) -> dict:
        return {
            "type": "http",
            "label": label,
            "value": json.dumps({
                "url": f"{APPROVALS}/{action}/{request_id}",
                "method": "POST",
                "headers": {"X-Approval-Secret": SECRET},
            }),
        }

    requests.post(
        PUSH_API,
        headers={"Token": os.environ["POCKETALERT_API_KEY"]},
        json={
            "title": title,
            "message": details,
            "level": "high",
            "actions": [button("Approve", "approve"), button("Decline", "decline")],
        },
        timeout=10,
    ).raise_for_status()

    deadline = time.time() + timeout
    while time.time() < deadline:
        status = requests.get(
            f"{APPROVALS}/status/{request_id}",
            headers={"X-Approval-Secret": SECRET},
            timeout=10,
        ).text
        if status in ("approve", "decline"):
            return status == "approve"
        time.sleep(5)
    return False
```

Placez-le ensuite devant toute action que vous ne voudriez pas voir l’agent exécuter sans supervision :

```python
if ask_human("Deploy to production?", "build #482 · 14 files · all checks green"):
    deploy()
else:
    report("Deploy skipped: not approved")
```

`level: "high"` envoie la notification comme urgente, ce qui lui permet de passer le mode Concentration sur iPhone et de s’afficher en bannière sur Android. Une approbation que vous voyez une heure plus tard, c’est une approbation pour laquelle l’agent a attendu une heure.

## Ce que vous voyez sur le téléphone

La notification affiche le titre et les détails rédigés par l’agent, ainsi que **Approuver** et **Refuser** directement sur la notification. Appuyez longuement dessus sur iPhone ou développez-la sur Android, puis choisissez une action : la requête part en arrière-plan, sans ouvrir l’application, même si Pocket Alert est fermée. Les mêmes boutons sont présents dans le message, dans l’application, où un bref message indique le code de statut renvoyé par votre point de terminaison.

Deux particularités des plateformes méritent d’être connues avant de vous y fier :

- **Si la requête échoue**, parce que votre point de terminaison a renvoyé une erreur ou que le téléphone n’avait pas de réseau, une nouvelle notification apparaît avec un bouton **Réessayer**. Une requête susceptible d’avoir atteint votre point de terminaison n’est jamais relancée automatiquement, donc un appui ne peut pas approuver deux fois à votre insu.
- **Les boutons des notifications système nécessitent l’application Pocket Alert 2.0.1 ou ultérieure.** Sur les anciennes versions, la bannière n’affiche aucun bouton et ceux-ci restent dans le message. Vos libellés sont affichés tels quels sur les deux plateformes ; si iOS ne peut pas préparer les boutons personnalisés à temps, il utilise un libellé générique **Exécuter** pour `http`, et le bouton fonctionne quand même.

## Où placer les points de contrôle

Si vous demandez trop souvent, vous finirez par approuver sans lire. Les bons points de contrôle sont les actions difficiles à annuler ou qui coûtent réellement de l’argent :

- Déploiements et migrations de base de données en production
- Envoi d’e-mails, publication publique ou messages aux clients
- Remboursements, achats et tout appel à une API de paiement
- Suppression de données, rotation de clés, modification du DNS ou des permissions
- Exécutions susceptibles de dépasser un budget de jetons ou de cloud défini

Tout le reste gagne à être une simple notification envoyée après coup. La page [Alertes d’agent IA](/use-cases/ai-agent-alerts) traite de ce volet : terminé, échoué, bloqué.

## Passer par MCP

Si l’agent fonctionne dans un client MCP, il peut envoyer la même notification sans l’assistant Python. Le [serveur MCP Pocket Alert](/tools/mcp) expose `create_message` avec un paramètre `actions` : vous pouvez donc demander à l’agent de l’appeler avec les deux boutons, puis de consulter l’URL de statut avant de poursuivre.

Cela fonctionne, avec une réserve : c’est désormais à l’agent d’attendre, et un modèle à qui l’on demande d’attendre une approbation peut toujours décider de ne pas le faire. Pour tout ce qui compte, imposez le point de contrôle dans du code que le modèle ne peut pas contourner, comme l’assistant ci-dessus ou un hook de permissions dans [Claude Code](/blog/claude-code-push-notifications) ou [Codex](/blog/codex-notifications). Utilisez MCP pour la question et du code pour la barrière.

## Variantes

- **Bouton unique.** N’envoyez que **Approuver** et faites en sorte que le silence signifie « non ». Il n’y a alors aucun bouton à mal toucher sur la bannière, et refuser ne vous coûte rien.
- **Outils d’automatisation.** Dans n8n, un nœud Wait configuré pour reprendre à l’appel d’un webhook vous fournit une URL de reprise ; placez-la dans le bouton Approuver, et le workflow reprend quand vous appuyez.
- **Contexte dans la notification.** Indiquez les chiffres dans le message : le montant, l’environnement, le nombre de lignes. Vous devez pouvoir décider à partir du seul texte.
- **Un bouton de consultation.** Remplacez Refuser par un bouton `view` qui ouvre le diff, la facture ou l’exécution, et refusez simplement en n’approuvant pas.

## FAQ

### L’approbation fonctionne-t-elle depuis l’écran verrouillé ?

Oui. Les boutons `http` s’exécutent depuis l’écran verrouillé sans déverrouiller le téléphone, que Pocket Alert soit ouverte, en arrière-plan ou fermée. Sur Android, cela suppose un écran de verrouillage configuré pour afficher le contenu des notifications ; s’il masque le contenu, les boutons apparaissent après le déverrouillage. Si c’est trop facile pour une action risquée, placez la décision derrière un bouton `view` qui ouvre une page où il faut vous connecter : l’ouverture d’une page demande d’abord le déverrouillage.

### Est-ce sécurisé ?

La requête du bouton part directement de votre téléphone vers votre point de terminaison ; Pocket Alert ne la relaie pas et ne voit pas la réponse. Protégez le point de terminaison avec un en-tête secret, utilisez un identifiant aléatoire par requête, n’acceptez que la première réponse et faites expirer les décisions. Les messages, y compris la configuration des boutons, sont chiffrés au repos.

### Que se passe-t-il si je ne réponds jamais ?

L’assistant renvoie `False` à l’expiration du délai, 15 minutes par défaut, et l’agent doit traiter cela comme un refus. Choisissez un délai adapté à la durée d’attente raisonnable de la tâche.

### Plusieurs personnes peuvent-elles approuver ?

Chaque appareil du compte reçoit la notification, et le premier appui l’emporte. Pour des approbations individuelles, envoyez à chaque personne sa propre notification avec un identifiant de requête distinct, et définissez dans le point de terminaison le nombre d’approbations nécessaires.

### Cela fonctionne-t-il sur Android et iPhone ?

Oui, sur les deux, avec vos propres libellés dans la notification et dans le message. Les boutons des notifications système nécessitent la version 2.0.1 de l’application ou une version ultérieure.

[Obtenez une clé API](/signup), déployez le point de terminaison et donnez à votre agent un moyen de demander avant d’agir.
