Risposte arricchite: tabelle, schede e risposte rapide in chat

Con Rich replies attivo, l'agente può mostrare contenuti strutturati dentro la chat, sotto il suo testo:

• una tabella, per confrontare più cose sugli stessi punti, come piani, prodotti o orari di apertura;
• schede, una fila di opzioni tra cui scegliere, ognuna con un titolo e, se serve, un'immagine, un prezzo e dei pulsanti;
• risposte rapide, pulsanti brevi per passi successivi chiari. Toccandone uno, il suo testo viene inviato come messaggio del visitatore.

L'agente scrive sempre anche una risposta di testo. Le risposte arricchite stanno sotto di essa, come le schede prodotto e gli orari di prenotazione.

Attivarle o disattivarle

Apri il tuo agente, seleziona la scheda Appearance e trova l'interruttore Rich replies, accanto a Suggest follow-up questions e Show sources under replies. È attivo di default per ogni agente. Fai clic su Save changes per applicare una modifica.

Il Playground usa l'interruttore così come è sullo schermo, quindi puoi provarlo prima di salvare.

Disattivandolo, non vengono più mostrate nuove risposte arricchite. Le risposte che ne hanno già mostrata una la mantengono nella conversazione.

Quando l'agente le usa

L'agente decide per ogni risposta. Gli viene detto di usare le risposte arricchite solo quando aiutano:

Gli viene detto di non usarle per un singolo dato, un sì o un no, due chiacchiere o una risposta di un solo paragrafo breve, e di riempirle solo con fatti presi dalla tua conoscenza, dalla conversazione o dai risultati delle tue azioni, mai con prodotti, prezzi, link o immagini inventati. Come per qualsiasi risposta dell'IA, controlla le risposte importanti nel Playground e usa le tue istruzioni per guidarlo, per esempio "Mostra i nostri piani in una tabella quando qualcuno chiede dei prezzi."

Una risposta arricchita fa parte della stessa risposta, quindi non usa un messaggio in più, e attivare l'interruttore non cambia il modo in cui la risposta viene trasmessa in streaming. La risposta arricchita compare quando il testo è completo. Un visitatore che tocca una risposta rapida o il pulsante di risposta di una scheda invia un messaggio, che conta come uno scritto a mano.

Limiti e regole di sicurezza

Una risposta mostra al massimo una tabella, una fila di schede e un gruppo di risposte rapide.

intoCHAT controlla ogni risposta arricchita prima di mostrarla:

• Tutto è testo semplice. L'HTML viene rifiutato, e i segni Markdown come ** vengono rimossi.
• Link e immagini devono essere indirizzi https:// completi. I link http://, javascript: e data:, gli indirizzi con nome utente o password e gli indirizzi senza dominio come localhost vengono rifiutati.
• Le risposte rapide e i pulsanti di risposta non possono contenere un link, perché il loro testo viene inviato come messaggio del visitatore.

Una tabella, una fila di schede o un gruppo di risposte rapide che viola una regola non viene mostrato affatto, mai in parte. La risposta di testo e le altre risposte arricchite valide compaiono comunque. Quando il tuo agente ha anche azioni, moduli in chat o altri strumenti, gli viene detto che cosa non andava e può correggerlo nella stessa risposta.

Come appaiono nel widget

• Le risposte arricchite compaiono sotto il messaggio dell'agente, allineate a esso, nel tema chiaro o scuro del tuo widget. I pulsanti di link e di risposta sulle schede usano il colore di Launcher bubble.
• Su uno schermo stretto, una tabella scorre di lato. Più schede formano una fila che scorre di lato, con le frecce per chi usa il mouse. Una scheda singola viene mostrata a tutta larghezza.
• Le risposte rapide compaiono solo sotto l'ultima risposta e spariscono quando il visitatore invia un messaggio. Mentre sono mostrate le risposte rapide, le domande di approfondimento non lo sono, così le due non si fanno concorrenza.
• I link delle schede si aprono in una nuova scheda del browser. Con Keep campaign tags on links attivo (vedi Aspetto), portano con sé i tuoi tag di campagna come gli altri link nelle risposte.
• Tutto funziona con la tastiera: pulsanti e link si raggiungono con Tab, e la tabella e la fila di schede possono ricevere il focus e scorrere con i tasti freccia. Gli screen reader annunciano la didascalia della tabella, il numero di schede e il gruppo di risposte rapide.

Le etichette del widget stesso, come "More", "Previous", "Quick replies" e la nota che un link si apre in una nuova scheda, seguono la lingua del widget; in italiano sono "Altro", "Precedente", "Risposte rapide" e "si apre in una nuova scheda". Il testo dentro una risposta arricchita è scritto dall'agente, nella lingua della sua risposta.

Dove altro compaiono le risposte arricchite

Nell'API

Inviare un messaggio (senza streaming) e Leggere una conversazione aggiungono un campo ui a una risposta dell'agente che ha mostrato una risposta arricchita. Una risposta senza non ha il campo ui. Gli strumenti MCP chat_with_agent e get_conversation restituiscono lo stesso. content e reply restano testo semplice senza la risposta arricchita.

{
  "id": "MESSAGE_ID",
  "role": "assistant",
  "content": "Here are our two plans.",
  "createdAt": "2026-10-27T10:00:00.000Z",
  "authorName": null,
  "sources": [],
  "ui": [
    {
      "type": "table",
      "title": "Plans",
      "columns": ["Plan", "Price", "Seats"],
      "rows": [["Basic", "CHF 9", "1"], ["Pro", "CHF 29", "5"]]
    },
    {
      "type": "cards",
      "cards": [
        {
          "title": "Pro",
          "subtitle": "For growing teams",
          "image": "https://www.example.com/pro.png",
          "price": "CHF 29 / month",
          "buttons": [
            { "label": "See details", "url": "https://www.example.com/pricing" },
            { "label": "Start a trial", "reply": "I'd like to start a Pro trial" }
          ]
        }
      ]
    },
    { "type": "quick_replies", "replies": ["Compare features", "Talk to sales"] }
  ]
}

Ogni elemento ha un type: table (con columns, rows e un title facoltativo), cards (ogni scheda con title, subtitle, image e price facoltativi, e buttons con una label e un url oppure una reply) oppure quick_replies (con replies). I campi facoltativi vengono omessi quando sono vuoti.

Passi successivi

• Personalizza l'aspetto del widget
• Collega il negozio per avere schede prodotto da ricerche in tempo reale
• Scrivi istruzioni che dicano all'agente quando fare un confronto in una tabella