What's my plan?
Add-on AI agents - Advanced

Un modello è una versione specifica di una risposta per gli agenti AI avanzati che puoi usare più volte nei flussi di conversazione o nei dialoghi.

Non puoi creare modelli con il dashboard del componente aggiuntivo Agenti AI avanzati se il bot è integrato tramite la messaggistica anziché direttamente con Sunshine Conversations. In tal caso, verrà visualizzato il messaggio di errore: il bot non è autorizzato. Tuttavia, se il bot usa l’integrazione della messaggistica, questo articolo mostra come creare modelli inviando richieste all’API Sunshine Conversations v1 e come applicare la scorciatoia in un flusso di dialogo.

Nota: Se il bot è integrato direttamente con Sunshine Conversations, consulta Creazione di modelli per agenti AI avanzati con Sunshine Conversations.

Questo articolo include le seguenti sezioni:

  • Creazione delle chiavi API di conversazione
  • Download della raccolta Sunshine Conversations Postman
  • Autorizzazione postino
  • Creazione del modello
  • Applicazione della scorciatoia in un flusso di dialogo

Creazione delle chiavi API di conversazione

Le richieste API Sunshine Conversations richiedono l’autenticazione tramite l’autenticazione di base o JSON Web Token (JWT). Entrambi i metodi richiedono una chiave API.

Puoi creare queste chiavi usando la pagina API conversazioni . Per maggiori informazioni, consulta Uso delle chiavi API conversazioni. Copia e archivia l’ ID app, l’ID chiavee la chiave segreta in un luogo sicuro, poiché ti serviranno in seguito.

Download della raccolta Sunshine Conversations Postman

Zendesk consiglia di usare Postman per inviare richieste all’API Sunshine Conversations v1.

È disponibile una raccolta predefinita di Sunshine Conversations Postman, che include richieste di esempio per la creazione e la gestione dei modelli.

Per scaricare la raccolta Postman Sunshine Conversations v1

  • Se Postman è già installato o vuoi usare Postman per il Web, fai clic su Esegui in Postman.
  • Per scaricare la raccolta senza importarla direttamente in Postman, fai clic su Scarica raccolta e salva il file sul disco locale usando il metodo di download specifico del browser. La raccolta è in formato JSON e può essere importata manualmente in Postman.

La nuova raccolta si chiama Smooch in Postman.

Autorizzazione postino

Prima di inviare richieste autenticate all’API Sunshine Conversations con Postman, devi configurare Postman usando le credenziali API. Questo passaggio di autorizzazione verifica la tua identità e garantisce l’accesso sicuro ai tuoi dati per le operazioni autorizzate.
Nota: I passaggi seguenti presuppongono che tu abbia importato la raccolta Sunshine Converations in Postman.

Per autorizzare Postman con le chiavi API conversazioni

  1. In Postman, fai clic sulla raccolta Smooch .
  2. Fai clic sulla scheda Variabili .
  3. Aggiungi variabili keyId, appId, e secret e inserisci i valori corrispondenti dalle chiavi di conversazione nella colonna Valore corrente .
  4. Aggiungi variabili url e apiVersion, quindi invio https://{subdomain}.zendesk.com/sc e v1.1 rispettivamente come valori correnti. Sostituisci {subdomain} con il nome del sottodominio.

  5. Fai clic su Salva nell’angolo in alto a destra.
  6. Fai clic sulla scheda Autorizzazione .
  7. Fai clic sul menu Tipo di autenticazione e seleziona Autenticazione di base.
  8. Invio {{keyId}} nel campo Nome utente e {{secret}} nel campo Password per fare riferimento ai valori della scheda Variabili.

  9. Fai clic su Salva.

Creazione del modello

L’API Sunshine Conversations v1 è il servizio principale che crea e gestisce i modelli sul server. Per creare un modello, devi inviare una richiesta direttamente all’endpoint Crea modelli .

La raccolta Sunshine Conversations importata include richieste di esempio per la creazione di modelli, che puoi personalizzare con i dettagli del modello. Quando finalizzi i dettagli del modello in Postman e fai clic su Invia, Postman invia la richiesta HTTP direttamente all’API Sunshine Conversations . L’API elabora la richiesta e crea o aggiorna il modello sul server.

Consulta Messaggi modello per modelli di esempio e istruzioni su come creare il tuo modello usando l’endpoint Crea modelli.

Per creare il modello
  1. In Postman, apri la raccolta Smooch , quindi seleziona Modelli > Crea esempi di modelli.
  2. Seleziona un modello di esempio e compila il corpo della richiesta con i tuoi dettagli, oppure creane uno nuovo.

    Specifica un nome nel corpo della richiesta anziché usare il valore predefinito. Userai questo nome nella sezione successiva.

    {
    "name": "my-test-template",
    "message": {
    	   "type": "text",
        "role": "appMaker",
        "text": "This is a text template"
    }
}
  3. Fai clic su Invia per inviare la richiesta e creare il modello. Riceverai una risposta JSON simile alla seguente. 
    {
    "template": {
        "_id": "688113ef4a286305984b70c0",
        "message": {
            "role": "appMaker",
            "type": "text",
            "text": "This is a text template"
        },
        "name": "my-test-template",
        "isLarge": false
    }
}

Applicazione della scorciatoia in un flusso di dialogo

Per inviare un modello in una conversazione, usa la sintassi abbreviata dedicata all’interno di un blocco di messaggi agente AI . Una scorciatoia è una semplice sintassi che inserisci all’interno di un blocco di messaggi di dialogo per fare riferimento e inviare un messaggio modello pre-creato. Invece di riscrivere l’intero contenuto del messaggio ogni volta, usi la scorciatoia per indicare agenti AI di recuperare e consegnare il modello memorizzato in base al nome.

Per garantire che l’ agenti AI invii il modello, la scorciatoia deve essere aggiunta a un blocco di messaggi agente AI all’interno dello strumento di creazione dialoghi.

Per applicare l’abbreviazione
  1. In Agenti AI - Avanzate, fai clic su Contenuto > Casi d’uso.
  2. Seleziona il caso d’uso per la finestra di dialogo a cui vuoi inviare il modello.
  3. Fai clic su Modifica finestra di dialogo.
  4. Aggiungi un blocco di messaggi agente AI al flusso.

    Il modello specificato verrà inviato nel punto esatto del flusso di dialogo in cui inserisci questo blocco.

  5. All’interno del nuovo blocco, inserisci il modello usando la sintassi abbreviata %((template:value_of_name_field))%.

    Sostituisci value_of_name_field con il nome definito in Creazione del modello.

  6. Fai clic su Salva.
  7. Fai clic su Pubblica.

Per testare il modello, usa un widget attivo incorporato nel Centro assistenza o nel sito web. Ad esempio, puoi creare una pagina HTML di base e incorporare il widget dalla scheda di messaggistica nel Centro amministrativo. In alternativa, puoi anche provare usando il bot live o di produzione. La finestra di dialogo di test in Agenti AI - Avanzati non si collega a sistemi di dati dei clienti esterni, quindi le azioni che coinvolgono tali sistemi non possono essere eseguite durante il test. Al contrario, il bot di prova è progettato principalmente per verificare l’accuratezza dei flussi di dialogo.

Avvertenza sulla traduzione: questo articolo è stato tradotto usando un software di traduzione automatizzata per fornire una comprensione di base del contenuto. È stato fatto tutto il possibile per fornire una traduzione accurata, tuttavia Zendesk non garantisce l'accuratezza della traduzione.

Per qualsiasi dubbio sull'accuratezza delle informazioni contenute nell'articolo tradotto, fai riferimento alla versione inglese dell'articolo come versione ufficiale.

Powered by Zendesk