Cambiamenti recenti e futuri alle API

Di recente abbiamo modificato la policy di caching delle API relative agli Intenti Dinamici. Inoltre, rilasceremo a breve delle modifiche importanti alla API di Open Session, che richiederà un nuovo parametro obbligatorio.

MOdifiche alle API degli intenti dinamici

Modifiche alla policy di caching

Quando viene definito un Intento Dinamico o un suo Slot, un parametro (in virgola mobile) chiamato ValidityMinutes specifica per quanto tempo la risposta alla chiamata al webhook dell'Intento o dello Slot dev'essere tenuta in cache.

Questo parametro finora aveva i seguenti valori minimi:

• 0.1 (cioè 6 secondi) per gli Intenti
• 0.5 (cioè 30 secondi) per gli Slot

Questi valori forzavano un minimo di caching delle risposte del webhook. Questa policy è cambiata: sia per gli Intenti che per gli Slot il valore minimo accettato adesso è 0.0, cioè nessun caching. Se avete degli Intenti o degli Slot che devono necessariamente evitare qualsiasi caching, verificate le loro impostazioni e aggiornate questo parametro opportunamente.

Nuovo parametro Session ID

L'oggetto Intent WebHook Request ora ha un nuovo parametro (stringa) chiamato SessionID, che contiene l'ID unico della sessione di conversazione con il Twin. Con questa aggiunta, il webhook può distinguere facilmente chiamate provenienti da utenti differenti e comportarsi di conseguenza.

Prossime modifiche all'API Open Session

Limiti di età

Il 27 Aprile rilasceremo un'importante modifica alla piattaforma che introdurrà dei limiti di età per certi tipi di contenuti. La user base e gli user case della piattaforma stanno crescendo rapidamente, questo ci obbliga a introdurre dei controlli che finora erano delegati agli utenti stessi.

Specificatamente:

• L'attivazione della IA generativa è limitata agli utenti con almeno 14 anni
• Qualsiasi contenuto NSFW (cioè non adatto ai minori) sarà rilevato automaticamente e limitato agli utenti con almeno 18 anni

A partire dal 27 Aprile, al vostro prossimo accesso dovrete dichiarare la vostra data di nascita. Sulla base di questa, alcune feature (come la IA generativa o la possibilità di introdurre contenuti NSFW) saranno abilitate o meno.

Modifiche all'API Open Session

Quando si implementa un client custom, l'API Open Session è la chiamata iniziale che avvia la conservasione con il Twin. Questa API avrà un nuovo parametro (date-time) obbligatorio di nome BirthDate che dovrà contenere la data di nascita dichiarata dall'utente. I Twin che fanno uso di IA generativa o hanno contenuti NSFW verificheranno questo parametro e rifiuteranno l'apertura di sessione se il limite di età non è rispettato.

Per maggiori dettagli fate riferimento alla pagina Documentazione Servizi API, disponibile nella sezione Dev docs di TwinCreator (o della vostra piattaforma partner di designazione).