StartCallAnalyticsJob

Trascrive l'audio di una chiamata al servizio clienti e applica eventuali parametri di richiesta aggiuntivi che scegli di includere nella richiesta.

Oltre a molte funzioni di trascrizione standard, Call Analytics fornisce le caratteristiche delle chiamate, il riepilogo delle chiamate, il sentimento del relatore e la redazione opzionale della trascrizione del testo e del file audio. Puoi anche applicare categorie personalizzate per contrassegnare condizioni specifiche. Per ulteriori informazioni su queste funzionalità e approfondimenti, consulta Analisi dell'audio dei call center con Call Analytics.

Se desideri applicare delle categorie al tuo lavoro di Call Analytics, devi crearle prima di inviare la richiesta di lavoro. Le categorie non possono essere applicate retroattivamente a un lavoro. Per creare una nuova categoria, utilizzare l'CreateCallAnalyticsCategoryoperazione. Per ulteriori informazioni sulle categorie di Call Analytics, vedi Creazione di categorie per le trascrizioni post-chiamata e Creazione di categorie per le trascrizioni in tempo reale.

Per effettuare unaStartCallAnalyticsJob richiesta, devi prima caricare il tuo file multimediale in un bucket Amazon S3; puoi quindi specificare la posizione Amazon S3 del file utilizzando ilMedia parametro.

È necessario includere i seguenti parametri nellaStartCallAnalyticsJob richiesta:

• region: IlRegione AWS luogo in cui stai facendo la tua richiesta. Per un elenco dei dispositiviRegioni AWS supportati con Amazon Transcribe, consulta gli endpoint e le quote di Amazon Transcribe.

• CallAnalyticsJobName: un nome personalizzato che crei per il tuo lavoro di trascrizione e che sia unico nel tuoAccount AWS.

• DataAccessRoleArn: Il nome della risorsa Amazon Resource Name (ARN) di un ruolo IAM con le autorizzazioni per accedere al bucket Amazon S3 che contiene i file di input.

• Media(MediaFileUrioRedactedMediaFileUri): la posizione Amazon S3 del tuo file multimediale.

Nota

Con Call Analytics, puoi oscurare l'audio contenuto nel tuo file multimediale includendoRedactedMediaFileUri, invece di specificareMediaFileUri, la posizione dell'audio in ingresso. Se scegli di oscurare l'audio, puoi trovare i file multimediali censurati nella posizione specificata nelRedactedMediaFileUri campo della risposta.

Sintassi della richiesta

{
   "CallAnalyticsJobName": "string",
   "ChannelDefinitions": [ 
      { 
         "ChannelId": number,
         "ParticipantRole": "string"
      }
   ],
   "DataAccessRoleArn": "string",
   "Media": { 
      "MediaFileUri": "string",
      "RedactedMediaFileUri": "string"
   },
   "OutputEncryptionKMSKeyId": "string",
   "OutputLocation": "string",
   "Settings": { 
      "ContentRedaction": { 
         "PiiEntityTypes": [ "string" ],
         "RedactionOutput": "string",
         "RedactionType": "string"
      },
      "LanguageIdSettings": { 
         "string" : { 
            "LanguageModelName": "string",
            "VocabularyFilterName": "string",
            "VocabularyName": "string"
         }
      },
      "LanguageModelName": "string",
      "LanguageOptions": [ "string" ],
      "VocabularyFilterMethod": "string",
      "VocabularyFilterName": "string",
      "VocabularyName": "string"
   }
}

Parametri della richiesta

Per informazioni sui parametri comuni a tutte le azioni, vedere Parametri comuni.

La richiesta accetta i seguenti dati in formato JSON.

CallAnalyticsJobName

Un nome univoco, scelto da te, per il tuo lavoro di analisi delle chiamate.

Questo nome fa distinzione tra maiuscole e minuscole, non può contenere spazi e deve essere univoco all'interno di unAccount AWS. Se si tenta di creare un nuovo lavoro con lo stesso nome di un lavoro esistente, viene visualizzato unConflictException errore.

Tipo: String

Limitazioni di lunghezza: lunghezza minima di 1. Lunghezza massima di 200.

Pattern: ^[0-9a-zA-Z._-]+

Campo obbligatorio: sì

ChannelDefinitions

Consente di specificare quale altoparlante si trova su quale canale. Ad esempio, se il tuo agente è il primo partecipante a parlare, dovresti impostare su0 (ChannelIdper indicare il primo canale) eParticipantRole suAGENT (per indicare che è l'agente che parla).

Tipo: matrice di oggetti ChannelDefinition

Membri dell'array: numero minimo di 2 elementi.

Required: No

DataAccessRoleArn

Il nome della risorsa Amazon Resource Name (ARN) di un ruolo IAM con le autorizzazioni per accedere al bucket Amazon S3 che contiene i file di input. Se il ruolo specificato non dispone delle autorizzazioni appropriate per accedere alla posizione Amazon S3 specificata, la richiesta ha esito negativo.

Gli ARN del ruolo IAM hanno il formatoarn:partition:iam::account:role/role-name-with-path. Ad esempio: arn:aws:iam::111122223333:role/Admin.

Per ulteriori informazioni, consulta ARN IAM.

Tipo: String

Limitazioni di lunghezza: lunghezza minima di 20. La lunghezza massima è 2048 caratteri.

Modello: ^arn:(aws|aws-cn|aws-us-gov|aws-iso-{0,1}[a-z]{0,1}):iam::[0-9]{0,63}:role/[A-Za-z0-9:_/+=,@.-]{0,1024}$

Required: No

Media

Descrive la posizione Amazon S3 del file multimediale che desideri utilizzare nella tua richiesta di analisi delle chiamate.

Tipo: Media oggetto

Campo obbligatorio: sì

OutputEncryptionKMSKeyId

La chiave KMS che desideri utilizzare per crittografare l'output di Call Analytics.

Se usi una chiave che si trova nella correnteAccount AWS, puoi specificare la tua chiave KMS in quattro modi:

1. Usa l'ID della chiave KMS stesso. Ad esempio, 1234abcd-12ab-34cd-56ef-1234567890ab.

2. Usa un alias per l'ID della chiave KMS. Ad esempio, alias/ExampleAlias.

3. Usa il nome della risorsa Amazon Resource Name (ARN) per l'ID della chiave KMS. Ad esempio, arn:aws:kms:region:account-ID:key/1234abcd-12ab-34cd-56ef-1234567890ab.

4. Usa l'ARN per l'alias della chiave KMS. Ad esempio, arn:aws:kms:region:account-ID:alias/ExampleAlias.

Se usi una chiave che si trova in una posizione Account AWSdiversa da quella attualeAccount AWS, puoi specificare la tua chiave KMS in due modi:

1. Usa l'ARN per l'ID della chiave KMS. Ad esempio, arn:aws:kms:region:account-ID:key/1234abcd-12ab-34cd-56ef-1234567890ab.

2. Usa l'ARN per l'alias della chiave KMS. Ad esempio, arn:aws:kms:region:account-ID:alias/ExampleAlias.

Se non si specifica una chiave di crittografia, l'output viene crittografato con la chiave Amazon S3 (SSE-S3).

Se si specifica una chiave KMS per crittografare l'output, è necessario specificare anche una posizione di output utilizzando ilOutputLocation parametro.

Si noti che il ruolo che effettua laStartCallAnalyticsJob richiesta deve disporre dell'autorizzazione per utilizzare la chiave KMS specificata.

Tipo: String

Limitazioni di lunghezza: lunghezza minima di 1. La lunghezza massima è 2048 caratteri.

Modello: ^[A-Za-z0-9][A-Za-z0-9:_/+=,@.-]{0,2048}$

Required: No

OutputLocation

La posizione di Amazon S3 in cui si desidera memorizzare l'output della trascrizione di Call Analytics. È possibile utilizzare uno dei seguenti formati per specificare la posizione di output:

1. s3://DOC-EXAMPLE-BUCKET

2. s3://DOC-EXAMPLE-BUCKET/my-output-folder/

3. s3://DOC-EXAMPLE-BUCKET/my-output-folder/my-call-analytics-job.json

A meno che non si specifichi un nome di file (opzione 3), il nome del file di output ha un valore predefinito che corrisponde al nome specificato per il processo di trascrizione utilizzando ilCallAnalyticsJobName parametro.

È possibile specificare una chiave KMS per crittografare l'output utilizzando ilOutputEncryptionKMSKeyId parametro. Se non si specifica una chiave KMS, Amazon Transcribe utilizza la chiave Amazon S3 per la crittografia lato server.

Se non lo specifichiOutputLocation, la trascrizione viene inserita in un bucket Amazon S3 gestito dal servizio e ti viene fornito un URI per accedere alla trascrizione.

Tipo: String

Limitazioni di lunghezza: lunghezza minima di 1. Lunghezza massima di 2000.

Modello: (s3://|http(s*)://).+

Required: No

Settings

Specifica impostazioni opzionali aggiuntive nella tuaStartCallAnalyticsJob richiesta, inclusa la redazione dei contenuti; ti consente di applicare modelli linguistici personalizzati, filtri di vocabolario e vocabolari personalizzati al tuo lavoro di analisi delle chiamate.

Tipo: CallAnalyticsJobSettings oggetto

Required: No

Sintassi della risposta

{
   "CallAnalyticsJob": { 
      "CallAnalyticsJobName": "string",
      "CallAnalyticsJobStatus": "string",
      "ChannelDefinitions": [ 
         { 
            "ChannelId": number,
            "ParticipantRole": "string"
         }
      ],
      "CompletionTime": number,
      "CreationTime": number,
      "DataAccessRoleArn": "string",
      "FailureReason": "string",
      "IdentifiedLanguageScore": number,
      "LanguageCode": "string",
      "Media": { 
         "MediaFileUri": "string",
         "RedactedMediaFileUri": "string"
      },
      "MediaFormat": "string",
      "MediaSampleRateHertz": number,
      "Settings": { 
         "ContentRedaction": { 
            "PiiEntityTypes": [ "string" ],
            "RedactionOutput": "string",
            "RedactionType": "string"
         },
         "LanguageIdSettings": { 
            "string" : { 
               "LanguageModelName": "string",
               "VocabularyFilterName": "string",
               "VocabularyName": "string"
            }
         },
         "LanguageModelName": "string",
         "LanguageOptions": [ "string" ],
         "VocabularyFilterMethod": "string",
         "VocabularyFilterName": "string",
         "VocabularyName": "string"
      },
      "StartTime": number,
      "Transcript": { 
         "RedactedTranscriptFileUri": "string",
         "TranscriptFileUri": "string"
      }
   }
}

Elementi di risposta

Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.

I dati seguenti vengono restituiti in formato JSON mediante il servizio.

CallAnalyticsJob

Fornisce informazioni dettagliate sull'attuale job di Call Analytics, incluso lo stato del processo e, se applicabile, il motivo dell'errore.

Tipo: CallAnalyticsJob oggetto

Errori

Per informazioni sugli errori comuni a tutte le operazioni, consultare Errori comuni.

BadRequestException

La tua richiesta non ha superato uno o più test di convalida. Ciò può verificarsi quando l'entità che stai cercando di eliminare non esiste o se si trova in uno stato non terminale (ad esempioIN PROGRESS). Per ulteriori informazioni, consulta il campo del messaggio di eccezione.

Codice di stato HTTP: 400

ConflictException

Esiste già una risorsa con questo nome. I nomi delle risorse devono essere univoci all'interno diAccount AWS.

Codice di stato HTTP: 400

InternalFailureException

Si è verificato un errore. Controlla il messaggio di errore, correggi il problema e riprova con la richiesta.

Codice di stato HTTP: 500

LimitExceededException

Hai inviato troppe richieste o il file di input è troppo lungo. Attendi prima di riprovare la richiesta oppure utilizza un file più piccolo e riprova la richiesta.

Codice di stato HTTP: 400

Vedi anche

Per ulteriori informazioni sull'utilizzo di questa API in uno degli SDK AWS specifici della lingua, consulta quanto segue:

• Interfaccia a riga di comando AWS

• SDK AWS per .NET

• SDK AWS per C++

• SDK AWS per Go

• AWS SDK per Java V2

• AWSSDK per JavaScript

• SDK AWS per PHP V3

• AWS SDK for Python

• SDK AWS per Ruby V3