---
title: Configurare gli Inference hooks
url: https://platform.claude.com/docs/it/manage-claude/inference-hooks-configuration
description: Consenti gli Inference hooks per la tua organizzazione Claude Enterprise, collega il tuo server di sicurezza AI e controlla l'applicazione dei verdetti, la gestione degli errori e il rollout.
---

<Note>
  Gli “Inference hooks” (hook di inferenza) sono disponibili solo per le organizzazioni Claude Enterprise. Per configurarli è necessaria l’autorizzazione `organization:manage`, di cui dispongono solo i ruoli Proprietario e Proprietario principale.
</Note>

Gli Inference hooks inviano i prompt della tua organizzazione a un server di sicurezza AI di tua scelta e trattengono ogni richiesta in attesa di un verdetto di autorizzazione (allow) o rifiuto (deny) prima che Claude la elabori. Questa pagina illustra come attivare la funzionalità, collegare il tuo server e controllare l’applicazione dei verdetti. Per sapere cosa sono gli Inference hooks e quando usarli, consulta la [panoramica degli Inference hooks](https://platform.claude.com/docs/it/manage-claude/inference-hooks). Per costruire il server di sicurezza AI stesso, consulta [Sviluppare un’integrazione Inference hooks](https://platform.claude.com/docs/it/manage-claude/inference-hooks-endpoint).

## Prima di iniziare

Ti servono:

* L’autorizzazione `organization:manage` in claude.ai, di cui dispongono solo i ruoli **Proprietario** e **Proprietario principale**. Il ruolo **Amministratore** non la possiede.
* Un endpoint HTTPS del server di sicurezza AI che accetti le richieste di verdetto: un URL `https://` sulla porta 443, su un host instradabile pubblicamente, raggiungibile senza reindirizzamenti. Gli host di tunnel inverso (ngrok e servizi di tunneling simili) non sono supportati: la policy di rete di Anthropic li blocca. Non eseguire test tramite un tunnel; ospita il tuo server su un dominio che controlli. Per i [requisiti di hosting](https://platform.claude.com/docs/it/manage-claude/inference-hooks-endpoint#receive-a-request) completi, e per creare il server e verificare le richieste firmate, consulta [Sviluppare un’integrazione con gli Inference hooks](https://platform.claude.com/docs/it/manage-claude/inference-hooks-endpoint).

## Configurare gli Inference hooks

Esistono tre stati di applicazione:

* **Disattivato:** con **Applica i verdetti** disattivato, il tuo server di sicurezza IA non viene mai contattato e i prompt non vengono ispezionati.
* **Shadow:** con **Applica i verdetti** attivato e **Modalità** impostato su **Modalità shadow**, il tuo server di sicurezza IA riceve i prompt e restituisce i verdetti, e nulla viene bloccato.
* **Applicazione attiva:** con **Applica i verdetti** attivato e **Modalità** impostato su **Consenti la richiesta** o **Blocca la richiesta**, un rifiuto blocca la richiesta.

I passaggi seguenti portano una nuova configurazione dallo stato disattivato all’applicazione attiva.

<Steps>
  <Step title="Consenti gli Inference hooks per la tua organizzazione">
    Vai su claude.ai > **Impostazioni organizzazione** > **Dati e privacy** e trova la sezione **Hook di inferenza**. Attiva **Consenti per la tua organizzazione**.

    Attivando questa opzione si sblocca la pagina delle impostazioni degli Inference hooks e si disattiva sempre **Applica i verdetti**, quindi consentire la funzionalità non avvia mai l’ispezione da sola: anche una configurazione che in precedenza aveva l’applicazione attiva resta non ispezionata finché non riattivi **Applica i verdetti** nell’ultimo passaggio.
  </Step>

  <Step title="Apri la pagina delle impostazioni degli Hook di inferenza">
    Sempre in **Dati e privacy**, apri la sezione **Hook di inferenza** per raggiungere la pagina delle impostazioni degli Inference hooks. Si trova sotto **Dati e privacy** anziché come voce a sé nel menu di navigazione delle impostazioni, quindi il suo percorso di navigazione riporta **Dati e privacy / Hook di inferenza**. Finché non salvi un endpoint, la pagina avvisa che i prompt non vengono ancora ispezionati e **Applica i verdetti** rimane disattivato con un badge **Richiede un endpoint**.
  </Step>

  <Step title="Configura il tuo endpoint">
    Fai clic su **Configura** per aprire la finestra di dialogo **Configura endpoint** e inserisci l’**URL endpoint**: l’URL `https://` che riceve le richieste di verdetto. Sono accettati solo URL `https://`.

    A questo punto la finestra di dialogo non chiede nient’altro: le intestazioni di richiesta personalizzate arrivano al passaggio 5 e la gestione degli errori al passaggio 6. Fai clic su **Avanti** per salvare. Una volta salvato un endpoint, il pulsante riporta **Modifica**.
  </Step>

  <Step title="Conserva il tuo segreto di firma">
    Il primo salvataggio genera il “signing secret” (segreto di firma) del tuo webhook e lo mostra una sola volta. Copialo e conservalo in modo sicuro prima di fare clic su **Avanti**: il segreto non può essere recuperato in seguito, ma solo [ruotato](https://platform.claude.com/docs/it/manage-claude/inference-hooks-configuration#rotate-your-signing-secret).

    Il tuo server di sicurezza AI usa questo segreto per verificare la firma di ogni richiesta che riceve, incluso il test di connessione nel passaggio successivo. Per la procedura di verifica, consulta [Verificare la firma](https://platform.claude.com/docs/it/manage-claude/inference-hooks-endpoint#verify-the-signature).
  </Step>

  <Step title="Aggiungi le intestazioni di richiesta e testa la connessione">
    Facendo clic su **Avanti** nella finestra di dialogo del segreto di firma si riapre la finestra di dialogo dell’endpoint, ora con due controlli aggiuntivi:

    * **Intestazioni di richiesta personalizzate:** fino a 16 intestazioni statiche inviate con ogni richiesta di verdetto, in modo che il tuo server di sicurezza AI possa autenticare il chiamante. I valori delle intestazioni vengono archiviati crittografati e non vengono mai più mostrati; dopo il salvataggio, vengono visualizzati solo i nomi delle intestazioni. Poiché i valori sono di sola scrittura, salvare qualsiasi modifica alle intestazioni richiede di reinserire ogni valore. La modifica dell’URL dell’endpoint cancella tutti i valori delle intestazioni archiviati, in modo che le tue credenziali non vengano mai inviate a una nuova destinazione; reinseriscili dopo una modifica dell’URL. I nomi delle intestazioni devono usare i caratteri token HTTP standard con `-` anziché `_` e non devono entrare in conflitto con i nomi riservati (intestazioni di framing della richiesta come `Content-*` e `Host`, intestazioni di proxy e cookie, intestazioni dell’indirizzo del client come `X-Forwarded-*`, le intestazioni di firma `webhook-*` e il prefisso `X-Anthropic-*`). I valori devono essere caratteri ASCII stampabili.
    * **Testa connessione:** Claude invia un prompt di test sintetico all’URL e alle intestazioni attualmente presenti nel modulo, non ai valori salvati, quindi reinserisci eventuali valori delle intestazioni archiviati prima di eseguire il test. In caso di successo, il risultato indica se il tuo server di sicurezza AI ha restituito un verdetto di autorizzazione o di rifiuto per il prompt di test, il che fa emergere un’impostazione predefinita che rifiuta tutto prima che tu inizi ad applicare i verdetti. Mostra anche il tempo di andata e ritorno misurato da Anthropic per quella singola richiesta di test, su una nuova connessione, incluso l’handshake di connessione.

    Fai clic su **Salva** per archiviare le intestazioni che hai inserito.

    Risultati di errore comuni:

    | Risultato                  | Cosa verificare                                                                                                                                                                             |
    | -------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
    | URL rifiutato              | L’URL non ha superato un controllo strutturale. Usa un URL `https://` sulla porta 443.                                                                                                      |
    | IP privato o interno       | L’host dell’URL è un indirizzo IP privato o interno, un indirizzo IPv6 o `localhost`. Usa un host instradabile pubblicamente.                                                               |
    | Timeout                    | Il server di sicurezza AI non ha restituito un verdetto entro il timeout.                                                                                                                   |
    | Errore di trasporto        | La risoluzione DNS, l’handshake TLS o la connessione non sono riusciti, oppure il nome host si risolve in un indirizzo privato.                                                             |
    | Stato diverso da 200       | Il server di sicurezza AI ha risposto con uno stato diverso da 200. I verdetti devono essere restituiti come HTTP 200; i reindirizzamenti non vengono seguiti e sono considerati errori.    |
    | Risposta non analizzabile  | Il server di sicurezza AI ha risposto, ma il corpo non è un verdetto valido.                                                                                                                |
    | Segreto di firma richiesto | La tua organizzazione non ha un segreto di firma, quindi il test verrebbe inviato senza firma. Fai clic su **Genera segreto** in **Firma delle richieste**, quindi esegui di nuovo il test. |
  </Step>

  <Step title="Scegli la gestione degli errori e il timeout">
    Sotto **Gestione degli errori**, imposta **Modalità** per scegliere cosa accade quando il server di sicurezza IA non è raggiungibile o i verdetti vanno in timeout:

    * **Blocca la richiesta:** interrompe l’inferenza quando il tuo server di sicurezza AI non può fornire un verdetto (fail closed).
    * **Consenti la richiesta:** lascia che la richiesta proceda verso il modello senza ispezione (fail open).

    La terza opzione del menu a discesa, **Modalità shadow**, è uno strumento di rollout anziché una policy di gestione degli errori; consulta [Modalità shadow](https://platform.claude.com/docs/it/manage-claude/inference-hooks-configuration#shadow-mode).

    Quindi imposta **Timeout verdetto prompt (ms)**: da 1 a 10.000 ms, con un valore predefinito di 5.000 ms. Il budget copre l’intero scambio, e un verdetto più lento conta come un server irraggiungibile, quindi imposta il valore più basso che il tuo server può rispettare in modo affidabile.

    Le modifiche in questa sezione vengono salvate man mano che le apporti. Al primo salvataggio, i valori predefiniti sono **Consenti la richiesta** e 5.000 ms.
  </Step>

  <Step title="Scegli una percentuale di rollout">
    Sotto **Rollout**, imposta **Richieste ispezionate (%)** per eseguire l’ispezione su una percentuale delle richieste mentre metti in funzione il tuo server di sicurezza AI. Il valore va da 0 a 100: 100 ispeziona tutto e 0 disattiva l’ispezione.

    Ogni richiesta viene estratta una sola volta per l’intero turno di conversazione, quindi una singola conversazione può essere ispezionata parzialmente tra un turno e l’altro. Le richieste al di fuori della percentuale campionata procedono senza ispezione, anche quando la gestione degli errori è impostata su **Blocca la richiesta**.
  </Step>

  <Step title="Attiva l’opzione Applica i verdetti">
    Per valutare i verdetti sul traffico reale senza bloccare nessuno all’inizio, imposta **Modalità** su **Modalità shadow** (passaggio 6) prima di attivare l’applicazione; consulta [Modalità shadow](https://platform.claude.com/docs/it/manage-claude/inference-hooks-configuration#shadow-mode).

    Attiva **Applica i verdetti** per subordinare Claude al verdetto del tuo server di sicurezza IA per ogni prompt soggetto a controllo, quindi conferma nella finestra di dialogo, che riepiloga la tua scelta di gestione degli errori. Attendi circa un minuto affinché la modifica raggiunga tutti i server Anthropic; le richieste già in corso vengono completate con l’impostazione precedente. Disattivandolo, i prompt smettono di essere inviati al tuo server di sicurezza IA, anche in questo caso entro circa un minuto; la tua configurazione viene mantenuta.

    **Validate tool calls**, sotto **Applica i verdetti**, invia anche le chiamate agli strumenti presenti in ciascuna risposta di Claude al tuo server di sicurezza AI e attende il suo verdetto prima che vengano eseguite; consulta [Il frame della chiamata a strumento](https://platform.claude.com/docs/it/manage-claude/inference-hooks-endpoint#the-tool-call-frame). È attivo per impostazione predefinita in una nuova configurazione. Non ha alcun effetto mentre **Applica i verdetti** è disattivato e una sua modifica impiega circa un minuto per raggiungere tutti i server di Anthropic, come per **Applica i verdetti**.
  </Step>
</Steps>

## Modalità shadow

La “shadow mode” (modalità ombra) esegue il tuo hook sul traffico reale senza bloccare nulla. Il tuo server di sicurezza AI riceve i prompt governati e restituisce i verdetti esattamente come farebbe in fase di applicazione, ma nulla viene bloccato: ogni richiesta procede verso il modello, anche quando il tuo server la rifiuta o non è raggiungibile, e l’utente finale non vede nulla. Usala per mettere a punto la tua policy sul traffico reale della tua organizzazione prima di iniziare ad applicare i verdetti. Con **Validate tool calls** attivo, il tuo server riceve anche i frame della chiamata a strumento in modalità shadow, e nessuna chiamata agli strumenti viene bloccata.

Per usare la modalità shadow, imposta **Modalità** su **Modalità shadow** sotto **Gestione degli errori**, quindi attiva **Applica i verdetti** affinché i prompt fluiscano verso il tuo server di sicurezza AI. Mentre è attiva, la pagina delle impostazioni mostra un badge **Modalità shadow — nessun blocco**. Per uscire dalla modalità shadow, reimposta **Modalità** su **Consenti la richiesta** o **Blocca la richiesta**; i verdetti vengono nuovamente applicati una volta che l’applicazione è attiva.

## Esclusioni

In **Who is inspected**, con **Limit by role** attivato, seleziona i ruoli i cui membri non sono coperti dagli Inference hooks: i loro prompt non vengono mai inviati al tuo server di sicurezza IA. Possono essere esclusi solo i ruoli personalizzati creati dalla tua organizzazione; i ruoli integrati non vengono proposti. Selezionali nel selettore dei ruoli, il cui testo segnaposto indica **Seleziona i ruoli da escludere**, e gestisci chi detiene ciascun ruolo dalla pagina di amministrazione dei ruoli (**Gestisci ruoli**); la modifica delle esclusioni richiede l’autorizzazione di gestione delle identità. L’elenco è vuoto per impostazione predefinita e, senza ruoli esclusi, ogni richiesta regolamentata viene ispezionata, a meno che **Ispeziona** non sia impostato su **Only selected roles**.

L’esclusione si applica alle sessioni interattive di un utente. Le modifiche all’elenco delle esclusioni vengono registrate nell’[Activity Feed](https://platform.claude.com/docs/it/manage-claude/compliance-activity-feed) della tua organizzazione come modifiche alle autorizzazioni dei ruoli (`rbac_role_permission_added` e `rbac_role_permission_removed`).

### Ispezionare solo i ruoli selezionati

Tutto ciò che si trova nella sezione **Who is inspected** dipende da un unico interruttore, **Limit by role**. Quando attivi l’interruttore, **Ispeziona** parte da **Everyone except excluded roles**, e i ruoli esclusi vengono selezionati al di sotto come descritto sopra.

Per provare prima gli Inference hooks su una parte della tua organizzazione, attiva **Limit by role**, imposta **Ispeziona** su **Only selected roles** e seleziona i ruoli nella finestra di dialogo che si apre. Da quel momento, vengono ispezionati solo i membri impostati su **Ruoli personalizzati** a cui è assegnato un ruolo selezionato. I membri impostati su qualsiasi altro ruolo, come **Utente** o **Proprietario**, non vengono ispezionati, anche se è loro assegnato un ruolo selezionato. Questo include anche te se sei impostato su **Proprietario** o **Proprietario principale**. Rimuovi ogni ruolo escluso prima di effettuare il passaggio: un’organizzazione usa le esclusioni oppure i ruoli selezionati, non entrambi. Dopo il passaggio, aggiungi o rimuovi ruoli nel selettore dei ruoli sotto **Ispeziona**. Per tornare a ispezionare tutti, disattiva **Limit by role**: dopo la conferma, questa operazione rimuove ogni ruolo escluso e disattiva **Only selected roles**.

Mentre è impostato **Only selected roles**:

* Un ruolo personalizzato il cui **Accesso alle funzionalità** è **Tutte le funzionalità** o **Tutti generalmente disponibili** conta solo se lo selezioni, come qualsiasi altro ruolo.
* Se a nessun membro impostato su **Ruoli personalizzati** è assegnato un ruolo selezionato, nessun membro viene ispezionato.
* Le richieste che non hanno un membro dietro non vengono ispezionate, come le richieste effettuate con chiavi API e le conversazioni Claude Tag in Slack.

Le modifiche a **Ispeziona** e ai ruoli ispezionati vengono registrate nell’[Activity Feed](https://platform.claude.com/docs/it/manage-claude/compliance-activity-feed) della tua organizzazione.

## Messaggio personalizzato per prompt bloccato

Sotto **Messaggio personalizzato per prompt bloccato**, imposta un testo personalizzato fino a 500 caratteri che viene aggiunto all’errore visualizzato dall’utente finale quando il tuo server di sicurezza AI nega una richiesta (tipicamente chi contattare o dove richiedere un’eccezione). Il messaggio finale è composto dal `deny_reason` per richiesta del tuo server di sicurezza AI (quando presente), una riga vuota, quindi questo testo. Senza testo personalizzato configurato, un valore predefinito integrato indirizza l’utente a contattare i propri amministratori; puoi anche disattivare del tutto il messaggio aggiunto in modo che l’utente veda solo il `deny_reason`.

## Monitorare il tuo server di sicurezza AI

L’area di stato dell’endpoint nella pagina delle impostazioni degli Inference hooks mostra:

* **Stato endpoint:** Operativo, Scattato, Applicazione non attiva oppure Non configurato prima che venga salvato un endpoint.
* **Errori al minuto:** errori del webhook negli ultimi 2 minuti, in media.
* **Tasso di blocco:** i rifiuti come quota dei verdetti del tuo server di sicurezza AI, mostrato quando la percentuale di rollout è inferiore a 100.
* **Interruttore di circuito scattato:** quando il circuit breaker è scattato l’ultima volta, se è scattato.
* **Errori recenti:** ogni voce mostra quando si è verificato l’errore, un tipo di errore e una categoria. La categoria è `webhook_error` per un problema con il tuo endpoint o con la connessione a esso, oppure `relay_error` per un errore all’interno dei sistemi di Anthropic. Una voce `DlpWebhookStatusError` può mostrare anche lo stato HTTP restituito dal tuo server di sicurezza IA e la dimensione del corpo della richiesta inviata da Anthropic, ad esempio `HTTP 413` · `1.3 MB`. Le voci non includono mai il contenuto della richiesta né l’URL del tuo endpoint. L’elenco conserva i 10 errori più recenti e si svuota un’ora dopo l’ultimo.

I tipi di errore in **Errori recenti** significano:

| Errore mostrato                                      | Cosa significa                                                                                                                                                                                                                                                                                                                                             | Conta ai fini del circuit breaker |
| ---------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------- |
| `DlpWebhookTimeoutError` · `webhook_error`           | Il tuo server di sicurezza AI non ha restituito un verdetto entro il **Timeout verdetto prompt (ms)** che hai impostato.                                                                                                                                                                                                                                   | Sì                                |
| `DlpWebhookStatusError` · `webhook_error`            | Il tuo server di sicurezza AI ha risposto con uno stato HTTP diverso da 200, ad esempio un reindirizzamento.                                                                                                                                                                                                                                               | Sì                                |
| `DlpWebhookResponseError` · `webhook_error`          | Il tuo server di sicurezza AI ha risposto 200, ma il corpo non è un verdetto valido o supera i 64 KiB.                                                                                                                                                                                                                                                     | Sì                                |
| `DlpWebhookTransportError` · `webhook_error`         | La connessione non è riuscita o si è interrotta prima che arrivasse una risposta completa: ad esempio, il nome host non è stato risolto o è stato risolto in un indirizzo privato, la connessione è stata rifiutata o reimpostata, oppure l’handshake TLS non è riuscito. Anche un problema di rete dal lato di Anthropic può manifestarsi in questo modo. | No                                |
| `DlpWebhookDisallowedAddressError` · `webhook_error` | L’host dell’URL dell’endpoint è un indirizzo IP privato o interno, un indirizzo IPv6 o `localhost`. Un nome host che si risolve in un indirizzo di questo tipo viene invece mostrato come errore di trasporto.                                                                                                                                             | Sì                                |
| `DlpWebhookBlockedError` · `webhook_error`           | L’URL dell’endpoint non è un URL `https://` sulla porta 443, oppure non può essere analizzato, quindi non è stata inviata alcuna richiesta.                                                                                                                                                                                                                | No                                |
| `DlpWebhookRelayError` · `relay_error`               | L’errore si è verificato all’interno dei sistemi di Anthropic e il tuo server di sicurezza AI di solito non è stato contattato.                                                                                                                                                                                                                            | No                                |

In modalità shadow, nessun errore conta ai fini del circuit breaker.

Il pannello è best-effort: se Anthropic non riesce a leggere i contatori, mostra zero errori e nessun errore recente anziché un proprio errore, quindi un pannello dall’aspetto sano non è di per sé una prova che il tuo server di sicurezza AI sia sano. **Errori al minuto** conta ogni errore, inclusi gli errori di rete e DNS che non fanno mai scattare il circuit breaker, quindi può essere alto mentre **Interruttore di circuito scattato** resta vuoto.

## Circuit breaker

Errori webhook prolungati attribuibili al tuo server di sicurezza AI fanno scattare il circuit breaker (interruttore di protezione), che interrompe l’applicazione dei verdetti: il tuo server non viene più contattato e la tua scelta di **Gestione degli errori** si applica a ogni richiesta ispezionata. Con **Blocca la richiesta** selezionato, gli utenti della tua organizzazione vengono bloccati finché il circuit breaker non si ripristina. Quando il circuit breaker scatta, gli amministratori vengono anche avvisati nel centro notifiche di claude.ai.

Ogni intervento viene anche registrato nell’[Activity Feed](https://platform.claude.com/docs/it/manage-claude/compliance-activity-feed) della tua organizzazione come attività `inference_hooks_circuit_breaker_tripped`, in modo che il tuo team di sicurezza o il tuo fornitore possa impostare avvisi sugli interventi dai sistemi di monitoraggio già in uso, ad esempio un SIEM che acquisisce il feed. Viene registrata un’attività per ogni intervento, non una per ogni richiesta interessata. La registrazione richiede che la Compliance API sia abilitata per la tua organizzazione; consulta [Configurare la Compliance API](https://platform.claude.com/docs/it/manage-claude/compliance-api-access).

Per ripristinare, correggi il server, quindi riattiva **Applica i verdetti** per reimpostare il circuit breaker.

Il circuit breaker può anche ripristinarsi da solo. A partire da 10 minuti dopo l’intervento, Anthropic verifica se il tuo server si è ripreso inviandogli una richiesta di test in background, al massimo circa una volta al minuto; non è coinvolta alcuna richiesta degli utenti. Se il tuo server risponde con un verdetto valido, di autorizzazione o di rifiuto, il circuit breaker si ripristina e l’applicazione dei verdetti riprende. In caso contrario, il circuit breaker resta scattato e le verifiche continuano.

Il ripristino automatico viene eseguito solo finché le impostazioni degli Inference hooks restano invariate dall’intervento. Se modifichi qualsiasi impostazione degli Inference hooks dopo un intervento, inclusa la rotazione del segreto di firma, le verifiche si interrompono e il circuit breaker non si ripristina più da solo; riattiva **Applica i verdetti** quando il tuo server è stato corretto. Il ripristino automatico si applica solo agli interventi: se disattivi tu stesso **Applica i verdetti**, l’applicazione resta disattivata finché non la riattivi.

## Ruotare il segreto di firma

Fai clic su **Ruota il segreto** in **Firma delle richieste** per sostituire il tuo segreto di firma. Se la tua organizzazione non ha ancora un segreto, lo stesso pulsante riporta **Genera segreto** e crea il primo. La rotazione è un passaggio immediato: il nuovo segreto viene generato e mostrato una sola volta, il vecchio segreto non può più essere recuperato e nessuna richiesta viene mai firmata con entrambi i segreti, quindi non esiste un periodo di sovrapposizione su cui fare affidamento.

Le richieste firmate con il segreto precedente possono ancora arrivare per breve tempo dopo la rotazione; [Verificare la firma](https://platform.claude.com/docs/it/manage-claude/inference-hooks-endpoint#verify-the-signature) spiega come il tuo server di sicurezza AI dovrebbe gestire il passaggio.

## Traccia di audit

L’attività degli Inference hooks viene registrata nell’[Activity Feed](https://platform.claude.com/docs/it/manage-claude/compliance-activity-feed) della tua organizzazione: modifiche alla configurazione, rifiuti, interventi del circuit breaker e richieste che sono proseguite senza ispezione perché non è stato possibile ottenere un verdetto. Quest’ultimo tipo viene registrato solo mentre **Applica i verdetti** è attivo e **Modalità** è **Consenti la richiesta**. Il suo motivo è `endpoint_timeout`, `endpoint_error` per qualsiasi altro problema nella chiamata al tuo server di sicurezza AI, oppure `internal_error` per un errore dal lato di Anthropic. Con **Blocca la richiesta** o **Modalità shadow**, le richieste non riuscite non vengono registrate singolarmente. Il ripristino automatico del circuit breaker non viene registrato in nessuna modalità. Mentre il circuit breaker è scattato, non vengono registrate attività degli Inference hooks per singola richiesta; l’attività dell’intervento è la registrazione di quell’intervallo nel feed. I record dei rifiuti contengono identificatori che ti consentono di associare ogni rifiuto al record corrispondente nel tuo sistema.

## Disattivare gli Inference hooks

Esistono due livelli di disattivazione:

* **Applica i verdetti** disattivato, nella pagina delle impostazioni degli Inference hooks: entro circa un minuto, i prompt della tua organizzazione smettono di essere inviati al tuo server di sicurezza IA; le richieste già in corso vengono completate con l’impostazione precedente. La pagina delle impostazioni rimane disponibile, quindi usa questa opzione per sospendere l’applicazione mentre lavori sul tuo server di sicurezza IA.
* **Consenti per la tua organizzazione** disattivato, nelle impostazioni **Dati e privacy**: i prompt non vengono più ispezionati e le impostazioni degli Inference hooks diventano non disponibili finché non lo riattivi. La configurazione dell’endpoint, gli header personalizzati e il segreto di firma vengono conservati in entrambi i casi; riattivarlo disattiva **Applica i verdetti** e azzera un circuit breaker scattato, quindi riattiva l’applicazione quando sei pronto.

## Passaggi successivi

<CardGroup cols={2}>
  <Card title="Sviluppare un’integrazione Inference hooks" href="https://platform.claude.com/docs/it/manage-claude/inference-hooks-endpoint">
    Costruisci il server di sicurezza AI: gli schemi di richiesta e verdetto, la verifica della firma e la semantica operativa.
  </Card>

  <Card title="Panoramica degli Inference hooks" href="https://platform.claude.com/docs/it/manage-claude/inference-hooks">
    Cosa sono gli Inference hooks, come funziona il ciclo di andata e ritorno del verdetto e cosa viene inviato al tuo server di sicurezza AI.
  </Card>
</CardGroup>
