Oggetti
ChatRequest
Richiesta di una risposta dell’assistente: gli ultimi turni della conversazione, la raccolta, le impostazioni di ricerca, la modalità di risposta, l’esportazione, la limitazione a schede specifiche, la conversazione, l’origine della domanda e gli strumenti.
Campi
items ≥ 1
collectionstringPredefinito: "default"
tagsarray of string | nullexportstring | nullcard_idsarray of string | nullitems ≤ 50
streambooleanPredefinito: false
conversation_idstring | nulllength ≤ 64
originstring | nulltoolsboolean | nullbypass_cachebooleanNon prendere la risposta dalla cache delle risposte (il pulsante “Get a fresh answer”, ottenere una risposta nuova, sotto una risposta dalla cache). La nuova risposta sostituisce la voce nella cache.
Predefinito: false
languagestring | nullLingua della risposta: un codice ISO 639-1 (
de,en,ru, …) per rispondere in quella lingua. Conautoo senza il campo, la lingua viene rilevata dalla domanda. L’interfaccia passa esplicitamente la lingua di un suggerimento in un’altra lingua (Starter.language).scopeChatScope | nullPerimetro della domanda: più raccolte, una fonte, tag e un periodo. Le raccolte del perimetro sostituiscono
collection. Una fonte restringe la risposta alla sua raccolta (e alle sue schede). I tag si aggiungono atags. Il periodo limita le risposte finanziarie a quel periodo. Puoi selezionare solo ciò che l’utente può vedere (raccolte:collections.no_access/collections.not_found; fonte:sources.not_found). Conconversation_id, il perimetro viene salvato nella conversazione. Senza il campo si applica il perimetro della conversazione;nullo un perimetro vuoto lo azzera.request_idstringChiave di idempotenza della domanda. Invia la stessa chiave in ogni nuovo tentativo dello stream per una stessa domanda (un nuovo tentativo dopo una disconnessione; qui
Last-Event-IDnon riprende lo stream e viene solo registrato). Un nuovo tentativo con la chiave di una risposta già salvata non crea una seconda domanda: il risultato salvato viene inviato di nuovo come un unico eventodone(e untokencon il testo), anche se il limite di domande o di crediti è esaurito. Se la risposta precedente è ancora in fase di generazione per un client disconnesso, quella generazione si interrompe e la risposta viene generata di nuovo.length ≤ 64
version_ofinteger (int64)Crea una nuova versione del turno di questa domanda nella conversazione (
question_iddal feed): una domanda modificata (nuovo testo inmessages), una risposta rigenerata (lo stesso testo, di solito conbypass_cache) o la stessa domanda con un altro valore diquality(per esempioprecisedopo una rispostafast). La coppia precedente di domanda e risposta viene conservata. I turni successivi restano nel suo ramo e sono nascosti dal feed mentre è selezionata la nuova versione (FeedItem.versions,POST /v1/conversations/{conv_id}/versions). La cronologia usata per la risposta è il ramo selezionato fino a questo turno. Il valorequalitydi una versione non cambia le impostazioni della conversazione. Richiedeconversation_id; una domanda di un’altra conversazione restituisce404 questions.not_found.qualitystringEquilibrio tra velocità e accuratezza della ricerca alla base del risultato:
fastè più rapida,preciseè più accurata. Predefinito:precise.Valori ammessi:
fastprecise