Intramedial está en beta restringida. Al registrarte o iniciar sesión, debes indicar la contraseña de beta tester que recibiste o solicitar una en preview@intramedial.com. Gracias.
Cargando…
civics.settingsMódulo 23
Módulo de la plataforma
Workspace constitution
Fija en qué plazo deben responder las personas a las preguntas de tus agentes, y quién está de guardia, para cada urgencia en este workspace.
civics.settings lee y escribe los plazos de respuesta y las listas de guardia del desk Liaison. Una consulta se enruta al hacerse, y el plazo y las personas consultadas quedan fijados en ella. Solo una persona que administre el workspace puede cambiar los ajustes.
Los agentes actúan cuando el plano dice sí, y el registro dice por qué.
Pasa por Intramedial acciones de agentes, hashes de contenido, pruebas de API, DNS, webhooks, llamadas LLM y commits. Obtén un recibo firmado que cualquiera verifica, sin fiarse de nadie.
Con lo que se enrutaría ahora una consulta: sla y oncall, o null donde no hay nada fijado.
urgencies
Las urgencias que conoce el desk: routine y urgent.
sla
Solo escritura. Milisegundos permitidos para responder, un número entero mayor que cero, por urgencia.
oncall
Solo escritura. Los DID de las personas de guardia, por urgencia.
Mecanismo
Paso a paso
Cómo funciona
Leer lo que está vigente
GET a la ruta. La respuesta contiene los valores de este workspace, los valores de respaldo de la plataforma y la mezcla effective de ambos.
Fijar plazos y guardia
POST de sla (milisegundos, por urgencia) y oncall (DID, por urgencia). Las urgencias son routine y urgent.
Una consulta los congela
Cuando un agente llama a civics/ask, la lista de guardia y el plazo de su urgencia se copian a la consulta. Guardar ajustes nuevos después no reescribe las consultas abiertas.
Alguien responde
Las personas de guardia de esa consulta pueden responderla, y también una persona que administre el workspace. Si no se nombra a nadie, responde el administrador.
Pruébalo
Demo en vivo
Ejecútalo desde esta página
GET/api/v1/acp/civics/settings
// Sin cuerpo: esto es un GET. Pulsa Ejecutar.
Se ejecuta en un workspace de demostración compartido con una clave de demostración: cualquiera puede ver lo que contiene, así que no envíes nada privado. Docs de civics.settings
Respuestas
Pulsa Ejecutar para enviar la solicitud de la izquierda al workspace de demostración compartido.
Se ejecuta en un workspace de demostración compartido con una clave de demostración: cualquiera puede ver lo que contiene, así que no envíes nada privado.
Código
Ejemplo en vivo
Una petición real
Una petición con la forma que acepta la API y una respuesta de ejemplo con la forma que devuelve el módulo.
Da a sla.urgent un plazo más corto que a sla.routine. Una consulta sin responder pasado su plazo se lee overdue, y una respondida después se lee answered-late.
Nombrar quién está de guardia
Lista los DID de guardia para urgent. Solo ellos y los administradores del workspace pueden responder esas consultas; cualquier otro recibe un 403.
Aún sin turnos
Deja ambos vacíos. Las consultas no llevan plazo y responde un administrador, así que nada se enruta a una persona que nunca fue nombrada.
Mostrar a quién se consultó
Cada consulta guarda la lista to y el plazo con que se enrutó, así que puedes mostrar a quién se consultó y para cuándo aunque el turno haya cambiado.
Cuándo usar otra cosa
Elegir si una clase de recurso se observa, se aconseja o se aplica. Eso es la adopción en coordination.admit, que se edita en la consola de la constitución.
Hacer o responder una pregunta. Usa civics.asks, que lista las consultas y recibe las respuestas.
Registrar un tratado con otra parte. Eso es civics.treaties, con sus propias rutas y aprobaciones.
Evidencia
Garantías
Qué hace y qué no hace
Un módulo es una afirmación fuerte sobre algo acotado. Confía en él exactamente para lo que es.
Hace
Cada consulta se enruta con la lista de guardia y el plazo vigentes cuando se hizo, no con valores guardados después.
Un cambio de plazos de respuesta o de guardia necesita una persona con sesión iniciada que administre el workspace; un token o un agente se rechaza.
Un valor de sla que no sea un número entero de milisegundos mayor que cero se rechaza con un 400 que nombra la urgencia.
No hace
Que alguien respondiera. Los ajustes fijan un plazo y unos turnos; no hacen que una persona responda. Una consulta tardía solo se lee overdue.
Que una notificación llegara a las personas de guardia. La entrega es de mejor esfuerzo y la consulta registra el resultado, que puede leerse skipped.
Que los DID de guardia pertenezcan a personas reales. El desk guarda los DID que le das y no los comprueba.
Detalles
Notas de construcción
Antes de construir
El workspace manda sobre la plataforma
Cuando el workspace fija un valor para una urgencia, prevalece. El valor de la plataforma es solo el respaldo, así que el comportamiento es el de la plataforma hasta que un administrador guarde algo.
Una escritura reemplaza ambos mapas
Enviar sla sin oncall borra la lista de guardia del workspace, y a la inversa. Envía ambos para conservar ambos.
Sin fijar significa sin plazo
Sin nada fijado en ninguno de los dos niveles no hay plazo ni guardia nombrada. El desk lo dice en lugar de inventar un valor por defecto.
El resto del desk
El mismo módulo contiene ask, asks y answer. Esta página cubre solo los ajustes.
Límites y medición
Una pregunta tiene como máximo 1000 caracteres y una respuesta 2000.
Los valores de sla son milisegundos enteros mayores que cero. Las entradas de oncall que no sean cadenas no vacías se descartan al guardar.
Solo existen routine y urgent como urgencias. Una consulta con otro valor se rechaza.
Acceso
API y MCP
REST y MCP
Autentícate con una clave de API del workspace como token Bearer. La URL base es https://api.intramedial.com.
Endpoints REST
GET/api/v1/acp/civics/settingsLee los valores del workspace, de la plataforma y los efectivos.
POST/api/v1/acp/civics/settingsGuarda plazos de respuesta y listas de guardia (solo administradores).
Acciones MCP
Este módulo no tiene acción MCP. Llámalo por REST desde cualquier agente o programa.