Per rendere disponibile l'assistente digitale (o l'abilità standalone) in Cortana, è necessario registrarlo tramite il servizio bot di Azure.

Prima di creare la registrazione, è necessario disporre di un account Microsoft.

Per creare la registrazione:

1. Accedere all'indirizzo https://portal.azure.com/ ed eseguire il login con l'account Microsoft.

2. Nel campo Cerca, cercare e selezionare Registrazione canali bot.

3. Nella pagina Registrazione canali bot, compilare il campo Nome bot con il testo che si desidera utilizzare come nome di richiamo quando si accede all'assistente digitale tramite il canale Cortana.

4. Completare gli altri campi obbligatori.

5. Scorrere verso il basso e selezionare Creazione automatica ID applicazione e password, quindi fare clic sul pulsante per Creazione automatica ID applicazione e password nel pannello che si apre.

6. Fare clic su Crea.

7. Attendere uno o due minuti affinché la registrazione del bot venga creata e distribuita.

   Al termine, si riceverà una notifica che indica che la distribuzione è riuscita.

8. Nella notifica, fare clic su Vai alla risorsa.

   Se la notifica scompare prima di poterla fare clic, è possibile riaprirla facendo clic sull'icona Notifiche nella parte superiore della pagina.
   
   Descrizione dell'immagine azure-notification.png
   

9. Nella barra di navigazione sinistra, in Gestione bot, selezionare Settings.

10. Copiare il valore di Microsoft App ID e salvarlo in un luogo sicuro.

11. Generare e salvare un segreto client. Per fare questo:

    1. Fare clic sul pulsante Gestisci accanto all'ID applicazione.

       Viene visualizzata la console Microsoft Bot Framework.

    2. Fare clic su Visualizza questa applicazione nel portale di Azure.

       In questo modo si torna ad Azure.

    3. Nella navigazione a sinistra, fare clic su Certificati e segreti.
    4. Fare clic su + New Client Secret.
    5. Fare clic su Aggiungi.
    6. Copiare il segreto client e salvarlo in un luogo sicuro sul sistema.

    Per configurare il canale in Digital Assistant, è necessario sia l'ID applicazione che il segreto client.

12. Dopo aver copiato il segreto client, chiudere la finestra di dialogo Certificati e segreti.

13. Lasciare aperto il portale Azure nel browser.

    In seguito si completerà la registrazione con un URL webhook che si ottiene quando si crea il canale in Digital Assistant.

1. In Digital Assistant, fare clic sui canali nel menu a sinistra, quindi scegliere Utenti.

2. Fare clic su + Canale per aprire la finestra di dialogo Crea canale.

3. Dai un nome al tuo canale.

4. Scegliere Cortana come tipo di canale.

5. Compilare l'ID bot Microsoft con l'ID applicazione Microsoft ottenuto quando si è creata la registrazione del bot in Azure.

6. Compilare Microsoft Bot Password (Client Secret Value) con il valore segreto client ottenuto dalla registrazione del bot.

7. Fare clic su Crea.

8. Nella pagina Canali, copiare l'URL WebHook e incollarlo in un punto appropriato nel sistema.

9. Fare clic su e selezionare l'assistente digitale o lo skill che si desidera associare al canale.

10. Accendere il controllo Channel Enabled.

1. Nella scheda del browser in cui è aperto il portale di Azure, utilizzare il campo Cerca per tornare alla registrazione del bot.

2. Nella barra di navigazione a sinistra selezionare Impostazioni.

3. Nel campo Endpoint messaggistica incollare l'URL del webhook ottenuto durante la creazione del canale in Digital Assistant.

4. Salva le modifiche.

5. All'interno del servizio bot nella barra di navigazione a sinistra, scorrere fino alla sezione Gestione bot e fare clic su Canali.

6. Fare clic sull'icona per Cortana.

7. Dopo aver configurato il canale, fare clic su Distribuisci su Cortana.

Con il canale Cortana e la configurazione della messaggistica completa, puoi testare il tuo bot (assistente digitale o abilità) a Cortana.

È possibile eseguire il test utilizzando una delle seguenti opzioni:

• All'interno del portale Azure, con la funzione Test in Web Chat (in Gestione bot).
• Attraverso l'app Cortana (sia desktop che mobile), utilizzando lo stesso ID utente utilizzato durante l'impostazione della registrazione del bot in Azure.

  Quando si esegue il test utilizzando questo metodo, è necessario includere il nome del bot (registrato nel portale di Azure) ogni volta che si inserisce qualcosa nella finestra di chat. In caso contrario, Cortana non riconoscerà necessariamente che stai cercando di parlare con l'assistente digitale Oracle.

I canali Cortana in Digital Assistant supportano le seguenti funzionalità:

• testo (sia di invio che di ricezione)
• immagini (supporto completo per l'invio, nessun supporto per la ricezione)
• file (supporto completo per l'invio, nessun supporto per la ricezione)
• emoji (pieno supporto per l'invio, nessun supporto per la ricezione)
• collegamenti
• componenti personalizzati
• componenti carosello
• elencare i componenti
• indicatore di digitazione

I canali Cortana in Digital Assistant hanno i seguenti vincoli di messaggio:

• Messaggi di testo
  • Lunghezza massima dell'etichetta dell'azione di testo: 1 riga (circa 50 caratteri)
  • Tipi di azioni di testo consentiti: Postback, Call, URL
• Schede orizzontali
  • Lunghezza massima del titolo: 2 righe (circa 80 caratteri)
  • Lunghezza massima della descrizione: 25.000 caratteri
  • Lunghezza massima dell'etichetta di azione della scheda: 1 riga (circa 50 caratteri)
  • Numero massimo di carte: 10
  • Numero massimo di azioni carta: 6. Se il numero di azioni della scheda supera 6, la scheda viene duplicata per eseguire il rendering delle azioni della scheda rimanenti.
  • Numero minimo di azioni carta: 0
  • Numero massimo di azioni elenco carte: 6
  • È richiesta almeno una descrizione, un'immagine o un'azione?: No
  • Tipi di azioni della carta consentiti: Postback, Call, URL
  • Tipi di azioni dell'elenco di carte consentite: Postback, Call, URL
• Schede verticali
  • Lunghezza massima del titolo: 2 righe (circa 80 caratteri)
  • Lunghezza massima della descrizione: 25.000 caratteri
  • Lunghezza massima dell'etichetta di azione della scheda: 1 riga (circa 50 caratteri)
  • Numero massimo di carte: 10
  • Numero massimo di azioni carta: 3
  • Numero minimo di azioni carta: 0
  • Numero massimo di azioni elenco carte: 6
  • È richiesta almeno una descrizione, un'immagine o un'azione?: No
  • Tipi di azioni della carta consentiti: Postback, Call, URL
  • Tipi di azioni dell'elenco di carte consentite: Postback, Call, URL
• Messaggi allegato
  • Supportato?: Sì
  • Tipi di azioni consentite: Postback, Call, URL
• Pulsanti di azione
  • Lunghezza massima dell'etichetta di azione globale: 1 riga (circa 50 caratteri)
  • Numero massimo di azioni globali: 6
  • Tipi di azioni globali consentite: Postback, Chiamata, URL

Per i canali Cortana, è possibile estendere la funzionalità dei componenti Common Response con funzionalità specifiche di Cortana.

Per accedere alle estensioni, utilizzare l'elemento channelCustomProperties nel componente e impostare le proprietà appropriate. Il codice ha il formato seguente:

...
            channelCustomProperties:
            - channel: "cortana"
              properties:
                PROPERTY_NAME: "PROPERTY_VALUE"
...

Ecco le proprietà personalizzate disponibili per i canali Cortana:

Per ulteriori informazioni sull'uso di channelCustomProperties, vedere Estensioni specifiche del canale.