Puoi utilizzare gli strumenti per i widget per creare elementi dell'interfaccia utente interattivi e avanzati per la tua interfaccia utente in modo flessibile. Quando configuri questo strumento, fornisci un tipo (carosello, confronto e così via) e informazioni sullo schema del widget. Quando risponde alle query, l'agente può decidere di utilizzare questo strumento e questa configurazione per inviare i dati del widget al tuo cliente. Il client elabora quindi questi dati e presenta il widget nell'interfaccia utente. Quando l'utente effettua una selezione, invii queste informazioni all'agente.
Configurazione
Sono disponibili le seguenti impostazioni di configurazione:
- Nome:Un nome univoco per lo strumento (obbligatorio).
- Descrizione:Una descrizione di cosa fa lo strumento (facoltativo). In questo modo, il modello linguistico dell'agente capisce quando utilizzare questo strumento e come compilare i dati.
- Tipo di widget:
Il tipo specifico di widget di contenuti avanzati rappresentato da questo strumento.
Determina la struttura prevista del payload e
la modalità di rendering da parte del client.
I tipi sono i seguenti:
- PRODUCT_CAROUSEL: mostra un carosello scorrevole di prodotti.
- PRODUCT_DETAILS: mostra informazioni dettagliate su un singolo prodotto.
- QUICK_ACTIONS: mostra un elenco di pulsanti di risposta o azioni suggerite che l'utente può intraprendere.
- PRODUCT_COMPARISON: mostra un confronto affiancato di più prodotti.
- ORDER_SUMMARY: mostra un riepilogo di un ordine.
- Parametri:Lo schema di input per i dati del widget. L'agente utilizza lo schema quando richiama lo strumento. Questo viene definito utilizzando un oggetto schema, specificando i campi e i tipi di dati previsti per i contenuti del widget.
Descrizioni degli strumenti di esempio
Ecco alcuni esempi di descrizioni efficaci degli strumenti:
| Tipo di widget | Esempio di descrizione dello strumento |
|---|---|
| Carosello di prodotti | Genera un componente carosello dell'interfaccia utente. Obbligatorio ogni volta che l'utente chiede di visualizzare opzioni o un catalogo. Devi fornire l'elenco dei prodotti in productDetails e il sistema eseguirà automaticamente il rendering della scheda visiva. |
| Dettagli del prodotto | Questo strumento deve essere chiamato dopo aver ottenuto le informazioni su un prodotto e aver tentato di mostrarlo all'utente. |
| Azione rapida | Questo strumento deve essere chiamato ogni volta che all'utente viene chiesto se rappresenta un'attività, una scuola o un'organizzazione non profit. Includi esattamente tre azioni rapide con il testo "Sono un'attività", "Sono una scuola" e "Sono un'organizzazione non profit". |
| Confronto tra prodotti | Questo strumento deve essere richiamato quando ti viene chiesto di confrontare due prodotti. |
| Riepilogo dell'ordine | Utilizza questo strumento quando un utente è pronto a finalizzare un acquisto. Genera un riepilogo visivo strutturato dell'articolo, la suddivisione del prezzo (incluse tasse e spedizione) e il metodo di pagamento registrato. Chiama questo strumento solo dopo che l'utente ha confermato di voler procedere alla fase di pagamento. |