Responses e contesto

La superficie Responses permette le continuazioni previste dal protocollo con stato conservato da Netter. È distinta sia dalla cronologia del portale sia da una richiesta Chat Completions stateless.

Creare una risposta

curl --fail-with-body https://api.llm.netter.io/v1/responses \
  -H "Authorization: Bearer $NETTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"NOME_PUBBLICO","input":"Riassumi i vantaggi di una coda di lavoro.","max_output_tokens":1024,"store":true}'

Usa un modello con mapping Responses abilitato. Conserva l’identificativo restituito se devi recuperare la risposta o continuare dal contesto.

Continuare, leggere e cancellare

Azione	Operazione
Continuare	Nuovo POST /v1/responses con previous_response_id nel contesto consentito
Recuperare	GET /v1/responses/{id}
Cancellare	DELETE /v1/responses/{id}

La risorsa rimane isolata per proprietario e tenant. Un identificativo di un altro utente non concede accesso. Le continuazioni ricostruiscono l’input completo necessario; all’upstream viene inviato store=false secondo il flusso Netter.

Conservazione e costo

Lo stato conservato è cifrato, con durata predefinita di 30 giorni. La cancellazione riguarda la risorsa conservata da Netter; ogni continuazione mantiene il proprio contesto e la relativa mappa. Cancellare una risposta non cancella automaticamente tutte le altre risorse della catena.

Una continuazione può rielaborare il contesto ricostruito: non equivale a una memoria gratuita lato provider. Le richieste mantengono prenotazioni e contabilizzazione del proprio consumo.

Modelli e artefatti opachi

Mantieni modello e parametri compatibili con il contesto. Switchyard non riclassifica una continuazione vincolata come se fosse una nuova conversazione indipendente. Se il target viene revocato o cambia la configurazione vincolante, avvia un nuovo contesto compatibile.

Le firme e i blocchi di reasoning cifrati devono essere conservati senza riscritture. Gli artefatti protetti possono scadere o diventare invalidi dopo una rotazione interna delle chiavi.

Tre forme di cronologia

• Chat del portale: conversazioni salvate dopo una risposta completata.
• Chat Completions: il client invia il contesto necessario a ogni richiesta.
• Responses conservate: il client può richiamare risorse e continuazioni autorizzate.

Nessuna delle tre introduce memoria automatica tra conversazioni indipendenti. Un archivio S3 opzionale è un ulteriore flusso di esportazione, non un contesto automaticamente riutilizzato dal modello.