# API Task Guard

Task Guard maintient les agents d'IA connectés alignés sur la tâche active autorisée par l'utilisateur. Il transforme l'objectif, les contraintes, la portée, les décisions et les critères de succès en un contrat de travail en version, puis évalue les actions matérielles par rapport à ce contrat avant qu'ils ne soient exécutés.

Task Guard est disponible aussi bien sur l'API REST que sur l'API REST. [Serveur Maetra MCP](https://maetra.io/fr/docs/mcp-server/tools-reference).

### Ce qu'Task Guard contrôle

1. **Commencez la tâche.** Créer un contrat de tâche actif à partir d'une instruction directe de l'utilisateur.
2. **Rafraîchir le contexte.** Récupérer le contrat actuel après un nouveau virage, redémarrage ou compactage de contexte.
3. **Vérifiez les actions.** Évaluer si chaque action matérielle est alignée, appuyée, ambiguë, une modification de portée ou non.
4. **Résoudre les incertitudes.** Expliquez une relation de soutien ou demandez à l'utilisateur de la session de confirmer un changement de tâche important.
5. **Vérifier les effets.** Comparez ce qu'une action autorisée devait changer avec ce qui s'est réellement passé.
6. **Comptabiliser les progrès accomplis et les compléter.** Gardez l'ancre de la tâche à jour et fermez la tâche lorsque ses critères de succès sont respectés.

> **Important**
> La confirmation d'Task Guard n'est pas une approbation Govern. Task Guard demande si le travail appartient à la tâche active de l'utilisateur. [Govern](https://maetra.io/fr/docs/govern-api) décide si une action consécutive nécessite une évaluation des politiques ou une approbation humaine. Lorsque les deux cas s'appliquent, satisfaire aux deux contrôles.


### Intégrations consultatives et forcées

| Mode | Comportement |
| ---- | --------- |
| `ADVISORY` | L'hôte appelle Task Guard et suit le verdict rendu et `next_action`. |
| `ENFORCED` | L'hôte doit utiliser des transitions utilisateur-événement de confiance et peut exiger un jeton d'alignement de courte durée pour correspondre à l'action exacte avant l'exécution. |

Utilisation `CUSTOM_API` pour une intégration REST personnalisée, `CUSTOM_MCP` pour votre propre hôte MCP, ou la première partie `CODEX` / `CLAUDE` les types d'hôtes.

### Couvertures Task Guard

| Portée | Utilisé pour |
| ----- | -------- |
| `task_guard:tasks:write` | Commencez les tâches, enregistrez les progrès, l'état du cycle de vie de la transition et accomplissez les tâches. |
| `task_guard:tasks:read` | Récupérer le contexte des tâches. |
| `task_guard:checks:write` | Vérifier l'alignement, expliquer les relations et vérifier les jetons d'alignement. |
| `task_guard:effects:write` | Signaler les effets réels de l'action. |
| `task_guard:confirmations:write` | Soumettre des événements d'hôte de confiance et des confirmations d'utilisateur. |

Voir [Authentification](https://maetra.io/fr/docs/getting-started/authentication) pour les champs de caractères génériques et les identifiants de confirmation de confiance.

### Utilisation et facturation

Chaque demande d'outil Task Guard REST ou MCP authentifiée consomme une demande Task Guard de l'allocation d'espace de travail. L'essai gratuit comprend 50 demandes; Go comprend 1 500 par mois; Starter comprend 3 000; Équipe comprend 15 000; Business comprend 60 000. Les régimes payés peuvent permettre la facturation de l'utilisation de la paye au fur et à mesure que vous y allez après que l'indemnité incluse est épuisée.

Réessayer une demande avec la même `Idempotency-Key` en-tête, ou le même corps `idempotency_key` où supporté, pour éviter de consommer une autre unité pour un replay idémpotent.

### Ressources REST

L'API d'REST expose les tâches, le contexte, l'alignement, l'effet, la confirmation et les paramètres du cycle de vie prévus à la rubrique :

```
https://api.maetra.io/v1/task-guard
```

Le générique `POST /v1/task-guard/tools/{tool}` endpoint accepte également le même corps de requête que n'importe lequel des sept outils Task Guard:

```
start_task
get_task_context
check_task_alignment
explain_task_relationship
record_task_progress
record_action_effect
complete_task
```

Pour les intégrations normales d'REST, préférez les paramètres prévus documentés dans [Tâches et contexte](https://maetra.io/fr/docs/task-guard-api/tasks-and-context) et [Alignement et effets](https://maetra.io/fr/docs/task-guard-api/alignment-and-effects).