Si vous ne trouvez pas de réponses à vos questions dans ce document, consultez les autres options de support.
Général
Qu’est-ce qu’un Assistant vocal ?
Comme Cortana, un assistant vocal est une solution qui écoute les énoncés prononcés par un utilisateur, analyse le contenu de ces énoncés à la recherche de significations, effectue une ou plusieurs actions en réponse à l’intention de l’énoncé, puis fournit une réponse à l’utilisateur, comprenant souvent un composant parlé. Il s’agit d’une expérience de type « entrée et sortie de voix » permettant d’interagir avec un système. Les concepteurs d’assistants vocaux créent une application sur l’appareil à l’aide du DialogServiceConnector
dans le SDK Speech pour communiquer avec un assistant créé à l’aide de la solution Commandes personnalisées ou du canal Direct Line Speech du Bot Framework. Ces assistants peuvent utiliser des mots clés, une reconnaissance vocale et une voix personnalisés pour offrir une expérience adaptée à votre marque ou produit.
Dois-je utiliser la solution Commandes personnalisées ou Direct Line Speech ? Quelle est la différence ?
La solution Commandes personnalisées est un ensemble d’outils moins complexe permettant de créer et d’héberger facilement un assistant adapté aux scénarios d’achèvement des tâches. Direct Line Speech fournit des fonctionnalités plus riches et plus sophistiquées qui peuvent permettre des scénarios de conversation robustes. Pour plus d’informations, consultez la comparaison des solutions d’assistant.
Comment faire pour démarrer ?
La meilleure façon de commencer à créer une application de Commandes personnalisées (préversion) ou un bot Bot Framework de base.
Débogage
Où est le secret de mon canal ?
Si vous avez utilisé la préversion de Direct Line Speech ou que vous lisez la documentation associée, vous pouvez vous attendre à trouver une clé secrète sur la page d’inscription du canal Direct Line Speech. La méthode FromBotSecret
de la fabrique DialogServiceConfig
v1.7 du SDK Speech attend également cette valeur.
La dernière version de Direct Line Speech simplifie le processus de contact de votre bot à partir d’un appareil. Dans la page d’inscription du canal, la liste déroulante située en haut associe votre inscription du canal Direct Line Speech à une ressource de reconnaissance vocale. Une fois l’association effectuée, le SDK Speech v1.8 inclut une BotFrameworkConfig::FromSubscription
méthode de fabrique qui configure un DialogServiceConnector
pour contacter le bot que vous avez associé à votre abonnement.
Si vous migrez néanmoins votre application cliente de v1.7 vers v1.8, DialogServiceConfig::FromBotSecret
peut continuer à utiliser une valeur non vide et non null pour son paramètre de secret du canal, par exemple le secret précédent que vous avez utilisé. Elle sera ignorée lors de l’utilisation d’un abonnement de reconnaissance vocale associé à une inscription de canal plus récente. Notez que la valeur doit être non null et non vide, car elle est vérifiée sur l’appareil avant que l’association côté service soit pertinente.
Pour obtenir un guide plus détaillé, consultez la section du tutoriel qui vous guide dans l’inscription du canal.
J’obtiens une erreur 401 lors de la connexion et rien ne fonctionne. Je sais que ma clé de ressource Speech est valide. Que se passe-t-il ?
Lors de la gestion de votre ressource Speech sur le Portail Azure, vérifiez que vous utilisez la ressource Speech (Microsoft.CognitiveServicesSpeechServices, « Speech ») et pas la ressource Azure AI services (Microsoft.CognitiveServicesAllInOne, « Tous les Azure AI services »). Vérifiez également la prise en charge de la région du service de reconnaissance vocale pour les assistants vocaux.
J’obtiens le texte de la reconnaissance à partir de mon « DialogServiceConnector », mais je vois une erreur « 1011 » et rien de mon bot. Pourquoi ?
Cette erreur indique un problème de communication entre votre assistant et le service d’assistant vocal.
- Pour la solution Commandes personnalisées, assurez-vous que votre application Commandes personnalisées est publiée
- Pour Direct Line Speech, vérifiez que vous avez connecté votre bot au canal Direct Line Speech, ajouté la prise en charge du protocole de streaming à votre bot (avec la prise en charge WebSocket connexe), puis vérifiez que votre bot répond aux demandes entrantes provenant du canal.
Ce code ne fonctionne toujours pas et/ou j’obtiens une erreur différente lorsque j’utilise un « DialogServiceConnector ». Que dois-je faire ?
La journalisation basée sur fichier fournit beaucoup plus de détails et peut accélérer le traitement des demandes de support. Pour activer cette fonctionnalité, consultez comment utiliser la journalisation basée sur fichier.