Puoi utilizzare gli strumenti per i widget per creare elementi dell'interfaccia utente avanzati e interattivi 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 client. Il client elabora 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). Aiuta il modello linguistico dell'agente a capire 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 di prodotti scorrevole.
- PRODUCT_DETAILS: mostra informazioni dettagliate su un singolo prodotto.
- QUICK_ACTIONS: presenta un elenco di pulsanti di risposta o azioni suggerite che l'utente può intraprendere.
- PRODUCT_COMPARISON: mostra un confronto fianco a fianco 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. Viene definito utilizzando un oggetto schema, specificando i campi e i tipi di dati previsti per i contenuti del widget.
Esempi di descrizioni degli strumenti
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 recuperato le informazioni di un prodotto e aver provato a mostrarlo all'utente. |
| Azione rapida | Questo strumento deve essere chiamato ogni volta che all'utente viene chiesto se è un'attività, una scuola o un'organizzazione no profit. Includi esattamente 3 azioni rapide con le seguenti diciture: "Sono un'attività", "Sono una scuola" e "Sono un'organizzazione no profit". |
| Confronto prodotti | Questo strumento deve essere richiamato quando ti viene chiesto di confrontare 2 prodotti. |
| Riepilogo ordine | Utilizza questo strumento quando un utente è pronto a finalizzare un acquisto. Genera un riepilogo visivo strutturato dell'articolo, la suddivisione dei prezzi (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. |