Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Menyiapkan preferensi model ucapan Deepgram
Deepgram adalah layanan pengenalan suara pihak ketiga yang menyediakan speech-to-text kemampuan canggih yang didukung AI dengan dukungan untuk pemrosesan real-time dan batch. Deepgram menawarkan akurasi yang ditingkatkan di berbagai kondisi audio, berbagai bahasa, dan model khusus untuk kasus penggunaan yang berbeda. [Untuk informasi lebih lanjut tentang penawaran Deepgram, lihat/. https://deepgram.com](https://deepgram.com/) Untuk menggunakan Deepgram sebagai preferensi model pengenalan suara, Anda harus menyelesaikan proses penyiapan satu kali untuk mengonfigurasi kunci API Deepgram Anda dan menyimpannya dengan aman di AWS Secrets Manager.
**penting**
Deepgram adalah layanan pihak ketiga dan mungkin tidak mematuhi kerangka peraturan tertentu seperti GDPR, FedRAMP, atau standar kepatuhan lainnya yang dipatuhi oleh layanan AWS. Tinjau dokumentasi kepatuhan Deepgram dan persyaratan organisasi Anda sebelum menggunakan integrasi ini.
## Pemilihan titik akhir regional
Amazon Lex V2 secara otomatis memilih titik akhir API Deepgram yang sesuai berdasarkan wilayah AWS Anda untuk mengoptimalkan kinerja dan lokalitas data:
+ **Wilayah UE:** Untuk bot yang digunakan di wilayah AWS dengan `eu-` awalan (seperti`eu-west-1`,, dan`eu-central-1`)`eu-west-2`, Amazon Lex V2 menggunakan titik akhir Deepgram EU (). `api.eu.deepgram.com`
+ **Semua wilayah lain:** Untuk bot yang digunakan di semua wilayah AWS lainnya, Amazon Lex V2 menggunakan titik akhir Deepgram global (). `api.deepgram.com`
Pemilihan titik akhir ini otomatis dan saat ini tidak dapat disesuaikan. Kunci API Deepgram yang sama berfungsi dengan kedua titik akhir. Amazon Lex V2 tidak mendukung `apiTokenRegion` parameter yang disediakan Amazon Connect untuk konfigurasi titik akhir kustom. Untuk informasi selengkapnya tentang opsi konfigurasi titik akhir Amazon Connect, lihat [Titik Akhir dan Wilayah untuk penyedia STT pihak ketiga](https://docs.aws.amazon.com/connect/latest/adminguide/endpoints-regions-third-party-stt.html) di Panduan Administrator Amazon Connect.
## Membuat kunci API Deepgram
Sebelum Anda dapat menggunakan Deepgram dengan Amazon Lex V2, Anda perlu mendapatkan kunci API dari Deepgram.
Untuk membuat kunci API Deepgram:
1. Masuk ke konsol Deepgram di [https://console.deepgram.com/](https://console.deepgram.com/).
1. Di panel navigasi kiri, pilih **Kunci API**.
1. Pilih **Buat Kunci API Baru**.
1. Ikuti petunjuk untuk membuat kunci API dan menyalinnya untuk digunakan di bagian berikutnya.
**penting**
Simpan kunci API Anda dengan aman. Anda akan memerlukannya untuk mengonfigurasi AWS Secrets Manager di bagian berikutnya.
## Menyimpan kunci API di AWS Secrets Manager
Anda harus menyimpan kunci API Deepgram Anda di AWS Secrets Manager untuk Amazon Lex V2 untuk mengaksesnya dengan aman. Rahasia harus berisi satu pasangan kunci-nilai dengan `apiToken` sebagai kunci dan kunci API Deepgram Anda sebagai nilainya.
**penting**
Anda harus membuat kunci KMS simetris untuk digunakan dengan rahasia. Kunci KMS AWS terkelola default tidak akan berfungsi dengan Amazon Lex V2.
Untuk menyimpan kunci API Deepgram Anda di Secrets Manager:
1. Buka konsol AWS Secrets Manager di [https://console.aws.amazon.com/secretsmanager/](https://console.aws.amazon.com/secretsmanager/).
1. Pilih **Simpan rahasia baru**.
1. Untuk **Tipe rahasia**, pilih **Tipe rahasia lainnya**.
1. Konfigurasikan rahasia menggunakan salah satu metode berikut:
+ **Metode pasangan kunci/nilai:** Di bawah pasangan **kunci/nilai, tambahkan satu pasangan** kunci-nilai dengan kunci dan kunci API Deepgram Anda `apiToken` sebagai nilainya.
+ **Metode Plaintext:** Di bawah **Plaintext**, masukkan objek JSON dengan struktur berikut:
```
{
"apiToken": "your-deepgram-api-key-here"
}
```
1. Pilih **Berikutnya**.
1. Masukkan nama untuk rahasia Anda dan pilih **Berikutnya**.
1. (Opsional) Konfigurasikan rotasi rahasia jika diperlukan, lalu pilih **Berikutnya**.
1. Tinjau konfigurasi rahasia Anda dan pilih **Store**.
1. Setelah rahasia dibuat, arahkan ke rahasia Anda dan salin ARN. Anda akan memerlukan ARN ini saat mengonfigurasi bot Anda.
## Mengkonfigurasi kebijakan sumber daya untuk Secrets Manager
Untuk mengizinkan Amazon Lex V2 mengambil kunci API Deepgram Anda, Anda harus melampirkan kebijakan sumber daya ke rahasia Anda.
Berikut ini adalah contoh kebijakan sumber daya yang memungkinkan Amazon Lex V2 untuk mengambil rahasia:
```
{
"Version": "2012-10-17" ,
"Statement": [
{
"Sid": "LexTrust",
"Effect": "Allow",
"Principal": {
"Service": "lex.amazonaws.com"
},
"Action": "secretsmanager:GetSecretValue",
"Resource": "*",
"Condition": {
"StringEquals": {
"aws:SourceAccount": ""
},
"ArnLike": {
"aws:SourceArn": "arn:aws:lex:us-east-1::bot-alias/*/*"
}
}
}
]
}
```
Ganti `` dengan ID akun AWS Anda yang sebenarnya dan sesuaikan wilayah dalam pola ARN sesuai kebutuhan untuk penerapan Anda.
## Mengkonfigurasi bot Anda untuk menggunakan Deepgram
Setelah menyiapkan kunci API Deepgram Anda di Secrets Manager, Anda dapat mengonfigurasi bot Amazon Lex V2 Anda untuk menggunakan Deepgram untuk pengenalan suara.
Untuk mengkonfigurasi Deepgram untuk bot Anda:
1. Di konsol Amazon Lex V2, navigasikan ke bot Anda dan pilih lokal yang ingin Anda konfigurasikan.
1. Untuk **preferensi model Speech**, pilih **Deepgram**.
1. Bidang tambahan akan muncul untuk konfigurasi Deepgram:
+ **Model ID** (opsional) - Tentukan ID model Deepgram jika Anda ingin menggunakan model tertentu. Untuk model yang tersedia, lihat [dokumentasi model Deepgram](https://developers.deepgram.com/docs/model). Jika dibiarkan kosong, model default API akan digunakan.
+ **Rahasia ARN** (wajib) - Masukkan ARN rahasia yang Anda buat di AWS Secrets Manager yang berisi kunci API Deepgram Anda.
1. Simpan perubahan Anda untuk menerapkan preferensi model ucapan Deepgram ke lokal bot Anda.
Bot Anda sekarang dikonfigurasi untuk menggunakan Deepgram untuk pengenalan suara. Uji bot Anda untuk memastikan bahwa pengenalan suara berfungsi seperti yang diharapkan dengan integrasi Deepgram.
## Memecahkan masalah integrasi Deepgram
Jika Anda mengalami masalah dengan integrasi Deepgram Anda, periksa hal berikut:
+ **Validitas kunci API:** Pastikan kunci API Deepgram Anda valid dan belum kedaluwarsa.
+ **Konfigurasi rahasia:** Verifikasi bahwa rahasia Anda di AWS Secrets Manager berisi nama kunci (`apiToken`) dan nilai kunci API yang benar.
+ **Kebijakan sumber daya:** Konfirmasikan bahwa kebijakan sumber daya pada rahasia Anda memungkinkan Amazon Lex V2 mengaksesnya dengan ID akun dan pola ARN yang benar.
+ **Kunci KMS:** Pastikan Anda menggunakan kunci KMS simetris yang dikelola pelanggan, bukan kunci terkelola AWS default.
+ **ID Model:** Jika Anda menentukan ID model, verifikasi bahwa itu adalah pengidentifikasi model Deepgram yang valid.
Untuk dukungan tambahan, lihat CloudWatch log Amazon Lex V2 atau hubungi AWS Support.