In breve
- Risposte vere dai suoi sistemi.L'agente legge dati in tempo reale dalla sua API, come lo stato di un ordine, invece di tirare a indovinare da una pagina di aiuto.
- Firmate e sicure da ritentare.Ogni chiamata è firmata, così il suo server può dimostrare che arriva da OneType, e porta una chiave di idempotenza stabile.
- I visitatori approvano le modifiche.Gli strumenti che modificano qualcosa lo chiedono prima al visitatore nella chat, e quelli distruttivi chiedono sempre.
- Nessun numero d'ordine inventato.Un numero d'ordine o un altro ID deve provenire dal visitatore, dalla pagina o da un risultato precedente, mai dalla fantasia del modello.
La maggior parte dei chatbot si ferma alle risposte. Un visitatore chiede dov'è il suo ordine e il bot lo manda a una pagina di tracciamento. Con le azioni API il suo agente chiama il suo sistema, legge lo stato reale e glielo dice nella stessa conversazione. È come parlare con qualcuno del suo team che ha la schermata giusta aperta.
Come funziona
Un'API è l'indirizzo a cui risponde il suo software. Con le azioni API (in arrivo) aggiunge uno strumento: gli dà un nome, descrive con parole semplici quando l'agente deve usarlo e inserisce il metodo e l'indirizzo https del suo endpoint. Descrive i dati che servono, come un numero d'ordine, in un piccolo JSON Schema. Quando un visitatore chiede qualcosa che corrisponde, l'agente compila quei dati, OneType chiama il suo endpoint e l'agente risponde con ciò che la sua API ha restituito.
- Scelga il metodo: GET, POST, PUT, PATCH o DELETE.
- Inserisca i dati nel percorso con {parameter}; il resto va nella query o nel corpo JSON.
- Aggiunga header e contrassegni le credenziali come segrete, così vengono conservate in forma cifrata e non vengono più mostrate.
- Dica cosa fa lo strumento ai suoi dati: legge, modifica qualcosa o è distruttivo.
L'agente concatena i passaggi da solo
Una risposta può usare più strumenti. L'agente può cercare un ordine, poi verificare il periodo di reso, poi proporre di passare la chat a una persona, tutto in una sola risposta. Può eseguire fino a 20 chiamate a strumenti in una singola risposta e un agente può avere fino a 100 strumenti.
Progettato perché la sua API possa fidarsene
Ogni chiamata è firmata con un segreto di firma per agente, secondo lo schema aperto Standard Webhooks, così il suo server può verificare che arrivi davvero da OneType. Ogni chiamata porta anche una chiave di idempotenza che resta uguale in caso di nuovo tentativo, così la sua API può ignorare i duplicati. OneType chiama solo indirizzi internet pubblici e non segue mai i reindirizzamenti.
Per i dati personali, attivi “Only for signed-in visitors”. La chiamata include allora il contatto verificato, preso dal suo token di identità firmato, così il modello non può mai scegliere di quale account riguarda una ricerca. I visitatori anonimi vengono rifiutati.
Le modifiche richiedono il clic del visitatore
Uno strumento che si limita a leggere parte subito. Uno strumento che modifica qualcosa mostra al visitatore una domanda che scrive lei, come Annulla l'ordine #1234?, e parte solo dopo il suo clic di approvazione. Gli strumenti distruttivi chiedono sempre. Gli ID come numeri d'ordine o SKU devono provenire da ciò che il visitatore ha scritto, da ciò che mostra la pagina o dal risultato di uno strumento precedente. Se il modello ne inventa uno, la chiamata non parte e all'agente viene detto di cercarlo o di chiedere.
Veda come funziona l'approvazione del visitatore
Limiti da conoscere
Il suo endpoint deve rispondere in JSON entro 10 secondi e l'agente ne legge fino a 32 KB. Ogni strumento ha un proprio limite di chiamate al minuto, da 1 a 60, 10 per impostazione predefinita. Se una chiamata fallisce, l'agente viene informato e prosegue, per esempio proponendo una persona.