Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
# Utilizzo delle configurazioni di analisi delle chiamate per l'SDK Amazon Chime
Per elaborare l'audio utilizzando una configurazione di analisi delle chiamate, devi creare una pipeline di analisi delle chiamate, nota anche come pipeline di analisi delle chiamate. La pipeline viene creata durante una chiamata per gestire l'audio e viene terminata al termine della chiamata. Le pipeline di analisi delle chiamate richiedono l'ARN di una configurazione di analisi delle chiamate e informazioni sulla sorgente audio. La configurazione dell'analisi delle chiamate include dettagli sui processori audio, sulle destinazioni di analisi e sulle configurazioni degli eventi di avviso, *ma non sulla sorgente* audio. Ciò consente di riutilizzare la configurazione in diversi flussi di lavoro di analisi delle chiamate, ad esempio con diversi Voice Connectors o sorgenti KVS. La pipeline di analisi delle chiamate richiama i servizi di machine learning specificati nella configurazione e registra l'audio. È possibile interrompere manualmente o automaticamente la pipeline al termine della chiamata.
Puoi utilizzare le pipeline di analisi delle chiamate in un'ampia varietà di casi d'uso. I seguenti flussi di lavoro mostrano i modi potenziali per utilizzare una configurazione e una pipeline di analisi delle chiamate.
**Topics**
+ [Comprensione dei flussi di lavoro per la registrazione delle chiamate per l'SDK Amazon Chime](recording-workflows.md)
+ [Comprensione dei flussi di lavoro per l'analisi basata sull'apprendimento automatico per l'SDK Amazon Chime](ml-based-analytics.md)
# Comprensione dei flussi di lavoro per la registrazione delle chiamate per l'SDK Amazon Chime
Gli argomenti di questa sezione elencano e descrivono i flussi di lavoro per la registrazione delle chiamate e di Kinesis Video Streams.
# Registrazione delle chiamate Voice Connector
Utilizza questo flusso di lavoro quando:
+ Utilizzi già, o intendi utilizzare, un Voice Connector per integrare i contenuti multimediali SIP nell'analisi delle chiamate.
**Nota**
I connettori vocali supportano SIP e SIPREC. Per ulteriori informazioni, consulta [Managing Amazon Chime SDK Voice Connectors, nella *Amazon Chime* SDK](https://docs.aws.amazon.com/chime-sdk/latest/ag/voice-connectors.html) Administrator Guide.
+ Desideri registrare automaticamente le chiamate SIP o SIPREC a bassa latenza verso destinazioni Amazon Simple Storage Service di tua scelta.
+ Vuoi utilizzare la console Amazon Chime SDK per creare la configurazione e associarla a un Voice Connector.
+ Vuoi applicare la stessa configurazione di registrazione a ogni chiamata Voice Connector. Se desideri applicare più configurazioni a uno o più Voice Connectors, consulta la sezione successiva.
Per abilitare le chiamate a livello di codice, utilizza il seguente Amazon Chime SDK. APIs
+ Usa l'[https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipelineConfiguration.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipelineConfiguration.html)API per creare una configurazione di analisi delle chiamate
+ Usa [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_voice-chime_CreateVoiceConnector.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_voice-chime_CreateVoiceConnector.html)per creare un Voice Connector.
+ Utilizza l'[https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_PutVoiceConnectorStreamingConfiguration.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_PutVoiceConnectorStreamingConfiguration.html)API per associare la configurazione a un Voice Connector.
Per ulteriori informazioni, consulta [Configurazione dei connettori vocali per utilizzare l'analisi delle chiamate](https://docs.aws.amazon.com/chime-sdk/latest/ag/configure-voicecon.html) nella Guida per l'amministratore di *Amazon Chime SDK*.
Il diagramma seguente mostra il flusso di dati quando un Voice Connector avvia una sessione di registrazione delle chiamate. I numeri nel diagramma corrispondono al testo numerato riportato di seguito.
![\[Immagine che mostra il flusso di dati quando un Voice Connector inizia a registrare una chiamata.\]](http://docs.aws.amazon.com/it_it/chime-sdk/latest/dg/images/call-analytics-workflow-1.png)
Nel diagramma:
1. Utilizza la console Amazon Chime SDK o l'[https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipelineConfiguration.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipelineConfiguration.html)API per creare una configurazione di analisi delle chiamate. Durante il processo di creazione della configurazione, è sufficiente attivare la registrazione delle chiamate, scegliere il formato di file di registrazione desiderato e specificare la destinazione Amazon S3 per l'archiviazione dei file di registrazione. Per ulteriori informazioni, consulta [Creazione di configurazioni di analisi delle chiamate](https://docs.aws.amazon.com/chime-sdk/latest/ag/create-ca-config.html), nella *Amazon Chime SDK Administrator* Guide.
1. Utilizza la console Amazon Chime SDK o l'[https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_PutVoiceConnectorStreamingConfiguration.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_PutVoiceConnectorStreamingConfiguration.html)API per associare la configurazione a un Voice Connector. Per utilizzare la console, consulta [Configurazione dei connettori vocali per utilizzare l'](https://docs.aws.amazon.com/chime-sdk/latest/ag/configure-voicecon.html)analisi delle chiamate.
1. Durante una chiamata in uscita, il Voice Connector riceve l'audio di ogni partecipante alla chiamata.
1. Se una configurazione di registrazione analitica delle chiamate è collegata a Voice Connector, il servizio Voice Connector utilizza il servizio di pipeline multimediale per avviare una sessione di registrazione di analisi delle chiamate.
1. Il servizio di pipeline multimediale avvia il processore di registrazione delle chiamate che monitora la chiamata in corso.
1. Al termine della chiamata, il servizio di pipeline multimediale invia il file di registrazione della chiamata al bucket Amazon S3 designato e fornisce i metadati di registrazione tramite Amazon Kinesis Data Stream. Se è abilitato un data warehouse, i metadati della chiamata vanno anche al data warehouse di Amazon Simple Storage Service. Nei casi in cui SIPREC viene utilizzato per incorporare l'audio SIP nell'analisi delle chiamate, i metadati delle chiamate includono i metadati SIPREC in formato tabellare. Per ulteriori informazioni sulle tabelle di registrazione, fare riferimento a, più avanti in questa sezione. [Comprendere le tabelle del catalogo AWS Glue dati per l'SDK Amazon Chime](glue-tables.md)
1. Il servizio di pipeline multimediale invia gli eventi di stato della pipeline all'Amazon predefinito. EventBridge Per ulteriori informazioni, consulta la sezione [Utilizzo EventBridge delle notifiche](https://docs.aws.amazon.com/chime-sdk/latest/dg/ca-eventbridge-notifications.html) in questa guida.
**Nota**
Tieni presente che devi abilitare lo streaming di Voice Connector per abilitare la registrazione con un Voice Connector. Questa funzionalità consente lo streaming dei dati delle chiamate verso i Kinesis Video Streams gestiti da Voice Connector nel tuo account. Per ulteriori informazioni, consulta [Streaming dei contenuti multimediali di Amazon Chime SDK Voice Connector su Kinesis Video Streams nella Guida per](https://docs.aws.amazon.com/chime-sdk/latest/ag/start-kinesis-vc.html) l'amministratore di *Amazon* Chime SDK.
Puoi anche archiviare i dati delle chiamate creati da Voice Connector in Kinesis Video Streams per durate diverse, che vanno da ore a giorni o addirittura anni. La scelta di non conservare i dati limita l'usabilità dei dati della chiamata per il consumo immediato. Il costo di Kinesis Video Streams è determinato in base alla larghezza di banda e allo spazio di archiviazione totale utilizzati. Puoi modificare il periodo di conservazione dei dati in qualsiasi momento all'interno della configurazione di streaming di Voice Connector. Per abilitare la registrazione analitica delle chiamate, devi assicurarti che Kinesis Video Stream conservi i dati abbastanza a lungo da eseguire l'analisi delle chiamate. Lo fai specificando un periodo di conservazione dei dati adeguato.
Puoi associare una configurazione della pipeline di Call Insights a tutti i connettori vocali che desideri. Puoi anche creare una configurazione diversa per ogni Voice Connector. Voice Connectors utilizza il AWSService RoleForAmazonChimeVoiceConnector per chiamare l'[https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipeline.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipeline.html)API per tuo conto una volta per ID di transazione. *Per informazioni sul ruolo, consulta [Using the Amazon Chime SDK Service-Linked role for Amazon Chime SDK Voice Connectors nella Amazon Chime](https://docs.aws.amazon.com/chime-sdk/latest/ag/using-service-linked-roles-stream.html#service-linked-role-permissions-stream) SDK Administrator Guide.*
# Registrazione con produttori di streaming video Amazon Kinesis
Registri gli stream di Amazon Kinesis Video quando:
+ È necessario applicare configurazioni diverse a una chiamata anziché utilizzare la stessa configurazione per ogni chiamata Voice Connector.
+ Vuoi registrare audio SIP o non SIP che non venga elaborato da un Voice Connector.
Per utilizzare questa opzione di registrazione delle chiamate, è necessario pubblicare l'audio su Kinesis Video Streams (KVS) e quindi [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipeline.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipeline.html)chiamare l'API con le informazioni sul canale di streaming KVS e un ARN di configurazione per l'analisi delle chiamate.
**Nota**
L'analisi delle chiamate APIs supporta un massimo di due canali audio. Puoi anche abilitare lo streaming di Voice Connector, quindi utilizzare le informazioni KVS pubblicate nelle EventBridge notifiche di Voice Connector per avviare la registrazione di una chiamata.
Quando chiamate l'[https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipeline.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipeline.html)API, potete scegliere se specificare o meno i numeri di frammento per ogni definizione di canale di streaming KVS. Se fornisci un numero di frammento, Call Analytics inizierà a elaborare lo stream in quel frammento. Se non specifichi un ID di frammento, Call Analytics inizia a elaborare il flusso a partire dall'ultimo frammento disponibile.
Il diagramma seguente mostra il flusso di dati quando un Voice Connector avvia una sessione di registrazione delle chiamate. I numeri nel diagramma corrispondono al testo numerato riportato di seguito.
![\[Immagine che mostra il flusso di dati quando un Voice Connector inizia a registrare una chiamata.\]](http://docs.aws.amazon.com/it_it/chime-sdk/latest/dg/images/call-analytics-workflow-2.png)
Nel diagramma:
1. Puoi utilizzare la console Amazon Chime SDK o l'[https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipelineConfiguration.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipelineConfiguration.html)API per creare una configurazione di registrazione delle chiamate.
1. Usa l' AWS SDK per creare un'applicazione che trasferisca l'audio esterno in KVS o abilita lo streaming di Voice Connector per pubblicare automaticamente l'audio delle chiamate su un KVS. Per ulteriori informazioni, consulta [Streaming dei contenuti multimediali di Amazon Chime SDK Voice Connector su Kinesis Video Streams nella Guida per](https://docs.aws.amazon.com/chime-sdk/latest/ag/start-kinesis-vc.html) l'amministratore di *Amazon* Chime SDK.
1. Se lo streaming Voice Connector è abilitato, il servizio Voice Connector invia le notifiche ai valori predefiniti. EventBridge
1. Nel caso dello streaming di Voice Connector, l'applicazione può utilizzare gli `STARTED` eventi di streaming di Amazon Chime Voice Connector EventBridge per raccogliere informazioni sullo stream KVS sulle fasi di una chiamata.
1. Una volta che l'applicazione dispone delle informazioni audio provenienti dagli eventi di streaming di Voice Connector o da una fonte esterna, l'applicazione richiama l'API Amazon [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipeline.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipeline.html)Chime SDK.
1. Il servizio di pipeline multimediale avvia il processore di registrazione delle chiamate che monitora la chiamata in corso.
1. Il servizio di pipeline multimediale invia gli eventi di stato della pipeline all'Amazon predefinito. EventBridge Per ulteriori informazioni, consulta [Utilizzo EventBridge ](https://docs.aws.amazon.com/chime-sdk/latest/dg/ca-eventbridge-notifications.html) delle notifiche.
1. Una volta completata una chiamata, il servizio di pipeline multimediale consegnerà il file di registrazione della chiamata al bucket Amazon S3 designato e fornirà i metadati di registrazione tramite Amazon Kinesis Data Stream. Se è abilitato un data warehouse, i metadati delle chiamate verranno inviati anche al data warehouse Amazon S3. Nei casi in cui SIPREC viene utilizzato per incorporare l'audio SIP nell'analisi delle chiamate, i metadati delle chiamate includeranno i metadati SIPREC in un comodo formato di tabella. Per ulteriori informazioni sulle tabelle di registrazione, fare riferimento a, più avanti in questa sezione. [Comprendere le tabelle del catalogo AWS Glue dati per l'SDK Amazon Chime](glue-tables.md)
1. La tua applicazione può monitorare la pipeline e, nel caso di un Voice Connector, lo stato della chiamata utilizzando gli eventi pubblicati su Amazon EventBridge. Per ulteriori informazioni, consulta la sezione [Uso EventBridge delle notifiche](https://docs.aws.amazon.com/chime-sdk/latest/dg/ca-eventbridge-notifications.html) in questa guida.
1. Per terminare la registrazione, chiama l'[https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_DeleteMediaPipeline.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_DeleteMediaPipeline.html)API per terminare la registrazione della chiamata.
Per esempi e registrazioni basate su API, consulta il [sink di registrazione Amazon S3](https://docs.aws.amazon.com/chime-sdk/latest/dg/ca-processors-sinks.html#ca-s3-recording-sink) in questa guida.
# Utilizzo della CLI per avviare la registrazione
Gli esempi in questa sezione spiegano come eseguire le seguenti operazioni:
+ Utilizza la CLI per eseguire una configurazione di analisi delle chiamate e richiamare il. [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipeline.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipeline.html)
+ Utilizzate la CLI per specificare le destinazioni di registrazione, i formati dei file audio e i nomi dei file audio.
**Topics**
+ [Esecuzione di una configurazione e avvio di una pipeline](#cli-run-config)
+ [Impostazione di destinazioni, nomi e formati](#cli-set-buckets-formats)
## Esecuzione di una configurazione e avvio di una pipeline
Usa il comando seguente per eseguire una configurazione e avviare una pipeline di media insights. Il file pipeline.json contiene le impostazioni di configurazione.
```
aws chime-sdk-media-pipeline create-media-insights-pipeline --cli-input-json file://pipeline.json
```
L'esempio seguente mostra un file tipico. `pipeline.json`
```
{
"MediaInsightsPipelineConfigurationArn": arn:aws:chime:region;account_id:media-insights-pipeline-configuration/MyConfiguration,
"KinesisVideoStreamRecordingSourceRuntimeConfiguration": {
"Streams": [
{
"StreamArn": kinesis_video_stream_arn_1
},
{
"StreamArn": kinesis_video_stream_arn_2
}
],
"FragmentSelector": {
"FragmentSelectorType": "selector_type", // Specify "server_timestamp" or "producer_timestamp" as the fragment selector type
"TimestampRange": {
"StartTimestamp": epoch_time_seconds,
"EndTimestamp": epoch_time_seconds
}
}
},
"S3RecordingSinkRuntimeConfiguration": {
"Destination": arn:aws:s3:::bucket_name/prefix/optional_file_name,
"RecordingFileFormat": file_format // Specify "Opus" or "WAV" as the recording file format, if you want to override the configuration
}
}
```
`MediaInsightsPipelineConfigurationArn`È l'ARN di configurazione che ricevi dopo aver creato una configurazione di analisi delle chiamate.
## Impostazione di destinazioni, nomi e formati
L'esempio seguente utilizza una cartella denominata `MyRecordingBucket` come `S3SinkConfiguration.Destination` valore e `Opus` come `RecordingFileFormat` valore.
```
arn:aws:s3:::MyRecordingBucket/voice-connector-id/transaction-id_year-month-date-hour-minute-second-millisecond.ogg
```
L'esempio seguente utilizza `MyRecordingBucket` come `S3SinkConfiguration.Destination` valore e `Wav` come `RecordingFileFormat` valore.
```
arn:aws:s3:::MyRecordingBucket/voice-connector-id/transaction-id_year-month-date-hour-minute-second-millisecond.wav
```
# Comprensione dei flussi di lavoro per l'analisi basata sull'apprendimento automatico per l'SDK Amazon Chime
Le seguenti sezioni descrivono come utilizzare le funzionalità di analisi dell'apprendimento automatico fornite dall'analisi delle chiamate di Amazon Chime SDK.
**Nota**
Se prevedi di eseguire più analisi di apprendimento automatico sullo stesso Kinesis Video Stream, potrebbe essere necessario aumentare il limite del livello di connessione per e per `GetMedia` il flusso video. `GetMediaForFragmentList` Per ulteriori informazioni, consulta i limiti di [Kinesis Video Streams nella Kinesis Video](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/limits.html) *Streams Developer Guide*.
# Utilizzo di Voice Connectors per avviare automaticamente l'analisi delle chiamate
Utilizza questo flusso di lavoro quando:
+ Desideri una configurazione basata sulla console.
+ Utilizzi già o intendi utilizzare un Voice Connector per integrare i contenuti multimediali SIP nell'analisi delle chiamate. I connettori vocali supportano sia SIP che SIPREC. Per ulteriori informazioni sulla configurazione dei connettori vocali, consulta [Managing Amazon Chime SDK](https://docs.aws.amazon.com/chime-sdk/latest/ag/voice-connectors.html) Voice Connector.
+ Vuoi applicare la stessa configurazione di Media Insights a ogni chiamata Voice Connector.
+ È necessario utilizzare l'analisi vocale di Amazon Chime SDK, che richiede un Voice Connector o una pipeline di informazioni multimediali.
Per abilitare questo flusso di lavoro nella console Amazon Chime SDK, segui i passaggi per creare una configurazione di registrazione in [Configurazione dei connettori vocali per](https://docs.aws.amazon.com/chime-sdk/latest/ag/configure-voicecon.html) utilizzare l'analisi delle chiamate.
Per abilitare questo flusso di lavoro a livello di codice, utilizza quanto segue APIs: [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipelineConfiguration.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipelineConfiguration.html)API per creare una configurazione di analisi delle chiamate e quindi associa la configurazione a un Voice Connector utilizzando l'API. [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_PutVoiceConnectorStreamingConfiguration.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_PutVoiceConnectorStreamingConfiguration.html) Per ulteriori informazioni, consulta [Configurazione dei connettori vocali per utilizzare l'analisi vocale nella Guida](https://docs.aws.amazon.com/chime-sdk/latest/ag/configure-voicecon.html) per l'amministratore di *Amazon Chime SDK*.
Il diagramma seguente mostra il flusso di dati quando un Voice Connector avvia una sessione di analisi delle chiamate. I numeri nel diagramma corrispondono al testo numerato riportato di seguito.
![\[Image showing the flow of data when a Voice Connector initiates a call.\]](http://docs.aws.amazon.com/it_it/chime-sdk/latest/dg/images/call-analytics-workflow-1.png)
Nel diagramma:
1. Utilizza la console Amazon Chime SDK o l'[https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipelineConfiguration.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipelineConfiguration.html)API per creare una configurazione della pipeline di Media Insights.
1. Utilizza la console Amazon Chime SDK o l'[https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_PutVoiceConnectorStreamingConfiguration.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_PutVoiceConnectorStreamingConfiguration.html)API per associare la configurazione a un Voice Connector. Per associare una configurazione esistente a un connettore vocale, consulta la sezione [Configurazione dei connettori vocali per utilizzare l'analisi delle chiamate](https://docs.aws.amazon.com/chime-sdk/latest/ag/configure-voicecon.html), nella Guida per l'amministratore di *Amazon Chime SDK*.
1. Durante una chiamata in uscita, il Voice Connector riceve l'audio di ogni partecipante alla chiamata.
1. Grazie all'integrazione integrata con l'analisi delle chiamate, se una configurazione di analisi delle chiamate è collegata a un Voice Connector, il servizio Voice Connector avvia una sessione di analisi delle chiamate utilizzando il servizio di pipeline multimediale.
1. Il servizio di pipeline multimediale richiama uno o più processori multimediali come specificato nella configurazione.
1. Il servizio di pipeline multimediale invia i dati di output a una o più destinazioni in base alla configurazione. Ad esempio, puoi inviare analisi in tempo reale tramite un Amazon Kinesis Data Stream e, se configurato, puoi inviare i metadati e l'analisi delle chiamate a un data warehouse Amazon S3.
1. Il servizio di pipeline multimediale invia gli eventi di stato della pipeline all'Amazon predefinito. EventBridge Se hai configurato delle regole, le relative notifiche verranno inviate anche EventBridge ad Amazon. Per ulteriori informazioni, consulta [Utilizzo EventBridge delle notifiche](https://docs.aws.amazon.com/chime-sdk/latest/dg/ca-eventbridge-notifications.html).
**Nota**
Un processore di analisi vocale si avvia automaticamente solo quando si chiama la sala [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_StartSpeakerSearchTask.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_StartSpeakerSearchTask.html)operatoria [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_voice-chime_StartVoiceToneAnalysisTask.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_voice-chime_StartVoiceToneAnalysisTask.html) APIs.
È necessario abilitare lo streaming di Voice Connector per utilizzare l'analisi delle chiamate con Voice Connector. Questa funzionalità consente lo streaming dei dati delle chiamate su Kinesis Video Streams gestiti da Voice Connector nel tuo account. Per ulteriori informazioni, consulta la sezione [Streaming dei contenuti multimediali di Amazon Chime SDK Voice Connector su Kinesis Video Streams nella Guida per](https://docs.aws.amazon.com/chime-sdk/latest/ag/start-kinesis-vc.html) l'amministratore di *Amazon* Chime SDK.
È possibile archiviare i dati delle chiamate Voice Connector in Kinesis Video Streams per periodi di tempo diversi, che vanno da ore a anni. La scelta di non conservare i dati limita l'usabilità dei dati della chiamata per il consumo immediato. Il costo di Kinesis Video Streams è determinato in base alla larghezza di banda e allo spazio di archiviazione totale utilizzati. È possibile modificare il periodo di conservazione dei dati in qualsiasi momento modificando la configurazione di streaming del Voice Connector. Per abilitare la registrazione analitica delle chiamate, devi assicurarti che Kinesis Video Stream conservi i dati fino al termine dell'analisi delle chiamate. Lo fai specificando un periodo di conservazione dei dati adeguato.
Puoi associare una configurazione della pipeline di Media Insights a tutti i connettori vocali che desideri. Puoi anche creare una configurazione diversa per ogni Voice Connector. Voice Connectors utilizza il AWSService RoleForAmazonChimeVoiceConnector per chiamare l'[https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipeline.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipeline.html)API per tuo conto una volta per ID di transazione. *Per informazioni sul ruolo, consulta [Using the Amazon Chime SDK Service-Linked role for Amazon Chime SDK Voice Connectors nella Amazon Chime](https://docs.aws.amazon.com/chime-sdk/latest/ag/using-service-linked-roles-stream.html#service-linked-role-permissions-stream) SDK Administrator Guide.*
# Utilizzo APIs dell'analisi delle chiamate con Voice Connectors
Utilizza questo flusso di lavoro se utilizzi un Voice Connector ma devi controllare quando applicare una configurazione di analisi delle chiamate e a quale chiamata applicare la configurazione.
Per utilizzare questo metodo, è necessario creare un EventBridge target per gli eventi pubblicati da Voice Connector e quindi utilizzare gli eventi per attivare la pipeline APIs di analisi delle chiamate. Per ulteriori informazioni, consulta [Automating the Amazon Chime SDK EventBridge con la Amazon Chime SDK Administrator](https://docs.aws.amazon.com/chime-sdk/latest/ag/automating-chime-with-cloudwatch-events.html) *Guide*.
Il diagramma seguente mostra come implementare un controllo più granulare quando si utilizza l'analisi delle chiamate con Voice Connector. I numeri nel diagramma corrispondono ai numeri nel testo seguente.
![\[Immagine che mostra il flusso di dati quando si utilizzano chiamate API con connettori vocali.\]](http://docs.aws.amazon.com/it_it/chime-sdk/latest/dg/images/analytics-vc-with-apis.png)
Nel diagramma:
1. Utilizza la console Amazon Chime SDK o l'[https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipelineConfiguration.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipelineConfiguration.html)API per creare una configurazione della pipeline di Media Insights.
1. Durante una chiamata in uscita, Voice Connector riceverà l'audio dei partecipanti.
1. Il Voice Connector invia l'audio della chiamata a Kinesis Video Stream e gli eventi corrispondenti a. EventBridge Questi eventi hanno metadati di streaming e di chiamata.
1. La tua applicazione è sottoscritta EventBridge tramite un EventBridge Target.
1. L'applicazione richiama l'API Amazon [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipeline.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipeline.html)Chime SDK.
1. Il servizio Media Pipeline richiama uno o più processori multimediali in base agli elementi del processore presenti nella configurazione della pipeline Media Insights.
1. Il servizio media pipeline invia i dati di output a una o più destinazioni in base alla configurazione. L'analisi delle chiamate di Amazon Chime SDK fornirà analisi in tempo reale tramite Amazon Kinesis Data Stream e, se configurata, analisi dei metadati delle chiamate su un data warehouse Amazon S3.
1. Il servizio di pipeline multimediale invia gli eventi ad Amazon EventBridge. Se hai configurato delle regole, le relative notifiche verranno inviate anche EventBridge ad Amazon.
1. Puoi mettere in pausa o riprendere la sessione di analisi delle chiamate richiamando l'API. [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_UpdateMediaInsightsPipelineStatus.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_UpdateMediaInsightsPipelineStatus.html)
**Nota**
La registrazione delle chiamate non supporta la sospensione e la ripresa delle chiamate. Inoltre, le attività di analisi vocale avviate per la chiamata si interrompono anche quando si sospende una sessione. Per riavviarle, è necessario chiamare [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_StartSpeakerSearchTask.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_StartSpeakerSearchTask.html)o [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_StartVoiceToneAnalysisTask.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_StartVoiceToneAnalysisTask.html) APIs.
1. Se si seleziona l'analisi del tono vocale durante la configurazione, si avvia l'analisi vocale chiamando [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_StartSpeakerSearchTask.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_StartSpeakerSearchTask.html)o [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_StartVoiceToneAnalysisTask.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_StartVoiceToneAnalysisTask.html) APIs.
# Utilizzo dell'analisi delle chiamate con i produttori di Kinesis Video Streams
Per utilizzare questa opzione, è necessario pubblicare dati audio su Kinesis Video Streams (KVS) e quindi [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipeline.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipeline.html)chiamare l'API con le informazioni sul canale di streaming KVS.
**Nota**
L'analisi delle chiamate APIs supporta un massimo di due canali audio.
Quando si chiama l'[https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipeline.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipeline.html)API, è possibile specificare i numeri di frammento per ogni definizione di canale di streaming KVS. Se fornite un numero di frammento, Call Analytics inizia a elaborare lo stream in corrispondenza di quel frammento. In caso contrario, l'analisi delle chiamate inizia a elaborare il flusso dall'ultimo frammento disponibile.
L'analisi delle chiamate supporta l'audio PCM (solo formati audio Little-endian firmati a 16 bit, che non include WAV) con una frequenza di campionamento audio compresa tra 8 kHz e 48 kHz. L'audio di bassa qualità, come quello della telefonia, è in genere di circa 8.000 Hz. L'audio di alta qualità varia in genere da 16.000 Hz a 48.000 Hz. La frequenza di campionamento specificata deve corrispondere a quella dell'audio. Per ulteriori informazioni, consulta [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_KinesisVideoStreamSourceRuntimeConfiguration.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_KinesisVideoStreamSourceRuntimeConfiguration.html)*Amazon Chime SDK* API Reference.
L'SDK Kinesis Video Streams Producer fornisce un set di librerie che è possibile utilizzare per lo streaming di dati audio su un Kinesis Video Stream. Per ulteriori informazioni, consulta [Kinesis Video Streams Producer Libraries, nella Amazon Kinesis Video Streams](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/producer-sdk.html) *Developer* Guide.
Il diagramma seguente mostra il flusso di dati quando si utilizza l'analisi delle chiamate con un produttore Kinesis Video Stream personalizzato. I numeri nel diagramma corrispondono al testo numerato riportato di seguito.
![\[Immagine che mostra il flusso di dati quando si utilizza l'analisi delle chiamate con un produttore Kinesis Video Stream.\]](http://docs.aws.amazon.com/it_it/chime-sdk/latest/dg/images/analytics-kvs-with-apis.png)
1. Utilizzi la AWS console o l'[https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipelineConfiguration.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipelineConfiguration.html)API per creare una configurazione della pipeline di Media Insights.
1. Si utilizza un Kinesis Video Stream Producer per scrivere audio su Kinesis Video Streams.
1. L'applicazione richiama l'API. [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipeline.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipeline.html)
1. Il servizio di pipeline multimediale legge l'audio dai Kinesis Video Streams del cliente.
1. Il servizio di pipeline multimediale invia gli eventi ad Amazon EventBridge. Se hai configurato delle regole, le relative notifiche verranno inviate anche EventBridge ad Amazon.
1. Il servizio di pipeline multimediale richiama uno o più elementi del processore.
1. Il servizio di pipeline multimediale invia i dati di output a uno o più elementi sink.
1. Puoi mettere in pausa o riprendere la sessione di analisi delle chiamate richiamando l'API. [ UpdateMediaInsightsPipelineStatus](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_UpdateMediaInsightsPipelineStatus.html)
**Nota**
La registrazione delle chiamate non supporta la pausa e la ripresa.
1. La tua applicazione può elaborare gli EventBridge eventi Amazon per attivare flussi di lavoro aziendali personalizzati.
1. Se selezioni l'analisi vocale quando crei una configurazione, l'applicazione può avviare l'analisi vocale chiamando [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_StartSpeakerSearchTask.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_StartSpeakerSearchTask.html)o [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_StartVoiceToneAnalysisTask.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_StartVoiceToneAnalysisTask.html) APIs.