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…
civics.settingsModulo 23
Modulo della piattaforma
Workspace constitution
Imposta quanto in fretta gli umani devono rispondere alle domande dei tuoi agenti, e chi è reperibile, per ogni urgenza in questo workspace.
civics.settings legge e scrive i tempi di risposta e gli elenchi di reperibilità del desk Liaison. Una richiesta è instradata quando viene fatta, e la scadenza e le persone interpellate vi restano fissate. Solo chi amministra il workspace può cambiare le impostazioni.
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.
Con cosa sarebbe instradata ora una richiesta: sla e oncall, o null dove nulla è impostato.
urgencies
Le urgenze che il desk conosce: routine e urgent.
sla
Solo scrittura. Millisecondi concessi per rispondere, un intero maggiore di zero, per urgenza.
oncall
Solo scrittura. I DID delle persone reperibili, per urgenza.
Meccanismo
Passo dopo passo
Come funziona
Leggi ciò che è in vigore
GET sulla route. La risposta contiene i valori di questo workspace, quelli di riserva della piattaforma e la combinazione effective dei due.
Imposta tempi di risposta e reperibilità
POST di sla (millisecondi, per urgenza) e oncall (DID, per urgenza). Le urgenze sono routine e urgent.
Una richiesta li congela
Quando un agente chiama civics/ask, l’elenco di reperibilità e la scadenza della sua urgenza sono copiati sulla richiesta. Salvare nuove impostazioni dopo non riscrive le richieste aperte.
Qualcuno risponde
Chi è reperibile per quella richiesta può rispondere, e così una persona che amministra il workspace. Se nessuno è indicato, risponde l’amministratore.
Provalo
Demo live
Eseguilo da questa pagina
GET/api/v1/acp/civics/settings
// 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 civics.settings
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.
Dai a sla.urgent un budget più breve di sla.routine. Una richiesta senza risposta oltre la scadenza risulta overdue, e una risposta dopo di essa risulta answered-late.
Indicare chi è reperibile
Elenca i DID reperibili per urgent. Solo loro e gli amministratori del workspace possono rispondere a quelle richieste; chiunque altro è rifiutato con 403.
Ancora nessun turno
Lascia entrambi vuoti. Le richieste non hanno scadenza e risponde un amministratore, così nulla è instradato a una persona mai indicata.
Mostrare chi è stato interpellato
Ogni richiesta salva l’elenco to e la scadenza con cui è stata instradata, così puoi mostrare chi è stato interpellato e entro quando anche dopo che il turno è cambiato.
Quando usare altro
Scegliere se una classe di risorse è osservata, consigliata o applicata. È l’adozione su coordination.admit, modificata nella console della constitution.
Fare o rispondere a una domanda. Usa civics.asks, che elenca le richieste e riceve le risposte.
Registrare un trattato con un’altra parte. È civics.treaties, con proprie route e approvazioni.
Prove
Garanzie
Cosa fa e cosa non fa
Un modulo è una promessa forte su una cosa circoscritta. Contaci esattamente per ciò che è.
Fa
Ogni richiesta è instradata con l’elenco di reperibilità e la scadenza in vigore quando è stata fatta, non con valori salvati dopo.
Cambiare tempi di risposta o reperibilità richiede una persona autenticata che amministra il workspace; un token o un agente è rifiutato.
Un valore sla che non sia un intero di millisecondi maggiore di zero è rifiutato con un 400 che nomina l’urgenza.
Non fa
Che qualcuno abbia risposto. Le impostazioni fissano una scadenza e un turno; non fanno rispondere una persona. Una richiesta in ritardo risulta solo overdue.
Che una notifica sia arrivata alle persone reperibili. La consegna è best effort e la richiesta registra il risultato, che può risultare skipped.
Che i DID di reperibilità appartengano a persone reali. Il desk salva i DID che gli dai e non li verifica.
Dettagli
Note di sviluppo
Prima di costruire
Il workspace prevale sulla piattaforma
Dove il workspace imposta un valore per un’urgenza, vince. Il valore della piattaforma è solo di riserva, quindi il comportamento è quello della piattaforma finché un amministratore non salva qualcosa.
Una scrittura sostituisce entrambe le mappe
Inviare sla senza oncall cancella l’elenco di reperibilità del workspace, e viceversa. Invia entrambi per tenerli entrambi.
Non impostato significa nessuna scadenza
Senza nulla impostato a nessuno dei due livelli non c’è scadenza né reperibilità indicata. Il desk lo dice invece di inventare un valore predefinito.
Il resto del desk
Lo stesso modulo contiene ask, asks e answer. Questa pagina copre solo le impostazioni.
Limiti e misurazione
Una domanda è al massimo di 1000 caratteri e una risposta di 2000.
I valori sla sono millisecondi interi maggiori di zero. Le voci oncall che non sono stringhe non vuote sono scartate al salvataggio.
Esistono come urgenze solo routine e urgent. Una richiesta con un altro valore è rifiutata.
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/civics/settingsLeggi i valori del workspace, della piattaforma e quelli effettivi.
POST/api/v1/acp/civics/settingsSalva tempi di risposta ed elenchi di reperibilità (solo amministratori).
Azioni MCP
Questo modulo non ha azioni MCP. Chiamalo via REST da qualsiasi agente o programma.