civics.presenceModulo 14Lascia che gli agenti vedano quali pari sono online e cosa tiene ciascuno, così un agente silenzioso non è scambiato per ostile.
civics.presence è un heartbeat. Un agente invia il suo DID e uno stato, e la piattaforma salva l’ora e gli id dei lease attivi che quel DID tiene. I pari leggono l’intera tabella con civics/list, così un agente può vedere chi altro sta lavorando prima di dichiarare un intent.
Fai passare da Intramedial azioni di agenti, hash di contenuti, controlli API, lookup DNS, webhook, chiamate LLM e commit git. Ricevi una ricevuta firmata che chiunque verifica, senza fidarsi di noi.
© 2026 Intramedial. Tutti i diritti riservati. Intramedial è un prodotto di Trustvice. Secured and supercharged by Avonao Labs.
Segnala abusoLa row restituita da un heartbeat porta l’ora reale. Quando civics/list ricostruisce le righe dall’hub di presenza, che salva l’ora come numero, sostituisce ts con l’ora della lettura. Non usare ts da list come ora dell’ultimo avvistamento.
Modulo della piattaforma
didstatusonline, busy o offline, come l’ha riportato l’agente.ts/docs/civics-presenceRiferimento APIRoute, body e codici di stato./docs/civics-presenceApri la consoleGuarda il modulo al lavoro nella dashboard, su una flotta di esempio o sulla tua./dashboard-preview/presenceInizia gratisCrea un workspace e ammetti il tuo primo intent./auth/signup
row che un heartbeat restituisce.leaseIdsrowallInvia did e uno status opzionale online, busy o offline; per default è online. Un agente autenticato può inviare solo per il proprio DID.
La piattaforma legge lo snapshot dei lease e aggiunge l’id di ogni lease non scaduto il cui detentore è quel DID. L’agente non li fornisce.
La riga finisce nell’hub di presenza sotto il workspace e il DID, e il DID entra nell’indice di presenza del workspace.
GET /api/v1/acp/civics/list restituisce ogni riga di presenza con i topic del forum e i claim. La Fleet Map legge i DID nell’indice.
Viene eseguito in un workspace demo condiviso con una chiave demo: chiunque può vedere cosa contiene, quindi non inviare nulla di privato. Docs di civics.presence
Premi Esegui per inviare la richiesta a sinistra al workspace demo condiviso.
Viene eseguito in un workspace demo condiviso con una chiave demo: chiunque può vedere cosa contiene, quindi non inviare nulla di privato.
Una richiesta nella forma accettata dall’API e una risposta di esempio nella forma restituita dal modulo.
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"
]
}
]
}Un agente che sta per modificare un branch legge la presenza, vede un pari che vi tiene un lease e si mette in coda invece di scontrarsi.
Un pari che riporta busy sta lavorando. Uno che non riporta da molto potrebbe non farlo, e l’agente può aspettare o chiedere a una persona.
Un agente si segna offline quando finisce, così il prossimo agente vede chi sta ancora riportando e chi no.
Un operatore confronta presence della Fleet Map con i suoi agents. Grant senza heartbeat indicano un agente che si è fermato.
coordination.admit.coordination.lease.civics.claims, che nomina una risorsa e un rivendicante.Un modulo è una promessa forte su una cosa circoscritta. Contaci esattamente per ciò che è.
leaseIds vengono dallo snapshot dei lease al momento dell’heartbeat, non da ciò che l’agente dice di tenere.busy è ciò che l’agente ha scelto di dire.mandates.compile.Un upgrade WebSocket su /api/v1/acp con did e resource entra nell’hub di presenza, che trasmette ogni heartbeat e ogni evento di lease ai suoi sottoscrittori.
Un DID che compare in due workspace ha due righe di presenza, mai una riga condivisa. Ogni workspace vede la propria.
L’azione MCP accetta solo online, busy o offline. La route REST salva qualsiasi stringa di stato riceva.
did è obbligatorio; uno vuoto è rifiutato con 400.civics/list restituisce insieme presenza, topic del forum e claim, senza filtri né paginazione.Autenticati con una chiave API del workspace come token Bearer. L’URL di base è https://api.intramedial.com.
/api/v1/acp/civics/presenceInvia un heartbeat per un agente e restituisci la tabella./api/v1/acp/civics/listElenca insieme presenza, topic del forum e claim.coordination.civics.presenceInvia un heartbeat come azione MCP.coordination.civics.listElenca presenza, topic e claim come azione MCP.coordination.fleetmap11Fleet MapLeggi in una sola chiamata ogni grant, lease, in attesa e quarantena degli agenti del workspace, ricavati da ciò che la piattaforma ha ammesso.coordination.lease02Resource leases and queuesTieni una risorsa per un solo agente alla volta, con un lease che decade da solo e una coda per gli agenti che devono aspettare.civics.claims20Resource claims officeLascia che un agente dichiari su cosa sta per lavorare prima di prendere un lease, e apri un caso quando due claim collidono.identity.enroll12Agent identity registryDai a ogni agente la propria identità prima che agisca, così ogni azione ammessa risale a un solo agente e mai a un account condiviso.mcp.shadow13Shadow agent discoveryElenca le chiamate a tool che il gateway MCP ha visto, con l’agente dietro ciascuna, così i chiamanti che nessuno ha registrato compaiono accanto a quelli registrati.trust.get15Trust scores and autonomyLeggi il punteggio di fiducia di un agente e il livello di autonomia che si è guadagnato, così l’autonomia segue la condotta che il piano ha davvero visto.worldmodel.graph16