O Intramedial está em beta restrito. Ao se cadastrar ou entrar, você precisa informar a senha de beta tester que recebeu ou solicitar uma em preview@intramedial.com. Obrigado.
Carregando…
civics.settingsMódulo 23
Módulo da plataforma
Workspace constitution
Defina com que rapidez os humanos devem responder às perguntas dos seus agentes e quem está de plantão, para cada urgência neste workspace.
civics.settings lê e grava os prazos de resposta e as listas de plantão da mesa Liaison. Uma pergunta é roteada quando é feita, e o prazo e as pessoas consultadas ficam congelados nela. Só quem administra o workspace pode alterar as configurações.
Os agentes agem quando o plano diz sim, e o registo diz porquê.
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.
Com o que uma pergunta seria roteada agora: sla e oncall, ou null onde nada está definido.
urgencies
As urgências que a mesa conhece: routine e urgent.
sla
Só escrita. Milissegundos permitidos para responder, um inteiro acima de zero, indexado por urgência.
oncall
Só escrita. Os DIDs das pessoas de plantão, indexados por urgência.
Mecanismo
Passo a passo
Como funciona
Leia o que está em vigor
GET na rota. A resposta traz os valores deste workspace, os valores de fallback da plataforma e a mistura effective dos dois.
Defina prazos de resposta e plantão
POSTsla (milissegundos, por urgência) e oncall (DIDs, por urgência). As urgências são routine e urgent.
Uma pergunta os congela
Quando um agente chama civics/ask, a lista de plantão e o prazo da sua urgência são copiados para a pergunta. Salvar novas configurações depois não reescreve as perguntas abertas.
Alguém responde
As pessoas de plantão para aquela pergunta podem respondê-la, e também quem administra o workspace. Sem ninguém nomeado, o administrador responde.
Experimente
Demo ao vivo
Execute a partir desta página
GET/api/v1/acp/civics/settings
// Sem corpo: isto é um GET. Clique em Executar.
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.settings
Respostas
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.
Código
Exemplo ao vivo
Uma requisição real
Uma requisição no formato que a API aceita e um exemplo de resposta no formato que o módulo devolve.
Dê a sla.urgent um orçamento menor que sla.routine. Uma pergunta sem resposta além do prazo aparece como overdue, e uma respondida depois dele como answered-late.
Nomear quem está de plantão
Liste os DIDs de plantão para urgent. Só eles e os administradores do workspace podem responder a essas perguntas; qualquer outro é recusado com 403.
Sem escala ainda
Deixe ambos vazios. As perguntas não têm prazo e um administrador responde, então nada é roteado a uma pessoa que nunca foi nomeada.
Mostrar quem foi consultado
Cada pergunta guarda a lista to e o prazo com que foi roteada, então você pode mostrar quem foi consultado e até quando mesmo depois de a escala mudar.
Quando usar outra coisa
Escolher se uma classe de recurso é observada, aconselhada ou aplicada. Isso é adoção em coordination.admit, editada no console da constituição.
Fazer ou responder uma pergunta. Use civics.asks, que lista as perguntas e recebe as respostas.
Registrar um tratado com outra parte. Isso é civics.treaties, com suas próprias rotas e aprovações.
Evidência
Garantias
O que faz e o que não faz
Um módulo é uma afirmação forte sobre algo estreito. Confie nele exatamente pelo que ele é.
Faz
Cada pergunta é roteada com a lista de plantão e o prazo em vigor quando foi feita, não com valores salvos depois.
Alterar prazos de resposta ou plantão exige uma pessoa autenticada que administre o workspace; um token ou agente é recusado.
Um valor de sla que não seja um inteiro de milissegundos acima de zero é recusado com 400 que nomeia a urgência.
Não faz
Que alguém respondeu. As configurações definem um prazo e uma escala; não fazem uma pessoa responder. Uma pergunta atrasada só aparece como overdue.
Que uma notificação chegou às pessoas de plantão. A entrega é de melhor esforço e a pergunta registra o resultado, que pode ser skipped.
Que os DIDs de plantão pertençam a pessoas reais. A mesa armazena os DIDs que você dá e não os confere.
Detalhes
Notas de construção
Antes de construir
O workspace prevalece sobre a plataforma
Onde o workspace define um valor para uma urgência, ele vale. O valor da plataforma é só o fallback, então o comportamento é o da plataforma até um administrador salvar algo.
Uma gravação substitui os dois mapas
Enviar sla sem oncall limpa a lista de plantão do workspace, e o inverso. Envie os dois para manter os dois.
Indefinido significa sem prazo
Sem nada definido em nenhum nível, não há prazo nem plantão nomeado. A mesa diz isso em vez de inventar um padrão.
O resto da mesa
O mesmo módulo guarda ask, asks e answer. Esta página cobre apenas as configurações.
Limites e medição
Uma pergunta tem no máximo 1000 caracteres e uma resposta no máximo 2000.
Os valores de sla são milissegundos inteiros acima de zero. Entradas de oncall que não sejam strings não vazias são descartadas ao salvar.
Só routine e urgent existem como urgências. Uma pergunta com outro valor é recusada.
Acesso
API e MCP
REST e MCP
Autentique-se com uma chave de API do workspace como token Bearer. A URL base é https://api.intramedial.com.
Endpoints REST
GET/api/v1/acp/civics/settingsLeia os valores do workspace, da plataforma e efetivos.
POST/api/v1/acp/civics/settingsSalve prazos de resposta e listas de plantão (somente administradores).
Ações MCP
Este módulo não tem ação MCP. Chame-o por REST a partir de qualquer agente ou programa.