Filtri di sicurezza
In questa pagina
I guardrail applicano protezioni dei contenuti alle richieste AI prima che raggiungano il modello. Si configurano per l'intera struttura in Settings (ingranaggio) → Guardrails e le singole chiavi API e i singoli servizi connessi possono sostituirli con impostazioni proprie.
"Applica protezioni dei contenuti a ogni richiesta per questa struttura. Nessuna è attiva per impostazione predefinita. Le singole chiavi possono ignorare queste impostazioni."
Figura 1: Guardrails: i modelli e PII masking
Figura 2: Secret redaction e la protezione dalla prompt injection
I guardrail integrati
| Guardrail | Cosa fa |
|---|---|
| PII masking | "Detect and mask personal data (names, emails, phone numbers, etc.) before prompts reach the model." |
| Secret redaction | "Strip API keys, tokens and other secrets out of prompts before they are sent upstream." |
| Prompt-injection shield | "Block common prompt-injection / jailbreak attempts (e.g. "ignore previous instructions", "developer mode") before they reach the model." |
PII masking e Secret redaction riscrivono il prompt (la richiesta viene comunque inoltrata, con le parti sensibili mascherate). Il Prompt-injection shield blocca direttamente le richieste corrispondenti con un errore di content policy violation (HTTP 403).
Modelli
La riga Templates applica una selezione predefinita con un solo clic, seguita da Save changes:
| Modello | Selezione |
|---|---|
| None | Nessun guardrail (l'impostazione predefinita). |
| PII protection | PII masking. |
| Secret redaction | Secret redaction. |
| Injection shield | Prompt-injection shield. |
| Strict | Tutti e tre. |
Il salvataggio mostra "Guardrail settings saved."
Filtri dei contenuti
Sotto i guardrail, i Content filters ti consentono di aggiungere regole personalizzate: espressioni regolari personalizzate valutate sul contenuto del prompt. Redact riscrive le corrispondenze in [REDACTED]; Block rifiuta la richiesta. Le singole chiavi possono sostituirli con impostazioni proprie.
Fai clic su Add filter, quindi imposta:
| Campo | Comportamento |
|---|---|
| Pattern | Un'espressione regolare ("Regular expression, e.g. \b\d{16}\b": questo esempio corrisponde ai numeri di carta a 16 cifre). I pattern non sicuri o troppo lunghi vengono scartati e non applicati; i pattern sono limitati a 300 caratteri e una struttura può avere fino a 25 filtri. La corrispondenza ignora maiuscole e minuscole e vengono controllati solo i primi 20,000 caratteri di ogni messaggio. |
| Action | Redact: le corrispondenze vengono riscritte in [REDACTED] e la richiesta prosegue; Block: la richiesta viene rifiutata con un errore di content policy violation. |
Usa Remove per eliminare un filtro, poi Save changes. Se non ne è configurato nessuno: "No content filters. Add one to redact or block matching prompt text."
Sostituzioni per chiave e per servizio
Ogni chiave API e ogni servizio connesso ha un interruttore Override facility guardrails nel proprio pannello di configurazione:
- Disattivato (impostazione predefinita): la chiave o il servizio eredita la selezione di guardrail e filtri dei contenuti della struttura.
- Attivato: la chiave o il servizio usa invece una propria selezione: "Select none to explicitly disable guardrails for this key." In questo modo puoi esentare un'integrazione attendibile dal mascheramento a livello di struttura oppure applicare regole più rigide a una singola chiave.
Vedi Chiavi API e Connected Services.
Cosa vedono i chiamanti
- Gli oscuramenti sono silenziosi: il modello riceve semplicemente
[REDACTED](o dati personali/segreti mascherati) al posto del testo corrispondente. - I blocchi restituiscono HTTP 403 con il messaggio "Request blocked by content policy" e il codice
content_policy_violation. Vedi la tabella degli errori in Connettere la tua applicazione.
Il contenuto dei prompt viene analizzato solo in transito: i guardrail non memorizzano mai ciò che analizzano.