Saltar para o conteúdo principal
POST
Verificar Guardrail
Registra a pontuação do seu aplicativo para a entrada ou saída de um agente. Não verifica texto bruto nem calcula uma pontuação de segurança independente. Forneça a pontuação produzida pelo seu próprio detector. Os campos obrigatórios são agent_id, check_type e guardrail_type. check_type deve ser input ou output. O manipulador atual trata uma pontuação omitida como zero. Sempre envie uma pontuação explícita; um resultado pass não estabelece que o conteúdo é seguro. Uma verificação falha tenta abrir o disjuntor do agente. content_hash são metadados, não conteúdo carregado para análise. O recibo atual usa um marcador de sistema em seu campo de assinatura; não o trate como prova criptográfica.

Autorizações

X-API-Key
string
header
obrigatório

Chave de API para autenticação máquina a máquina

Corpo

application/json
agent_id
string<uuid>
obrigatório

Agente solicitando a ação

check_type
string
obrigatório
guardrail_type
string
obrigatório
content_hash
string
details
any
execution_id
string | null
metadata
any
score
number

Resposta

Resultado da verificação do guardrail

allowed
boolean
violations
object[]
receipt_id
string<uuid>