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à.
# Creazione di categorie per trascrizioni in tempo reale
Real-time Call Analytics supporta la creazione di categorie personalizzate, che puoi utilizzare per personalizzare le analisi delle trascrizioni in modo da soddisfare al meglio le tue esigenze aziendali specifiche.
Puoi creare tutte le categorie che desideri per coprire una serie di scenari diversi. Per ogni categoria creata, devi creare da 1 a 20 regole. Real-time Le trascrizioni di Call Analytics supportano solo le regole che utilizzano [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_TranscriptFilter.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_TranscriptFilter.html)(corrispondenze di parole chiave). Per maggiori dettagli sull'utilizzo delle regole con l'operazione [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_CreateCallAnalyticsCategory.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_CreateCallAnalyticsCategory.html), consulta la sezione [Criteri delle regole per le categorie di analisi delle chiamate in tempo reale](#tca-rules-stream).
Se il contenuto dei tuoi file multimediali corrisponde a tutte le regole che hai specificato in una determinata categoria, Amazon Transcribe etichetta il tuo output con quella categoria. Vedi l’[output degli eventi di categoria](tca-output-streaming.md#tca-output-category-event-stream) per un esempio di corrispondenza di categoria nel formato di output JSON.
Ecco alcuni esempi di cosa puoi fare con le categorie personalizzate:
+ Identifica i problemi che richiedono un'attenzione immediata segnalando e monitorando set specifici di parole chiave
+ Monitora la conformità, ad esempio quando un agente pronuncia (o omette) una frase specifica
+ Contrassegna parole e frasi specifiche in tempo reale; puoi quindi impostare la corrispondenza tra le categorie per impostare un avviso immediato. Ad esempio, se crei una categoria di analisi delle chiamate in tempo reale per un cliente che dice “*parlare con un responsabile*”, puoi impostare un [avviso di evento](tca-start-stream.md#tca-create-alert-stream) per questa corrispondenza di categoria in tempo reale che informi il responsabile in servizio.
**Post-call rispetto alle categorie in tempo reale**
Quando si crea una nuova categoria, è possibile specificare se si desidera che venga creata come categoria post-chiamata (`POST_CALL`) o come categoria in tempo reale (`REAL_TIME`). Se non specifichi un'opzione, per impostazione predefinita la categoria viene creata come categoria post-chiamata. Real-time le corrispondenze di categoria possono essere utilizzate per creare avvisi in tempo reale. Per ulteriori informazioni, consulta [Creazione di avvisi in tempo reale per le corrispondenze di categoria](tca-start-stream.md#tca-create-alert-stream).
Per creare una nuova categoria per l'analisi delle chiamate in tempo reale, puoi utilizzare la **Console di gestione AWS**, l’AWS CLI****, o gli **SDK AWS **; vedi quanto segue per alcuni esempi:
## Console di gestione AWS
1. Nel riquadro di navigazione, sotto Amazon Transcribe, scegli **Amazon Transcribe Call Analytics**.
1. Scegli le **categorie di analisi delle chiamate**, che ti reindirizzerà alla pagina delle **categorie di analisi delle chiamate**. Seleziona il pulsante **Crea categoria**.
1. Ora ti trovi nella **pagina Crea categoria**. Inserisci un nome per la tua categoria, quindi scegli “Analisi delle chiamate in tempo reale” nel menu a discesa **tipo di categoria**.
1. Puoi scegliere un modello per creare la tua categoria o crearne uno da zero.
Se usi un modello: seleziona **Usa un modello (consigliato)**, scegli il modello che desideri, quindi seleziona **Crea categoria**.
1. Se stai creando una categoria personalizzata: seleziona **Crea da zero**.
1. Aggiungi regole alla tua categoria utilizzando il menu a discesa. Puoi aggiungere fino a 20 regole per categoria. Con le trascrizioni di analisi delle chiamate in tempo reale, puoi includere solo regole che prevedono la corrispondenza dei contenuti delle trascrizioni. Tutte le corrispondenze vengono segnalate in tempo reale.
1. Ecco un esempio di una categoria con una sola regola: un cliente che dice parlare con un responsabile” in qualsiasi momento della chiamata.
1. Quando hai finito di aggiungere regole alla tua categoria, scegli **Crea categoria**.
## AWS CLI
Questo esempio utilizza il comando [crea categoria analisi chiamata](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/transcribe/create-call-analytics-category.html). Per ulteriori informazioni, consultare [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_CreateCallAnalyticsCategory.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_CreateCallAnalyticsCategory.html), [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_CategoryProperties.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_CategoryProperties.html) e [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_Rule.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_Rule.html).
Nell'esempio seguente viene creata una categoria con la regola:
+ Il cliente ha pronunciato la frase “parlare con il responsabile” in qualsiasi momento della chiamata.
Questo esempio utilizza il comando [crea categoria analisi chiamate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/transcribe/create-call-analytics-category.html) e un corpo della richiesta che aggiunge una regola alla categoria.
```
aws transcribe create-call-analytics-category \
--cli-input-json file://{{filepath}}/{{my-first-analytics-category}}.json
```
Il file *my-first-analytics-category.json* contiene il seguente corpo della richiesta.
```
{
"CategoryName": "{{my-new-real-time-category}}",
"InputType": "{{REAL_TIME}}",
"Rules": [
{
"TranscriptFilter": {
"Negate": {{false}},
"Targets": [
"{{speak to the manager}}"
],
"TranscriptFilterType": "{{EXACT}}"
}
}
]
}
```
## AWS SDK per Python (Boto3)
Questo esempio utilizza AWS SDK per Python (Boto3) per creare una categoria utilizzando gli `Rules` argomenti `CategoryName` and per il metodo [create\_call\_analytics\_category](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/transcribe.html#TranscribeService.Client.create_call_analytics_category). Per ulteriori informazioni, consultare [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_CreateCallAnalyticsCategory.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_CreateCallAnalyticsCategory.html), [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_CategoryProperties.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_CategoryProperties.html) e [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_Rule.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_Rule.html).
Per ulteriori esempi di utilizzo degli AWS SDK, inclusi esempi relativi a funzionalità specifiche, scenari e interservizi, consulta il capitolo. [Esempi di codice per l'utilizzo di Amazon Transcribe AWS SDK](service_code_examples.md)
Nell'esempio seguente viene creata una categoria con la regola:
+ Il cliente ha pronunciato la frase “parlare con il responsabile” in qualsiasi momento della chiamata.
```
from __future__ import print_function
import time
import boto3
transcribe = boto3.client('transcribe', '{{us-west-2}}')
category_name = "{{my-new-real-time-category}}"
transcribe.create_call_analytics_category(
CategoryName = category_name,
InputType = "{{REAL_TIME}}",
Rules = [
{
'TranscriptFilter': {
'Negate': {{False}},
'Targets': [
'{{speak to the manager}}'
],
'TranscriptFilterType': '{{EXACT}}'
}
}
]
)
result = transcribe.get_call_analytics_category(CategoryName = category_name)
print(result)
```
## Criteri delle regole per le categorie di analisi delle chiamate in tempo reale
Questa sezione descrive i tipi di regole `REAL_TIME` personalizzate che è possibile creare utilizzando l'operazione API [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_CreateCallAnalyticsCategory.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_CreateCallAnalyticsCategory.html).
Il rilevamento dei problemi avviene automaticamente, quindi non devi creare regole o categorie per segnalare i problemi.
Tieni presente che per le trascrizioni di analisi delle chiamate in tempo reale sono supportate solo le corrispondenze di parole chiave. Se desideri creare categorie che includano interruzioni, silenzio o sentiment, consulta [Criteri di regole per le categorie di analisi post-chiamata](tca-categories-batch.md#tca-rules-batch).
### Corrispondenza di parola chiave
Le regole che utilizzano le parole chiave (tipo di dati [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_TranscriptFilter.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_TranscriptFilter.html)) sono progettate per far corrispondere:
+ Parole o frasi personalizzate pronunciate dall'agente, dal cliente o da entrambi
+ Parole o frasi personalizzate **non** pronunciate dall'agente, dal cliente o da entrambi
+ Parole o frasi personalizzate che ricorrono in un periodo di tempo specifico
Ecco un esempio dei parametri disponibili con il [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_TranscriptFilter.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_TranscriptFilter.html):
```
"TranscriptFilter": {
"AbsoluteTimeRange": {
{{Specify the time frame, in milliseconds, when the match should occur}}
},
"RelativeTimeRange": {
{{Specify the time frame, in percentage, when the match should occur}}
},
"Negate": {{Specify if you want to match the presence or absence of your custom keywords}},
"ParticipantRole": {{Specify if you want to match speech from the agent, the customer, or both}},
"Targets": [ {{The custom words and phrases you want to match}} ],
"TranscriptFilterType": {{Use this parameter to specify an exact match for the specified targets}}
}
```
Fate riferimento a [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_CreateCallAnalyticsCategory.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_CreateCallAnalyticsCategory.html) e [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_TranscriptFilter.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_TranscriptFilter.html) per ulteriori informazioni su questi parametri e sui valori validi associati a ciascuno di essi.