View a markdown version of this page

Menerapkan kasus penggunaan Agen Batuan Dasar mandiri - Pembuat Aplikasi AI Generatif di AWS

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

Menerapkan kasus penggunaan Agen Batuan Dasar mandiri

Ikuti step-by-step petunjuk di bagian ini untuk mengonfigurasi dan menyebarkan solusi ke akun Anda.

Waktu untuk menyebarkan: Sekitar 10-30 menit

  1. Masuk ke AWS Management Console dan pilih tombol untuk meluncurkan CloudFront template.

    BedrockAgent.template

    Launch solution

  2. Template diluncurkan di Wilayah AS Timur (Virginia N.) secara default. Untuk meluncurkan solusi di Wilayah AWS yang berbeda, gunakan pemilih Wilayah di bilah navigasi konsol.

    catatan

    Solusi ini menggunakan Amazon Bedrock, yang saat ini tidak tersedia di semua Wilayah AWS. Jika Anda menggunakan fitur-fitur ini, Anda harus meluncurkan solusi ini di Wilayah AWS tempat layanan ini tersedia. Untuk ketersediaan terbaru menurut Wilayah, lihat Daftar Layanan Regional AWS.

  3. Pada halaman Buat tumpukan, verifikasi bahwa URL templat yang benar ada di kotak teks URL Amazon S3 dan pilih Berikutnya.

  4. Pada halaman Tentukan detail tumpukan, tetapkan nama ke tumpukan solusi Anda. Untuk informasi tentang batasan penamaan karakter, lihat {https---docs-aws-amazon-com- https---docs-aws-amazon-com -IAM-latest- UserGuide -reference-iam-limits-html} [kuota IAM dan AWS STS] di Panduan Pengguna AWS Identity and Access Management.

  5. Di bawah Parameter, tinjau parameter untuk templat solusi ini dan modifikasi sesuai kebutuhan. Solusi ini menggunakan nilai default berikut.

    Parameter Entri default Deskripsi

    UseCaseUUID

    <_Requires input_>

    Panjang 36 karakter UUIDv4 untuk mengidentifikasi kasus penggunaan yang diterapkan ini dalam suatu aplikasi.

    UseCaseConfigRecordKey

    <Requires input>

    Kunci yang sesuai dengan catatan yang berisi konfigurasi yang diperlukan oleh penyedia obrolan fungsi Lambda saat runtime.

    Catatan dalam tabel harus memiliki atribut kunci yang cocok dengan nilai ini, dan atribut config yang berisi konfigurasi yang diinginkan.

    Catatan ini akan diisi oleh platform penyebaran jika sedang digunakan. Untuk penerapan mandiri dari kasus penggunaan ini, diperlukan entri yang dibuat secara manual dalam tabel yang ditentukan. UseCaseConfigTableName

    UseCaseConfigTableName

    <Requires input>`

    Tumpukan akan membaca konfigurasi kasus penggunaan dari tabel yang disediakan di sini dan menggunakan kunci catatan yang ditentukan dalam UseCaseConfigRecordKey.

    DefaultUserEmail

    placeholder@example.com

    Email pengguna default untuk kasus penggunaan ini. Solusinya membuat pengguna Amazon Cognito untuk email ini untuk mengakses kasus penggunaan.

    ExistingRestApiId

    (Masukan opsional)

    ID API Gateway REST API yang ada untuk digunakan. Jika tidak disediakan, API API Gateway REST API baru akan dibuat. Biasanya disediakan saat menerapkan dari dasbor Deployment.

    Catatan: Menggunakan Existing APIs dapat membantu mengurangi duplikasi sumber daya dan menyederhanakan pengelolaan APIs kapan Anda perlu menerapkan beberapa kasus penggunaan mandiri. Saat menyediakan yang ada APIs untuk kasus penggunaan mandiri, Anda bertanggung jawab untuk memastikan bahwa API dikonfigurasi dengan rute yang diperlukan dengan model yang diharapkan. Rute /detail pra-konfigurasi yang diperlukan (mengambil detail kasus penggunaan selama obrolan) dan secara opsional, rute /umpan balik (jika FeedbackEnableddiatur untuk mengaktifkan pengumpulan umpan balik Yes untuk respons obrolan LLM) harus dikonfigurasi. Selain itu ExistingApiRootResourceId,, ExistingCognitoUserPoolIddan juga ExistingCognitoGroupPolicyTableNameharus disediakan.

    ExistingApiRootResourceId

    (Masukan opsional)

    API Gateway REST API Root Resource ID yang ada untuk digunakan. REST API Root Resource ID dapat diperoleh dari konsol AWS dengan memilih sumber daya root (/) di bagian “Sumber Daya” API. ID Sumber Daya kemudian akan ditampilkan di panel Rincian sumber daya. Sebagai alternatif, Anda dapat menjalankan panggilan describe API di REST API untuk menemukan ID Sumber Daya Root.

    FeedbackEnabled

    No

    Jika disetel ke Tidak, tumpukan kasus penggunaan yang diterapkan tidak akan memiliki akses ke fitur umpan balik.

    CognitoDomainPrefix

    (Masukan opsional)

    Masukkan nilai jika Anda ingin memberikan domain untuk klien kumpulan pengguna Amazon Cognito. Jika Anda tidak memberikan nilai, solusinya menghasilkan satu.

    ExistingCognitoUserPoolId

    (Masukan opsional)

    UserPoolIddari kumpulan pengguna Amazon Cognito yang ingin Anda autentikasi dengan kasus penggunaan ini. CATATAN: Anda biasanya memberikan ID ini saat menerapkan dari dasbor Deployment, tetapi Anda dapat menghilangkannya saat menerapkan tumpukan kasus penggunaan ini secara mandiri.

    ExistingCognitoUserPoolClient

    (Masukan opsional)

    Menyediakan klien kumpulan pengguna (klien aplikasi) untuk menggunakan yang sudah ada. Jika Anda tidak menyediakan klien kumpulan pengguna, solusinya akan membuatnya. Anda hanya dapat memberikan parameter ini jika Anda memberikan file ExistingCognitoUserPoolId.

    ExistingCognitoGroupPolicyTableName

    (Masukan opsional)

    Nama tabel DynamoDB yang berisi kebijakan grup pengguna. Ini digunakan oleh otorisasi khusus pada API kasus penggunaan. CATATAN: Anda biasanya memberikan nama ini saat menerapkan dari dasbor Deployment, tetapi Anda dapat menghilangkannya saat menerapkan tumpukan kasus penggunaan ini secara mandiri.

    VpcEnabled

    No

    Apakah sumber daya tumpukan digunakan dalam VPC.

    CreateNewVpc

    No

    Pilih Yes apakah Anda ingin solusi untuk membuat VPC baru untuk Anda dan menggunakannya untuk kasus penggunaan ini. CATATAN: Parameter ini hanya relevan jika VpcEnabledadaYes.

    IPAMPoolId

    (Masukan opsional)

    Jika Anda ingin menetapkan rentang CIDR menggunakan IPAM, berikan ID kolam IPAM untuk digunakan. CATATAN: Parameter ini hanya relevan jika VpcEnabledada Yes dan CreateNewVpcsedangNo.

    ExistingVpcId

    (Masukan opsional)

    ID VPC dari VPC yang ada untuk digunakan untuk kasus penggunaan. CATATAN: Parameter ini hanya relevan jika VpcEnabledada Yes dan CreateNewVpcsedangNo.

    ExistingPrivateSubnetIds

    (Masukan opsional)

    Daftar subnet yang dipisahkan koma dari subnet IDs pribadi yang ada untuk digunakan untuk menyebarkan fungsi Lambda. CATATAN: Parameter ini hanya relevan jika VpcEnabledada Yes dan CreateNewVpcsedangNo.

    ExistingSecurityGroupIds

    (Masukan opsional)

    Daftar grup keamanan yang dipisahkan koma dari VPC yang ada yang akan digunakan untuk mengonfigurasi fungsi Lambda. CATATAN: Parameter ini hanya relevan jika VpcEnabledada Yes dan CreateNewVpcsedangNo.

    VpcAzs

    (Masukan opsional)

    Daftar dipisahkan koma AZs di mana subnet dibuat VPCs

    Catatan: Hanya relevan jika VpcEnabledada Yes dan CreateNewVpcadalahNo.

    BedrockAgentId

    <Requires input>

    ID Agen Bedrock Amazon yang akan digunakan.

    BedrockAgentAliasId

    <Requires input>

    ID alias dari Amazon Bedrock Agent yang akan digunakan.

    DeployUI

    Yes

    Pilih opsi untuk menerapkan UI obrolan frontend untuk penerapan ini. Memilih No hasil dalam membuat infrastruktur untuk meng-host APIs, otentikasi untuk APIs, dan pemrosesan backend tanpa UI obrolan.

  6. Pilih Berikutnya.

  7. Pada halaman Konfigurasikan opsi tumpukan, pilih Berikutnya.

  8. Pada halaman Ulasan, tinjau dan konfirmasikan pengaturan. Pilih kotak yang mengakui bahwa template akan membuat sumber daya IAM.

  9. Pilih Membuat tumpukan untuk menerapkannya.

Anda dapat melihat status tumpukan di CloudFormation konsol AWS di kolom Status. Anda akan menerima status CREATE_COMPLETE dalam waktu sekitar 10-30 menit.