Vai al contenuto principale
GET
Elenca le violazioni dei guardrail dell’organizzazione
Per una panoramica di come funzionano le barriere di sicurezza e di come configurarle, consulta la guida alla funzionalità AI Guardrails.

Autorizzazioni

Richiede un account di servizio con l’autorizzazione ManageEnterpriseSettings a livello Enterprise.

Filtri temporali

Questo endpoint supporta filtri temporali opzionali tramite i parametri di query time_after e time_before.
  • Sia time_after che time_before sono timestamp Unix in secondi, interpretati in UTC.
  • Se fornisci time_before, devi anche fornire time_after.
  • L’intervallo di tempo compreso tra time_after e time_before deve essere di 100 giorni o meno.
  • Se non vengono forniti filtri temporali, l’API restituisce le violazioni dei guardrail per l’intera cronologia disponibile (soggetta a paginazione).

Autorizzazioni

Authorization
string
header
obbligatorio

Credenziale dell'utente del servizio (prefisso: cog_)

Parametri del percorso

org_id
string
obbligatorio

ID dell'organizzazione (prefisso: org-)

Esempio:

"org-abc123def456"

Parametri della query

order
enum<string>
predefinito:desc
Opzioni disponibili:
asc,
desc
time_before
integer | null
time_after
integer | null
after
string | null
first
integer
predefinito:100
Intervallo richiesto: 1 <= x <= 200
session_id
string | null
guardrail_id
string | null

Risposta

Risposta con esito positivo

items
GuardrailViolationResponse · object[]
obbligatorio
end_cursor
string | null

Cursore per recuperare la pagina successiva oppure None se questa è l’ultima pagina.

has_next_page
boolean
predefinito:false

Indica se sono disponibili altri elementi dopo questa pagina.

total
integer | null

Conteggio totale facoltativo (può essere omesso per motivi di prestazioni).