O Intramedial está em beta restrito. Ao se cadastrar ou entrar, você precisa informar a senha de beta tester que recebeu ou solicitar uma em preview@intramedial.com. Obrigado.
Carregando…
coordination.haltMódulo 06
Módulo da plataforma
Emergency stop switches
Pare um agente, um mandato ou um recurso de uma vez, com um motivo registrado, e levante a parada quando for seguro.
coordination.halt define uma parada no caminho quente da admissão em um de três escopos – agent, mandate ou resource. A próxima admissão responde com uma recusa. Só um administrador conectado pode definir ou levantar uma parada; a parada do workspace inteiro é o interruptor , à parte.
Intralock · Leases · Parley · Fleet Map
Um produto da Trustvice
Os agentes agem quando o plano diz sim, e o registo diz porquê.
Passe ações de agentes, hashes de conteúdo, checagens de API, DNS, webhooks, chamadas de LLM e commits git pela Intramedial. Receba um recibo assinado que todos verificam – sem confiar em nós.
O esquema coordination.stops.halt lista why, mas a rota lê reason e recusa uma parada sem ele. unhalt recebe o id da parada, não scope e target. Agentes e tokens são recusados de qualquer forma.
Registro
O registro
O que é registrado
scope
Obrigatório. agent, mandate ou resource. Qualquer outro valor é um 400 que aponta para o kill switch.
target
Obrigatório. O DID, nome de mandato ou recurso a parar.
Clique em Rodar (ou ⌘/Ctrl + Enter) e assine a requisição ao lado.
A primeira execução cria uma chave de teste grátis neste navegador: cerca de 35 chamadas em 7 dias, sem conta. O recibo volta aqui e é verificado com as chaves publicadas, sem confiar em nós.
Código
Exemplo ao vivo
Uma requisição real
Uma requisição no formato que a API aceita e um exemplo de resposta no formato que o módulo devolve.
Pare o agente com um motivo. Sua próxima escrita é recusada na admissão com quarantine, sem mudar suas concessões.
Um mandato ruim
Pare o mandato pelo nome. Suas concessões deixam de admitir na hora, enquanto as concessões de outros mandatos continuam funcionando.
Congelar um repositório
Pare repo:payments. Tudo abaixo dele é recusado com resource_halted até a parada ser levantada.
Parar tudo
Use kill. Ele aciona o interruptor de coordenação do workspace, e a admissão responde kill_switch para todo agente até resume.
Quando usar outra coisa
Pôr um agente em quarentena sob um mandado ou decisão. Isso é coordination.quarantine, que exige controle duplo ou um caso arbitrado.
Pausar para uma decisão humana sobre uma ação. Escritas retidas vão para coordination.approve; uma parada é uma recusa geral.
Descobrir o que está se comportando mal. watchdog.check sinaliza anomalias; um halt é o que se faz depois de saber.
Evidência
Garantias
O que faz e o que não faz
Um módulo é uma afirmação forte sobre algo estreito. Confie nele exatamente pelo que ele é.
Faz
Uma parada é conferida no caminho quente da admissão sem chamada a modelo, então a decisão seguinte à sua definição já é a recusa.
Toda parada leva um motivo e o administrador que a definiu, e cada nova parada acrescenta um evento coordination.halt ao ledger.
Um halt repetido no mesmo escopo e alvo não cria nada e devolve a parada existente.
Levantar uma parada é registrado no ledger como coordination.unhalt com o administrador, o escopo e o alvo.
Não faz
Que o agente tenha parado de rodar. Um halt recusa suas admissões; o processo não é morto e pode ainda agir fora da plataforma.
Que ações já admitidas sejam desfeitas. Um halt não é um rollback, e um lease concedido antes não é liberado por ele.
Que o kill switch esteja disponível. Exige KILL_SWITCH_KV vinculada; sem ela kill e resume respondem 503.
Detalhes
Notas de construção
Antes de construir
Quem pode parar
halt, unhalt, kill e resume são para uma pessoa conectada que administra o workspace. Um agente ou token de API é recusado com 403.
Ordem da admissão
Quarentena e paradas de recurso são conferidas primeiro, depois a confirmação, as concessões e por fim uma parada de mandato. Um kill switch recusa antes de todos.
O kill switch
kill recebe um reason opcional e registra coordination.kill no ledger. resume o limpa; um interruptor definido pelo operador é dele para levantar e devolve 409.
Ler a lista
switches também mostra agentes em quarentena sem linha de halt, como um agente em quarentena por uma decisão, como q:<did> com motivo vazio.
Limites e medição
Existem três escopos: agent, mandate e resource. Parar o workspace inteiro é o kill switch.
Uma parada sem reason ou sem target devolve 400, assim como uma parada de recurso em * ou /.
Um papel que não é administrador recebe 403 em halt e unhalt; ler switches não exige papel.
Os ids levantados são lembrados até os últimos 200.
Acesso
API e MCP
REST e MCP
Autentique-se com uma chave de API do workspace como token Bearer. A URL base é https://api.intramedial.com.
Endpoints REST
POST/api/v1/acp/coordination/haltPare um agente, um mandato ou um recurso.
POST/api/v1/acp/coordination/unhaltLevante uma parada pelo seu id.
GET/api/v1/acp/coordination/switchesLeia o kill switch e cada halt em vigor.
POST/api/v1/acp/coordination/killAcione o kill switch de coordenação do workspace.
POST/api/v1/acp/coordination/resumeLigue de volta a coordenação do workspace.
Ações MCP
MCPcoordination.stops.haltDefina uma parada a partir de uma chamada de ação; recusada a menos que o chamador seja administrador.
MCPcoordination.stops.unhaltLevante uma parada a partir de uma chamada de ação.
MCPcoordination.stops.switchesLeia os interruptores de parada a partir de um agente.
MCPcoordination.killAcione o kill switch a partir de uma chamada de ação.