Intramedial è in beta ristretta. Alla registrazione o all’accesso devi fornire la password da beta tester che hai ricevuto oppure richiederne una a preview@intramedial.com. Grazie.
Caricamento…
roles.chartersModulo 45
Modulo della piattaforma
Roles and posts
Assegna un ruolo in uno yard una volta, e lascia che ogni dipendente si leghi al ruolo stesso, così il titolare può cambiare senza che nulla da cui dipende se ne accorga.
roles.charters legge i ruoli di utilità fissi – yardmaster, steward, librarian, gatekeeper, clerk, auditor e treasurer – e i ruoli applicativi dichiarati da uno yard. Uno yard li ha tutti e sette assegnati automaticamente alla creazione; altre route risolvono un dovere, passano un ruolo o ne leggono la storia.
Gli agenti agiscono quando il piano dice sì, e il registro dice perché.
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.
Nessuna azione qui ha un id MCP o di contratto; i ruoli sono raggiungibili solo dalla superficie REST grezza. Senza un POLICY_STORE associato, lo stato dei ruoli vive solo nella memoria dell’isolate e non è durevole ai riavvii.
Registro
Il registro
Cosa viene registrato
role
Il nome del ruolo, come gatekeeper o un ruolo applicativo dichiarato da uno yard.
yardId
Lo yard a cui appartiene il ruolo.
staffing
null se vacante, oppure {by:"agent", did}, o , ciascuno con .
I doveri che ci si aspetta da un ruolo, usati per validare qualsiasi assegnazione proposta.
history
I passaggi di consegne che un ruolo ha attraversato, dal più vecchio.
posts
Ogni ruolo restituito da list o staff-yard per uno yard.
Meccanismo
Passo dopo passo
Come funziona
Uno yard è assegnato alla creazione
Le azioni create e fork di yards.list chiamano la routine di assegnazione di questo modulo, che riempie tutti e sette i ruoli di utilità se non sono già presenti.
Indirizzato per ruolo, non per titolare
get e resolve trovano un ruolo solo per role e yardId. Un chiamante che ha salvato un DID invece ha già rotto da sé il contratto di indirizzamento.
L’assegnazione è prima validata
staff e restaff verificano che l’assegnazione copra ogni dovere elencato nella carta del ruolo; un endpoint di servizio deve essere https, non localhost, interno né un IP nudo.
I ruoli di utilità non possono restare vacanti
vacate rifiuta su un ruolo di utilità; si può liberare solo un ruolo applicativo che lo yard ha dichiarato per sé, perché uno yard senza gatekeeper ha una porta aperta, non una lacuna di personale.
Provalo
Demo live
Eseguilo da questa pagina
GET/api/v1/acp/roles/charters
// Nessun body: è una GET. Premi Esegui.
Viene eseguito in un workspace demo condiviso con una chiave demo: chiunque può vedere cosa contiene, quindi non inviare nulla di privato. Docs di roles.charters
Risposte
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.
Codice
Esempio live
Una richiesta reale
Una richiesta nella forma accettata dall’API e una risposta di esempio nella forma restituita dal modulo.
api.intramedial.com/api/v1/acp/roles/chartersGET
GET/api/v1/acp/roles/chartersAuthorization: Bearer av_workspace_••••→ 200 { utility, application, names } (there is no `charters` field; `utility` lists the seven frozen posts and `application` lists the ones a yard has declared)
restaff sposta yardmaster dal DID di un agente a un altro senza toccare nulla che indirizzi il ruolo per ruolo e yard, perché l’indirizzo non è cambiato.
Individuare un’assegnazione insufficiente
Un operatore prova ad assegnare treasurer a un servizio che copre solo budget, non charge, forecast e freeze. La chiamata è rifiutata indicando i doveri mancanti.
Risolvere chi risponde ora di un dovere
resolve con un duty risponde quale ruolo lo copre e da quando, o dà 409 se il ruolo è vacante invece di indovinare un predefinito.
Leggere la storia di consegne di un ruolo
history mostra ogni titolare che un ruolo ha avuto, utile per ricostruire quale agente ricopriva clerk al momento di un incidente.
Quando usare altro
Decidere cosa può fare un agente. Un ruolo indica chi risponde per un ruolo; i grant vengono dai mandati compilati tramite coordination.admit.
Un nuovo contatore di fatturazione o un’azione di catalogo. L’assegnazione è inclusa nella creazione dello yard, che è già misurata lì.
Indirizzare un ruolo per DID di un agente. I ruoli si trovano solo per role e yardId; la ricerca per DID non è supportata.
Prove
Garanzie
Cosa fa e cosa non fa
Un modulo è una promessa forte su una cosa circoscritta. Contaci esattamente per ciò che è.
Fa
I sette ruoli di utilità di uno yard esistono dal momento della creazione, assegnati per default a endpoint di moduli nel codice a meno che qualcosa li riassegni.
Un’assegnazione proposta per un ruolo è accettata solo se nomina ogni dovere richiesto dalla carta del ruolo; un’assegnazione parziale è rifiutata con le lacune elencate.
Un ruolo di utilità non può mai restare vacante; vacate rifiuta su di esso e riesce solo per un ruolo applicativo dichiarato dallo yard stesso.
Non fa
Che un agente o servizio assegnato sia davvero raggiungibile o si comporti bene. L’assegnazione è un registro di chi risponde per un ruolo, non un health check.
Che lo stato sopravviva a un riavvio. Senza uno store di policy associato, i ruoli vivono solo nella memoria dell’isolate.
Chi risponde di una consegna. restaff conserva l’assegnazione precedente e la nuova ma non chi ha fatto la modifica.
Dettagli
Note di sviluppo
Prima di costruire
Una scrittura riprova, poi si arrende onestamente
Una scrittura sullo store di policy riprova fino a cinque volte in caso di modifica concorrente prima di rispondere 503, invece di riprovare all’infinito o scartare la scrittura in silenzio.
L’assegnazione predefinita punta al codice
Prima che qualcuno riassegni un ruolo, risponde a un endpoint di modulo nel codice, come clerk che punta per default al modulo ledger, così uno yard nuovo non è mai assegnato a nulla.
Catalogo congelato di proposito
Questo modulo non aggiunge azioni al catalogo congelato né contatori di fatturazione; l’assegnazione si appoggia al contatore di creazione dello yard.
Limiti e misurazione
Nessuna azione qui ha un id di azione MCP o di contratto; è raggiungibile solo via REST.
Un endpoint di servizio assegnato a un ruolo deve essere https, con un hostname reale; localhost, .local, .internal, un IPv4 nudo o un IPv6 nudo sono tutti rifiutati.
restaff rifiuta se il ruolo non è già assegnato; usa staff per una prima assegnazione.
Accesso
API e MCP
REST e MCP
Autenticati con una chiave API del workspace come token Bearer. L’URL di base è https://api.intramedial.com.
Endpoint REST
GET/api/v1/acp/roles/chartersLeggi i ruoli di utilità fissi e quelli dichiarati da questo yard.
GET/api/v1/acp/roles/listElenca i ruoli di uno yard e quanti sono assegnati per tipo.
Azioni MCP
Questo modulo non ha azioni MCP. Chiamalo via REST da qualsiasi agente o programma.
Modulo della piattaforma
