Comprendre les flux de travail pour les analyses basées sur l'apprentissage automatique pour le SDK Amazon Chime

Utilisez ce flux de travail lorsque :

Pour activer ce flux de travail dans la console Amazon Chime SDK, suivez les étapes de création d'une configuration d'enregistrement dans Configuration des connecteurs vocaux pour utiliser l'analyse des appels.

Pour activer ce flux de travail par programmation, utilisez ce qui suit : APIs CreateMediaInsightsPipelineConfigurationAPI pour créer une configuration d'analyse des appels, puis associer la configuration à un connecteur vocal à l'aide du PutVoiceConnectorStreamingConfigurationAPI. Pour plus d'informations, consultez la section Configuration des connecteurs vocaux pour utiliser l'analyse vocale dans le guide de l'administrateur du SDK Amazon Chime.

Le schéma suivant montre le flux de données lorsqu'un connecteur vocal lance une session d'analyse des appels. Les chiffres du schéma correspondent au texte numéroté ci-dessous.

Dans le schéma :

Vous pouvez stocker les données d'appel du Voice Connector dans Kinesis Video Streams pendant des durées variables, allant de quelques heures à plusieurs années. Le fait de ne pas conserver de données limite l'utilisabilité des données d'appel pour une consommation immédiate. Le coût de Kinesis Video Streams est déterminé en fonction de la bande passante et du stockage total utilisés. Il est possible d'ajuster la durée de conservation des données à tout moment en modifiant la configuration de diffusion de votre Voice Connector. Pour activer l'enregistrement des analyses d'appels, vous devez vous assurer que le flux vidéo Kinesis conserve les données jusqu'à la fin de l'analyse des appels. Pour ce faire, vous devez définir une période de conservation des données appropriée.

Vous pouvez associer une configuration de pipeline Media Insights à autant de connecteurs vocaux que vous le souhaitez. Vous pouvez également créer une configuration différente pour chaque connecteur vocal. Les connecteurs vocaux utilisent le AWSService RoleForAmazonChimeVoiceConnector pour appeler CreateMediaInsightsPipelineAPI en votre nom une fois par numéro de transaction. Pour plus d'informations sur ce rôle, consultez la section Utilisation du rôle lié au service Amazon Chime SDK pour les connecteurs vocaux du SDK Amazon Chime dans le guide de l'administrateur du SDK Amazon Chime.

Utilisez ce flux de travail si vous utilisez un connecteur vocal mais que vous devez contrôler à quel moment appliquer une configuration d'analyse des appels et à quel appel appliquer la configuration.

Pour utiliser cette méthode, vous devez créer une EventBridge cible pour les événements publiés par le connecteur vocal, puis utiliser ces événements pour déclencher le pipeline d'analyse des appels APIs. Pour plus d'informations, consultez Automatiser le SDK Amazon Chime dans le Guide de l' EventBridgeadministrateur du SDK Amazon Chime.

Le schéma suivant montre comment implémenter un contrôle plus granulaire lors de l'utilisation de l'analyse des appels avec Voice Connector. Les chiffres du diagramme correspondent aux chiffres du texte ci-dessous.

Dans le schéma :

Utilisation de l'analyse des appels APIs avec les connecteurs vocaux

Utilisez ce flux de travail si vous utilisez un connecteur vocal mais que vous devez contrôler à quel moment appliquer une configuration d'analyse des appels et à quel appel appliquer la configuration.

Pour utiliser cette méthode, vous devez créer une EventBridge cible pour les événements publiés par le connecteur vocal, puis utiliser ces événements pour déclencher le pipeline d'analyse des appels APIs. Pour plus d'informations, consultez Automatiser le SDK Amazon Chime dans le Guide de l' EventBridgeadministrateur du SDK Amazon Chime.

Le schéma suivant montre comment implémenter un contrôle plus granulaire lors de l'utilisation de l'analyse des appels avec Voice Connector. Les chiffres du diagramme correspondent aux chiffres du texte ci-dessous.

Dans le schéma :

1. Vous utilisez la console Amazon Chime SDK ou CreateMediaInsightsPipelineConfigurationAPI pour créer une configuration de pipeline Media Insights.

2. Pendant un appel sortant, le connecteur vocal reçoit le son du participant.

3. Le connecteur vocal envoie le son des appels à Kinesis Video Stream et les événements correspondants au. EventBridge Ces événements ont des métadonnées de flux et d'appel.

4. Votre application est souscrite EventBridge via un EventBridge Target.

5. Votre application invoque le SDK Amazon Chime CreateMediaInsightsPipelineAPI.

6. Le service de pipeline multimédia invoque un ou plusieurs processeurs multimédias en fonction des éléments du processeur dans la configuration du pipeline d'informations multimédias.

7. Le service de pipeline multimédia envoie les données de sortie vers une ou plusieurs destinations en fonction de la configuration. L'analyse des appels du SDK Amazon Chime fournira des analyses en temps réel via Amazon Kinesis Data Stream et, si elle est configurée, des analyses des métadonnées des appels vers un entrepôt de données Amazon S3.

8. Le service Media Pipeline envoie les événements à Amazon EventBridge. Si vous avez configuré des règles, les notifications correspondantes seront également envoyées EventBridge à Amazon.

9. Vous pouvez suspendre ou reprendre la session d'analyse des appels en invoquant le UpdateMediaInsightsPipelineStatusAPI.

   Note

   L'enregistrement des appels ne prend pas en charge la mise en pause et la reprise des appels. De plus, les tâches d'analyse vocale lancées pour l'appel s'arrêtent également lorsque vous interrompez une session. Pour les redémarrer, vous devez appeler StartSpeakerSearchTask ou StartVoiceToneAnalyisTask APIs.

10. Si vous sélectionnez l'analyse des tonalités vocales lors de la configuration, vous pouvez démarrer l'analyse vocale en appelant StartSpeakerSearchTask ou StartVoiceToneAnalyisTask APIs.

Pour utiliser cette option, vous devez publier des données audio sur Kinesis Video Streams (KVS), puis appeler CreateMediaInsightsPipelineAPI avec informations sur les canaux de flux KVS.

Lorsque vous appelez le CreateMediaInsightsPipelineAPI, vous pouvez spécifier des numéros de fragment pour chaque définition de canal de flux KVS. Si vous fournissez un numéro de fragment, Call Analytics commence à traiter le flux au niveau de ce fragment. Sinon, Call Analytics commence à traiter le flux à partir du dernier fragment disponible.

L'analyse des appels prend en charge le son PCM (uniquement les formats audio Little-Endian 16 bits signés, qui n'incluent pas le WAV) avec une fréquence d'échantillonnage audio comprise entre 8 kHz et 48 kHz. Le son de faible qualité, tel que le son de téléphonie, se situe généralement autour de 8 000 Hz. Le son de haute qualité est généralement compris entre 16 000 Hz et 48 000 Hz. La fréquence d'échantillonnage que vous spécifiez doit correspondre à celle de votre audio. Pour plus d’informations, consultez .KinesisVideoStreamSourceRuntimeConfigurationdans la référence d'API du SDK Amazon Chime.

Le SDK Kinesis Video Streams Producer fournit un ensemble de bibliothèques que vous pouvez utiliser pour diffuser des données audio vers un Kinesis Video Stream. Pour plus d'informations, consultez les bibliothèques Kinesis Video Streams Producer dans le guide du développeur Amazon Kinesis Video Streams.

Le schéma suivant montre le flux de données lors de l'utilisation de l'analyse des appels avec un producteur Kinesis Video Stream personnalisé. Les chiffres du schéma correspondent au texte numéroté ci-dessous.

Utilisation de l'analyse des appels avec les producteurs de Kinesis Video Streams

Pour utiliser cette option, vous devez publier des données audio sur Kinesis Video Streams (KVS), puis appeler CreateMediaInsightsPipelineAPI avec informations sur les canaux de flux KVS.

Note

L'analyse des appels APIs prend en charge un maximum de deux canaux audio.

Lorsque vous appelez le CreateMediaInsightsPipelineAPI, vous pouvez spécifier des numéros de fragment pour chaque définition de canal de flux KVS. Si vous fournissez un numéro de fragment, Call Analytics commence à traiter le flux au niveau de ce fragment. Sinon, Call Analytics commence à traiter le flux à partir du dernier fragment disponible.

L'analyse des appels prend en charge le son PCM (uniquement les formats audio Little-Endian 16 bits signés, qui n'incluent pas le WAV) avec une fréquence d'échantillonnage audio comprise entre 8 kHz et 48 kHz. Le son de faible qualité, tel que le son de téléphonie, se situe généralement autour de 8 000 Hz. Le son de haute qualité est généralement compris entre 16 000 Hz et 48 000 Hz. La fréquence d'échantillonnage que vous spécifiez doit correspondre à celle de votre audio. Pour plus d’informations, consultez .KinesisVideoStreamSourceRuntimeConfigurationdans la référence d'API du SDK Amazon Chime.

Le SDK Kinesis Video Streams Producer fournit un ensemble de bibliothèques que vous pouvez utiliser pour diffuser des données audio vers un Kinesis Video Stream. Pour plus d'informations, consultez les bibliothèques Kinesis Video Streams Producer dans le guide du développeur Amazon Kinesis Video Streams.

Le schéma suivant montre le flux de données lors de l'utilisation de l'analyse des appels avec un producteur Kinesis Video Stream personnalisé. Les chiffres du schéma correspondent au texte numéroté ci-dessous.

1. Vous utilisez la AWS console ou CreateMediaInsightsPipelineConfigurationAPI pour créer une configuration de pipeline Media Insights.

2. Vous utilisez un Kinesis Video Stream Producer pour écrire du son dans Kinesis Video Streams.

3. Votre application invoque le CreateMediaInsightsPipelineAPI.

4. Le service Media Pipeline lit le son des Kinesis Video Streams du client.

5. Le service Media Pipeline envoie les événements à Amazon EventBridge. Si vous avez configuré des règles, les notifications correspondantes seront également envoyées EventBridge à Amazon.

6. Le service de pipeline multimédia invoque un ou plusieurs éléments du processeur.

7. Le service Media Pipeline envoie des données de sortie à un ou plusieurs éléments récepteurs.

8. Vous pouvez suspendre ou reprendre la session d'analyse des appels en appelant l' UpdateMediaInsightsPipelineStatusAPI.

   Note

   L'enregistrement des appels ne prend pas en charge la pause et la reprise.

9. Votre application peut traiter les EventBridge événements Amazon pour déclencher des flux de travail commerciaux personnalisés.

10. Si vous sélectionnez l'analyse vocale lors de la création d'une configuration, votre application peut démarrer l'analyse vocale en appelant le StartSpeakerSearchTask ou StartVoiceToneAnalyisTask APIs.