Claude Platform Docs
SDK, CLI e librerieSDK client

Middleware degli SDK

Intercetta e modifica le richieste e le risposte dell’SDK.

L’Anthropic SDK fornisce un hook di “middleware” (software intermedio), o interceptor, che esegue il tuo codice prima che l’SDK invii una richiesta e dopo che ne riceve la risposta. Usa il middleware per esigenze trasversali come il logging, i nuovi tentativi personalizzati, l’annotazione delle richieste e il nuovo tentativo di una richiesta rifiutata su un modello di fallback.

Ogni middleware può ispezionare o sostituire la richiesta prima di chiamare next(), e la risposta dopo che next() restituisce il controllo.

Registrazione del middleware

Ogni middleware è una funzione che riceve la richiesta in uscita e il gestore successivo. Chiama call_next(request) per inoltrare la richiesta al resto della catena (o direttamente al nucleo dell’SDK se questo è l’ultimo middleware) e restituisci la sua risposta. Tutto ciò che precede quella chiamata viene eseguito all’andata; tutto ciò che la segue viene eseguito al ritorno.

def logging_middleware(request: APIRequest, call_next: CallNext) -> APIResponse[Any]:
    # Prima della richiesta
    print(f"-> {request.method} {request.url}")

    # Inoltra la richiesta al resto della catena
    response = call_next(request)

    # Dopo la richiesta
    print(f"<- {response.status_code}")

    return response


client = Anthropic(middleware=[logging_middleware])

Ordine dei middleware

Quando registri più middleware, questi vengono applicati nell’ordine indicato: il codice “before” (prima) del primo middleware viene eseguito per primo, e il suo codice “after” (dopo) viene eseguito per ultimo. I middleware registrati sul client vengono eseguiti prima dei middleware passati come opzione per singola richiesta.

Per registrare più di un middleware, passali tutti, come in middleware=[first, second].

Sostituzione del client HTTP

L’SDK accetta anche un client HTTP personalizzato (per la configurazione del proxy, TLS personalizzato o il “connection pooling” (pool di connessioni)). Viene utilizzato un solo client HTTP per ciascun client dell’SDK; impostarlo sostituisce quello predefinito. Il client HTTP personalizzato riceve le richieste dopo che tutti i middleware sono stati eseguiti.

Middleware integrati

L’SDK include un middleware di fallback in caso di rifiuto che ritenta automaticamente su un modello di fallback una richiesta che Claude rifiuta (stop_reason: "refusal"). Rifiuti e fallback elenca i modelli i cui classificatori di sicurezza possono rifiutare le richieste, e Rilevare e ritentare su un modello di fallback illustra la configurazione e gli esempi per ciascun linguaggio.

Disponibilità

Middleware degli SDK
API
  • Messages API
  • Managed Agents Beta
Modelli
  • Tutti i modelli

Questa pagina ti è stata utile?