View a markdown version of this page

Tutorial: WebRTC dengan RELAYING TURN menggunakan Amazon Kinesis Video Streams - Batu Dasar Amazon AgentCore
ArsitekturCara kerjanya

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Tutorial: WebRTC dengan RELAYING TURN menggunakan Amazon Kinesis Video Streams

Dalam tutorial ini, Anda membangun koneksi suara WebRTC antara klien browser dan agen yang berjalan di AgentCore Runtime, menggunakan TURN yang dikelola Amazon Kinesis Video Streams (KVS) untuk penyampaian media. Agen memproses audio secara real-time menggunakan model dasar Amazon Bedrock untuk percakapan ucapan-ke-ucapan.

Setelah selesai, Anda akan memiliki koneksi WebRTC yang berfungsi di mana audio mengalir dua arah antara browser dan agen Anda.

Tutorial ini membutuhkan VPC dengan keluar internet untuk konektivitas ke titik akhir KVS TURN. Untuk informasi selengkapnya, lihat Pertimbangan akses Internet. Semua prasyarat lainnya ditangani oleh aplikasi sampel. Sampel menggunakan AgentCore CLI untuk penerapan ke AgentCore Runtime.

Untuk aplikasi sampel lengkap, lihat Agen Suara WebRTC dengan KVS TURN aktif. GitHub

Arsitektur

Diagram arsitektur yang menunjukkan WebRTC saat AgentCore Runtime dengan KVS TURN menyampaikan melalui VPC.
Klien browser

Halaman web yang menangkap audio mikrofon menggunakan API WebRTC browser dan memutar respons audio agen.

AgentCore Waktu pelaksanaan

Menghosting agen dan melampirkan ke VPC pengguna melalui antarmuka jaringan elastis (ENI) di subnet pribadi.

Agen

Aplikasi Python yang diterapkan ke AgentCore Runtime yang menangani pensinyalan WebRTC dan manajemen kredensia TURN melalui /invocations titik akhir, dan mengalirkan audio antara klien dan model dasar.

Pengguna VPC dengan keluar internet

Menyediakan konektivitas jaringan dari agen ke server relai KVS TURN. Rute lalu lintas dari ENI di subnet pribadi melalui gateway NAT dan gateway internet untuk mencapai titik akhir TURN.

Server relai KVS TURN

Menyampaikan lalu lintas media antara klien browser dan agen. Agen memperoleh kredenSIAL TURN sementara dari KVS menggunakan API. GetIceServerConfig

Cara kerjanya

  1. Klien memanggil agen untuk mengambil kredenSIAL KVS TURN dan konfigurasi server ICE.

  2. Klien membuat penawaran WebRTC dan mengirimkannya ke agen. Agen membuat koneksi peer yang dikonfigurasi dengan server KVS TURN dan mengembalikan jawaban.

  3. Klien dan agen bertukar kandidat ICE untuk membangun konektivitas melalui server TURN.

  4. Setelah terhubung, klien mengalirkan audio mikrofon ke agen melalui WebRTC. Agen meneruskan audio ke model dasar Amazon Bedrock dan mengalirkan respons lisan model kembali ke klien.