Pular para o conteúdo principal
GET
Listar violações de guardrail
Para ver uma visão geral de como os guardrails funcionam e como configurá-los, consulte o guia do recurso AI Guardrails.

Permissões

Requer um usuário de serviço com a permissão ManageEnterpriseSettings no nível da Enterprise.

Filtros de tempo

Este endpoint é compatível com filtros de tempo opcionais usando os parâmetros de consulta time_after e time_before.
  • Tanto time_after quanto time_before são carimbos de data e hora Unix em segundos, interpretados como UTC.
  • Se você informar time_before, também deverá informar time_after.
  • O intervalo de tempo entre time_after e time_before deve ser de 100 dias ou menos.
  • Se nenhum filtro de tempo for especificado, a API retorna violações de guardrail para todo o histórico disponível (sujeito à paginação).

Autorizações

Authorization
string
header
obrigatório

Credencial de usuário de serviço (prefixo: cog_)

Parâmetros de consulta

order
enum<string>
padrão:desc
Opções disponíveis:
asc,
desc
time_before
integer | null
time_after
integer | null
after
string | null
first
integer
padrão:100
Intervalo obrigatório: 1 <= x <= 200
session_id
string | null
guardrail_id
string | null

Resposta

Resposta bem-sucedida

items
GuardrailViolationResponse · object[]
obrigatório
end_cursor
string | null

Cursor para obter a próxima página ou None se esta for a última página.

has_next_page
boolean
padrão:false

Indica se há mais itens disponíveis após esta página.

total
integer | null

Contagem total opcional (pode ser omitida por motivos de desempenho).