Pour rendre votre assistant numérique (ou compétence autonome) disponible dans Cortana, vous devez l'avoir enregistré au moyen d'Azure Bot Service.

Pour créer cet enregistrement, vous devez disposer d'un compte Microsoft.

Pour créer l'enregistrement :

1. Allez à https://portal.azure.com/ et connectez-vous à votre compte Microsoft.

2. Dans le champ de recherche, recherchez et sélectionnez Inscription de chaînes de bot.

3. Dans le champ Nom du bot de la page Inscription de chaînes de bot, entrez le nom à utiliser pour accéder à votre assistant numérique par le canal Cortana.

4. Remplissez le reste des champs obligatoires.

5. Faites défiler la page vers le bas et sélectionnez Créer automatiquement l'ID d'application et le mot de passe, puis cliquez sur le bouton Créer automatiquement l'ID d'application et le mot de passe dans le panneau qui s'ouvre.

6. Cliquez sur Create (Créer).

7. Patientez quelques minutes pendant la création et le déploiement de l'enregistrement du robot.

   Une fois le processus terminé, vous recevrez un avis indiquant que le déploiement a réussi.

8. Dans l'avis, cliquez sur Accéder à la ressource.

   Si l'avis disparaît avant que vous puissiez cliquer dessus, cliquez sur l'icône d'avis en haut de la page.
   
   Description de l'illustration azure-notification.png
   

9. Dans la barre de navigation de gauche, sous Gestion des bots, sélectionnez Paramètres.

10. Copiez la valeur du champ ID d'application Microsoft et enregistrez-la en lieu sûr.

11. Générez et enregistrez une clé secrète client. Procédez de l'une des façons suivantes :

    1. Cliquez sur le bouton Manage (Gérer) situé à côté de l'ID application.

       Vous accédez ainsi à la console Microsoft Bot Framework.

    2. Cliquez sur View this app in the Azure portal (Voir cette application dans le portail Azure).

       Vous retournez dans Azure.

    3. Dans la barre de navigation de gauche, cliquez sur Certificates & secrets (Certificats et clés secrètes).
    4. Cliquez sur + New Client Secret (Nouvelle clé secrète client).
    5. Cliquez sur Add (Ajouter).
    6. Copiez la clé secrète client et enregistrez-la en lieu sûr sur votre système.

    Vous aurez besoin de l'ID application et de la clé secrète client pour configurer le canal dans Digital Assistant.

12. Maintenant que vous avez copié la clé secrète client, fermez la boîte de dialogue Certificates & secrets (Certificats et clés secrètes).

13. Laissez le portail Azure ouvert dans votre navigateur.

    Vous achèverez ultérieurement l'enregistrement à l'aide d'une URL de webhook obtenue lors de la création du canal dans Digital Assistant.

1. Dans Digital Assistant, cliquez sur Channels (Canaux) dans le menu de gauche, puis sélectionnez Users (Utilisateurs).

2. Cliquez sur + Channel (Canal) pour ouvrir la boîte de dialogue Create Channel (Créer un canal).

3. Donnez un nom à votre canal.

4. Sélectionnez le type de canalCortana.

5. Dans le champ ID robot Microsoft, indiquez l'ID application Microsoft obtenu lors de la création de l'enregistrement de votre robot dans Azure.

6. Entrez le mot de passe du robot Microsoft (valeur de la clé secrète client) avec la valeur de la clé secrète client obtenue lors de l'enregistrement du robot.

7. Cliquez sur Create (Créer).

8. Dans la page Channels (Canaux), copiez l'URL du webhook et collez-la à un endroit pratique sur votre système.

9. Cliquez sur et sélectionnez l'assistant numérique ou la compétence à associer au canal.

10. Activez le commutateur Channel Enabled (Canal activé).

1. Dans l'onglet du navigateur où le portail Azure est ouvert, utilisez le champ de recherche pour retourner à l'enregistrement de votre robot.

2. Dans la barre de navigation de gauche, sélectionnez Paramètres.

3. Dans le champ Point de terminaison de la messagerie, collez l'URL du webhook obtenue lors de la création du canal dans Digital Assistant.

4. Enregistrez vos modifications.

5. Dans la barre de navigation de gauche du service de robot, faites défiler la page vers le bas jusqu'à la section Gestion des bots et cliquez sur Canaux.

6. Cliquez sur l'icône correspondant à Cortana.

7. Après avoir configuré le canal, cliquez sur Déployer sur Cortana.

Une fois la configuration du canal Cortana et de la messagerie terminée, vous pouvez tester votre robot (assistant numérique ou compétence) dans Cortana.

Vous pouvez effectuer le test à l'aide de l'une des options suivantes :

• Dans le portail Azure, avec la fonction Tester dans une discussion web (sous Gestion des bots).
• À l'aide de l'application Cortana (de bureau ou mobile), avec l'ID utilisateur ayant servi à configurer l'enregistrement du robot dans Azure.

  Lorsque vous utilisez cette méthode, vous devez inclure le nom du robot (tel qu'inscrit dans le portail Azure) chaque fois que vous entrez des données dans la fenêtre de clavardage. Sinon, Cortana ne comprendra peut-être pas que vous tentez de communiquer avec l'assistant numérique d'Oracle.

Les canaux Cortana dans Digital Assistant prennent en charge les fonctions suivantes :

• texte (envoi et réception)
• images (prise en charge complète pour l'envoi, aucune pour la réception)
• fichiers (prise en charge complète pour l'envoi, aucune pour la réception)
• émojis (prise en charge complète pour l'envoi, aucune pour la réception)
• liens
• composants personnalisés
• composants de carrousel
• composants de liste
• indicateur de frappe

Dans Digital Assistant, les canaux Cortana présentent les contraintes suivantes liées aux messages :

• Messages texte
  • Longueur maximale de l'étiquette d'action de texte : 1 ligne (50 caractères environ)
  • Types d'action de texte autorisés : Republication, Appel, URL
• Cartes horizontales
  • Longueur maximale du titre : 2 lignes (80 caractères environ)
  • Longueur maximale de la description : 25 000 caractères
  • Longueur maximale de l'étiquette d'action de carte : 1 ligne (50 caractères environ)
  • Nombre maximal de cartes : 10
  • Nombre maximal d'actions de carte : 6. Si le nombre d'actions de carte dépasse 6, la carte est dupliquée pour afficher les actions restantes.
  • Nombre minimal d'actions de carte : 0
  • Nombre maximal d'actions de liste de cartes : 6
  • Au moins une description, image ou action requise? : Non
  • Types d'action de carte autorisés : Republication, Appel, URL
  • Types d'action de liste de cartes autorisés : Republication, Appel, URL
• Cartes verticales
  • Longueur maximale du titre : 2 lignes (80 caractères environ)
  • Longueur maximale de la description : 25 000 caractères
  • Longueur maximale de l'étiquette d'action de carte : 1 ligne (50 caractères environ)
  • Nombre maximal de cartes : 10
  • Nombre maximal d'actions de carte : 3.
  • Nombre minimal d'actions de carte : 0
  • Nombre maximal d'actions de liste de cartes : 6
  • Au moins une description, image ou action requise? : Non
  • Types d'action de carte autorisés : Republication, Appel, URL
  • Types d'action de liste de cartes autorisés : Republication, Appel, URL
• Messages avec fichier joint
  • Pris en charge? : Oui
  • Types d'action autorisés : Republication, Appel, URL
• Boutons d'action
  • Longueur maximale de l'étiquette d'action globale : 1 ligne (50 caractères environ)
  • Nombre maximal d'actions globales : 6
  • Types d'action globale autorisés : Republication, Appel, URL

Pour les canaux Cortana, vous pouvez étendre la fonctionnalité des composants de réponse commune en ajoutant des capacités propres à Cortana.

Vous accédez aux extensions en utilisant l'élément channelCustomProperties du composant et en définissant les propriétés appropriées. Le code a le format suivant :

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

Voici les propriétés personnalisées disponibles pour les canaux Cortana :

Pour plus d'informations sur l'utilisation de channelCustomProperties, voir Extensions propres au canal.