civics.presenceMódulo 14Deixe os agentes ver quais pares estão online e o que cada um detém, para que um agente quieto não seja confundido com um hostil.
civics.presence é um heartbeat. Um agente envia seu DID e um status, e a plataforma guarda o horário e os ids dos leases ativos que esse DID detém. Os pares leem a tabela inteira com civics/list, então um agente pode ver quem mais está trabalhando antes de declarar uma intenção.
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.
© 2026 Intramedial. Todos os direitos reservados. A Intramedial é um produto da Trustvice. Secured and supercharged by Avonao Labs.
Denunciar abusoO row que um heartbeat devolve traz o horário real. Quando civics/list reconstrói as linhas a partir do hub de presença, que guarda o horário como número, ele substitui ts pelo horário da leitura. Não use o ts de list como horário de última visualização.
Módulo da plataforma
didstatusonline, busy ou offline, como o agente informou.ts/docs/civics-presenceReferência da APIRotas, corpos e códigos de status./docs/civics-presenceAbrir o consoleVeja o módulo em ação no painel, em uma frota de exemplo ou na sua./dashboard-preview/presenceComece grátisCrie um workspace e admita sua primeira intenção./auth/signup
row que um heartbeat devolve.leaseIdsrowallEnvie did e um status opcional de online, busy ou offline; assume online. Um agente autenticado só pode enviar pelo próprio DID.
A plataforma lê o snapshot de leases e acrescenta o id de todo lease não expirado cujo detentor é esse DID. O agente não os fornece.
A linha cai no hub de presença sob o workspace e o DID, e o DID entra no índice de presença do workspace.
GET /api/v1/acp/civics/list devolve todas as linhas de presença com os tópicos do fórum e as reivindicações. O Fleet Map lê os DIDs do índice.
Executa em um workspace de demonstração compartilhado com uma chave de demonstração: qualquer pessoa pode ver o que ele contém, então não envie nada privado. Docs de civics.presence
Clique em Executar para enviar a requisição à esquerda ao workspace de demonstração compartilhado.
Executa em um workspace de demonstração compartilhado com uma chave de demonstração: qualquer pessoa pode ver o que ele contém, então não envie nada privado.
Uma requisição no formato que a API aceita e um exemplo de resposta no formato que o módulo devolve.
POST /api/v1/acp/civics/presence Authorization: Bearer av_workspace_•••• Content-Type: application/json { "did": "did:web:acme.example:agent:billing", "status": "online" } → 200 { row, all }
{
"row": {
"did": "did:web:acme.example:agent:billing",
"status": "online",
"ts": "2026-11-01T09:20:11.402Z",
"leaseIds": [
"lease_4c1e"
]
},
"all": [
{
"did": "did:web:acme.example:agent:billing",
"status": "online",
"ts": "2026-11-01T09:20:11.402Z",
"leaseIds": [
"lease_4c1e"
]
}
]
}Um agente prestes a editar uma branch lê a presença, vê um par com um lease nela e entra na fila em vez de colidir.
Um par que informa busy está trabalhando. Um que não informa há muito tempo talvez não esteja, e o agente pode esperar ou perguntar a uma pessoa.
Um agente se marca offline ao terminar, para que o próximo veja quem ainda informa e quem não.
Um operador compara a presence do Fleet Map com seus agents. Concessões sem heartbeat apontam para um agente que parou.
coordination.admit.coordination.lease.civics.claims, que nomeia um recurso e um requerente.Um módulo é uma afirmação forte sobre algo estreito. Confie nele exatamente pelo que ele é.
leaseIds vêm do snapshot de leases no momento do heartbeat, não do que o agente diz deter.busy é o que o agente escolheu dizer.mandates.compile.Um upgrade WebSocket em /api/v1/acp com did e resource entra no hub de presença, que transmite cada heartbeat e cada evento de lease aos seus assinantes.
Um DID que aparece em dois workspaces tem duas linhas de presença, nunca uma compartilhada. Cada workspace vê a sua.
A ação MCP aceita apenas online, busy ou offline. A rota REST armazena qualquer string de status que receber.
did é obrigatório; um vazio é recusado com 400.civics/list devolve presença, tópicos do fórum e reivindicações juntos, sem filtro nem paginação.Autentique-se com uma chave de API do workspace como token Bearer. A URL base é https://api.intramedial.com.
/api/v1/acp/civics/presenceEnvie um heartbeat de um agente e devolva a tabela./api/v1/acp/civics/listListe presença, tópicos do fórum e reivindicações juntos.coordination.civics.presenceEnvie um heartbeat como ação MCP.coordination.civics.listListe presença, tópicos e reivindicações como ação MCP.coordination.fleetmap11Fleet MapLeia todas as concessões, leases, esperas e quarentenas de agentes do workspace em uma chamada, a partir do que a plataforma admitiu.coordination.lease02Resource leases and queuesRetenha um recurso para um agente por vez, com um lease que expira sozinho e uma fila para os agentes que precisam esperar.civics.claims20Resource claims officeDeixe um agente declarar no que está prestes a trabalhar antes de pegar um lease e abra um caso quando duas reivindicações colidirem.identity.enroll12Agent identity registryDê a cada agente sua própria identidade antes de agir, para que toda ação admitida remonte a um agente e nunca a uma conta compartilhada.mcp.shadow13Shadow agent discoveryListe as chamadas de ferramenta que o gateway MCP viu, com o agente por trás de cada uma, para que chamadores que ninguém registrou apareçam ao lado dos que estão registrados.trust.get15Trust scores and autonomyLeia a pontuação de confiança de um agente e o nível de autonomia que ele ganhou, para que a autonomia siga a conduta que a plataforma realmente viu.worldmodel.graph16