Agente de inteligencia API y documentación de MCP

Maetra es un avión de control de tiempo de ejecución para los agentes de IA. Utilice el servidor REST API o MCP para mantener el trabajo alineado con la tarea del usuario, pausar acciones sensibles para la aprobación de políticas o humanos, escanear contenido arriesgado, y preservar evidencia de lo que sucedió después de la aprobación.

¿Nuevo para Maetra? Comience con el Quickstart. ¿Conectar a un agente o asistente? Usar el Guía del servidor de MCP. ¿Necesitas un punto final? Saltar a la Referencia de API.

Los tres controles de tiempo de ejecución#

Task Guard

Alineación de tareas del agente de inteligencia artificial. Convierta los criterios objetivos, limitaciones, alcance y éxito del usuario en un contrato de tareas activo. Antes de una acción material, Task Guard comprueba si el trabajo está alineado, soportando, necesita una explicación, requiere confirmación del usuario, o debe ser reorientado. Después, puede comparar los efectos esperados e informados.

Govern

Aprobaciones humanas en el bucle y recibos de ejecución. Antes de que un agente mueva dinero, borra datos o envía correos electrónicos a un cliente, llama a Maetra. Las políticas exactas o la inteligencia de la decisión pueden aprobar, bloquear o enrutar la acción a un humano. Una decisión firmada está vinculada a la carga útil de acción exacta, y los recibos de ejecución pueden vincular esa aprobación a los intentos y el resultado observado.

Secure

Escaneo de contenido de tiempo de ejecución. Inyección rápida, exfiltración de datos, herramientas no autorizadas y salidas modelo contra sus reglas del espacio de trabajo (inyección rápida, exfiltración de datos, herramientas no autorizadas) y recuperar un veredicto (en inglés)safe, flagged, bloqueado) y una acción recomendada. Cualquier cosa insignia o bloqueada se convierte en un incidente.

Dos formas de integrar#

Ambos están respaldados por el mismo motor de evaluación y autenticados con la misma clave API del espacio de trabajo.

Lo que puedes construir#

• Agentes de pago y finanzas que no puede cambiar la cuenta, la cantidad o la moneda aprobada después del examen.
• Agentes de operaciones de clientes que pausa antes de reembolsos, cambios de cuenta o mensajes externos.
• Asistentes de larga duración que vuelva a revisar su contrato de tareas antes de las acciones materiales e informe de los efectos reales después.
• Agentes conectados con MCP que descubren sólo las herramientas de Task Guard, Govern y Secure habilitadas para su espacio de trabajo y API clave.

La aprobación y ejecución son hechos separados. Un token de decisión demuestra lo que Maetra autorizó; un recepción de la ejecución registra cómo se intentó esa acción exacta y qué efecto se observó la evidencia.

Es bueno saberlo. No necesitas registrar a tus agentes primero. Cada punto final acepta un texto libre agent_name, para que pueda integrarse en minutos y registrar agentes más tarde para informar más rico. Govern todavía evalúa a los agentes de API y MCP contra las políticas de toda la organización; cuando agent_name o agent_id coincide con un agente registrado, se pueden aplicar políticas de agente-scopio. Véase Agentes.

Base URL#

All REST endpoints are versioned under /v1. El servidor MCP tiene su propia URL base — ver MCP vista general.

Siguientes pasos#

1. Crear una clave de API en el tablero.
2. Ejecute su primer punto de control y escaneo, conectar un cliente de MCP, iniciar una tarea de Task Guard.
3. Examine el referencia completa de API.