Intramedial está en beta restringida. Al registrarte o iniciar sesión, debes indicar la contraseña de beta tester que recibiste o solicitar una en preview@intramedial.com. Gracias.
Cargando…
coordination.haltMódulo 06
Módulo de la plataforma
Emergency stop switches
Detén al instante un agente, un mandato o un recurso, con un motivo registrado, y levanta la parada cuando sea seguro.
coordination.halt fija una parada en el camino crítico de admisión en uno de tres scopes: agent, mandate o resource. La siguiente admisión responde con un rechazo. Solo un administrador con sesión iniciada puede fijar o levantar una parada; la parada de todo el workspace es el interruptor aparte.
Intralock · Leases · Parley · Fleet Map
Un producto Trustvice
Los agentes actúan cuando el plano dice sí, y el registro dice por qué.
Pasa por Intramedial acciones de agentes, hashes de contenido, pruebas de API, DNS, webhooks, llamadas LLM y commits. Obtén un recibo firmado que cualquiera verifica, sin fiarse de nadie.
EstadoLos nombres del esquema de acción difieren de la ruta
El esquema coordination.stops.halt lista why, pero la ruta lee reason y rechaza una parada sin él. unhalt toma el id de la parada, no scope y target. Los agentes y tokens se rechazan en ambos casos.
Registro
El registro
Qué se registra
scope
Obligatorio. agent, mandate o resource. Cualquier otra cosa es un 400 que remite al interruptor kill.
target
Obligatorio. El DID, nombre de mandato o recurso a detener.
Pulsa Lanzar (⌘/Ctrl + Intro) para firmar la petición de la izquierda.
La primera ejecución crea una clave de prueba gratis en este navegador: unas 35 llamadas en 7 días, sin cuenta. El recibo vuelve aquí y se verifica con las claves publicadas, sin fiarte de nosotros.
Código
Ejemplo en vivo
Una petición real
Una petición con la forma que acepta la API y una respuesta de ejemplo con la forma que devuelve el módulo.
Detén al agente con un motivo. Su siguiente escritura se rechaza en la admisión con quarantine, sin cambiar sus grants.
Un mandato defectuoso
Detén el mandato por su nombre. Sus grants dejan de admitir al instante, mientras los grants de otros mandatos siguen funcionando.
Congelar un repositorio
Detén repo:payments. Todo lo que hay debajo se rechaza con resource_halted hasta que se levante la parada.
Detenerlo todo
Usa kill. Activa el interruptor de coordinación del workspace, y la admisión responde kill_switch a todos los agentes hasta resume.
Cuándo usar otra cosa
Poner en cuarentena a un agente bajo una autorización o dictamen. Eso es coordination.quarantine, que necesita control dual o un caso adjudicado.
Pausar a la espera de una decisión humana sobre una acción. Las escrituras retenidas van a coordination.approve; una parada es un rechazo general.
Encontrar qué se porta mal. watchdog.check señala anomalías; una parada es lo que haces cuando ya lo sabes.
Evidencia
Garantías
Qué hace y qué no hace
Un módulo es una afirmación fuerte sobre algo acotado. Confía en él exactamente para lo que es.
Hace
Una parada se comprueba en el camino crítico de admisión sin llamada a un modelo, así que la siguiente decisión tras fijarla es el rechazo.
Cada parada lleva un motivo y el administrador que la fijó, y cada parada nueva añade un evento coordination.halt al ledger.
Una parada repetida sobre el mismo scope y target no crea nada y devuelve la parada existente.
Levantar una parada se registra en el ledger como coordination.unhalt con el administrador, el scope y el target.
No hace
Que el agente haya dejado de ejecutarse. Una parada rechaza sus admisiones; el proceso no se mata y aún puede actuar fuera del plano.
Que se deshagan las acciones ya admitidas. Una parada no es un rollback, y no libera un lease concedido antes.
Que el interruptor kill esté disponible. Necesita KILL_SWITCH_KV vinculado; sin él kill y resume responden 503.
Detalles
Notas de construcción
Antes de construir
Quién puede detener
halt, unhalt, kill y resume son para una persona con sesión iniciada que administre el workspace. Un agente o token de API se rechaza con 403.
Orden de admisión
Las paradas de cuarentena y de recurso se comprueban primero, luego la confirmación, los grants y por último una parada de mandato. Un interruptor kill rechaza antes que cualquiera de ellos.
El interruptor kill
kill toma un reason opcional y registra coordination.kill. resume lo borra; un interruptor que fijó el operador es del operador y devuelve 409.
Leer la lista
switches también muestra los agentes en cuarentena que no tienen fila de parada, como uno puesto en cuarentena por un dictamen, como q:<did> con un motivo vacío.
Límites y medición
Existen tres scopes: agent, mandate y resource. Detener todo el workspace es el interruptor kill.
Una parada sin reason o sin target devuelve 400, igual que una parada de recurso sobre * o /.
Un rol que no sea administrador recibe 403 en halt y unhalt; leer switches no necesita rol.
Los ids levantados se recuerdan hasta los últimos 200.
Acceso
API y MCP
REST y MCP
Autentícate con una clave de API del workspace como token Bearer. La URL base es https://api.intramedial.com.
Endpoints REST
POST/api/v1/acp/coordination/haltDetiene un agente, un mandato o un recurso.
POST/api/v1/acp/coordination/unhaltLevanta una parada por su id.
GET/api/v1/acp/coordination/switchesLee el interruptor kill y todas las paradas vigentes.
POST/api/v1/acp/coordination/killActiva el interruptor kill de coordinación del workspace.
POST/api/v1/acp/coordination/resumeVuelve a activar la coordinación del workspace.
Acciones MCP
MCPcoordination.stops.haltFija una parada desde una llamada de acción; se rechaza salvo que quien llama sea administrador.
MCPcoordination.stops.unhaltLevanta una parada desde una llamada de acción.
MCPcoordination.stops.switchesLee los interruptores de parada desde un agente.
MCPcoordination.killActiva el interruptor kill desde una llamada de acción.
Módulo de la plataforma
