# Task Guard API

Task Guard mantiene conectados agentes de inteligencia artificial alineados con la tarea activa autorizada por el usuario. Convierte el objetivo, las limitaciones, el alcance, las decisiones y los criterios de éxito en un contrato de tareas versionado, luego evalúa las acciones materiales contra ese contrato antes de que se ejecuten.

Task Guard está disponible tanto en la API de REST como en la [Maetra MCP servidor](https://maetra.io/es/docs/mcp-server/tools-reference).

### Lo que Task Guard controla

1. **Comienza la tarea.** Crear un contrato de tarea activo de una instrucción de usuario directa.
2. **Refresh context.** Recuperar el contrato actual después de un nuevo giro, reiniciar o compactación de contexto.
3. **Comprueba las acciones.** Evaluar si cada acción material está alineada, apoyada, ambigua, un cambio de alcance o no relacionada.
4. **Resolver la incertidumbre.** Explique una relación de apoyo o pida al usuario de la sesión que confirme un cambio de tarea material.
5. **Verificar los efectos.** Compare lo que se esperaba que una acción permitida cambiara con lo que realmente sucedió.
6. **Grabar el progreso y completar.** Mantenga la tarea anclada y cierre la tarea cuando se cumplan sus criterios de éxito.

> **Important**
> La confirmación de Task Guard no es una aprobación de Govern. Task Guard pregunta si el trabajo pertenece a la tarea activa del usuario. [Govern](https://maetra.io/es/docs/govern-api) decide si una acción consiguiente requiere evaluación de políticas o aprobación humana. Cuando ambos se aplican, satisfaga ambos controles.


### Integraciones consultivas y aplicadas

| Modo | Comportamiento |
| ---- | --------- |
| `ADVISORY` | El anfitrión llama a Task Guard y sigue el veredicto devuelto y `next_action`. |
| `ENFORCED` | El host debe utilizar transiciones confiables de usuario-evento y puede requerir un token de alineación de corta duración para que coincida con la acción exacta antes de la ejecución. |

Uso `CUSTOM_API` para una integración personalizada de REST, `CUSTOM_MCP` para su propio anfitrión de MCP, o la primera fiesta `CODEX` / `CLAUDE` Tipos de host.

### Alcances de Task Guard

| Ámbito | Usado para |
| ----- | -------- |
| `task_guard:tasks:write` | Inicio de tareas, registro de progreso, estado del ciclo de vida de transición y tareas completas. |
| `task_guard:tasks:read` | Recuperar el contexto de la tarea. |
| `task_guard:checks:write` | Compruebe la alineación, explicar las relaciones y verificar las fichas de alineación. |
| `task_guard:effects:write` | Informe efectos de acción reales. |
| `task_guard:confirmations:write` | Presentar eventos de usuario de host de confianza y confirmaciones de usuario. |

Véase [Autenticación](https://maetra.io/es/docs/getting-started/authentication) para los alcances de Wildcard y las credenciales de confirmación confiables.

### Uso y facturación

Cada solicitud de herramientas de Task Guard REST o MCP autenticada consume una solicitud de Task Guard de la asignación del espacio de trabajo. El juicio gratuito incluye 50 solicitudes; Go incluye 1.500 por mes; Starter incluye 3.000; Equipo incluye 15.000; y Business incluye 60.000. Los planes pagados pueden permitir la facturación del uso de los pagos después de que se agote el subsidio incluido.

Retratar una solicitud con la misma `Idempotency-Key` cabezal, o el mismo cuerpo `idempotency_key` donde se apoya, para evitar consumir otra unidad para una repetición idempotente.

### Recursos de REST

La API de REST expone tareas, contexto, alineación, efecto, confirmación y puntos finales del ciclo de vida bajo:

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

El genérico `POST /v1/task-guard/tools/{tool}` endpoint también acepta el mismo cuerpo de petición que cualquiera de las siete herramientas de Task Guard:

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

Para las integraciones normales de REST, prefiera los puntos finales construidos a propósito documentados en [Tareas y contexto](https://maetra.io/es/docs/task-guard-api/tasks-and-context) y [Alineación y efectos](https://maetra.io/es/docs/task-guard-api/alignment-and-effects).