

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

# Menggunakan BedrockAgentIntent untuk menggunakan Agen Batuan Dasar Amazon di Amazon Lex V2
<a name="bedrock-agent-intent"></a>

**catatan**  
Sebelum Anda dapat memanfaatkan fitur AI generatif, Anda harus memenuhi prasyarat berikut  
Untuk informasi tentang harga untuk menggunakan Amazon Bedrock, lihat harga [Amazon Bedrock](https://aws.amazon.com/bedrock/pricing/).
Aktifkan kemampuan AI generatif untuk lokal bot Anda. Untuk melakukannya, ikuti langkah-langkah di[Optimalkan pembuatan dan kinerja bot Lex V2 dengan menggunakan AI generatif](generative-features.md). 

Anda dapat memanfaatkan Amazon Bedrock Agents untuk menangani beban kerja kompleks yang diminta oleh pelanggan tanpa harus melalui proses definisi tugas yang komprehensif. Amazon Lex V2 menawarkan built-in `AMAZON.BedrockAgentIntent` yang dapat Anda tambahkan ke bot Anda. Maksud ini memanfaatkan kemampuan AI generatif dari Amazon Bedrock dengan mengenali permintaan pelanggan, menganalisisnya, memberi alasan, dan akhirnya merespons. Ini juga memiliki kemampuan untuk mengajukan pertanyaan tindak lanjut untuk mencapai tugas yang diperlukan (misalnya, gambar Anda mendefinisikan agen ritel yang dapat memeriksa status pesanan pelanggan. Ketika pelanggan meminta status pesanan, agen pertama meminta `customerId` atau terkait `emailId` untuk mengambil rincian, dan akhirnya merespons dengan status pesanan yang benar). Anda juga dapat memutuskan untuk mengintegrasikan AMAZON Anda. BedrockAgentIntent dengan Basis Pengetahuan Batuan Dasar untuk secara langsung menjawab pertanyaan pelanggan.

Pastikan peran IAM Anda memiliki izin yang tepat untuk mengakses AMAZON. BedrockAgentIntent dengan mengikuti langkah-langkah di Izin untuk AMAZON. BedrockAgentIntent

Untuk memanfaatkan AMAZON. BedrockAgentIntent Anda harus telah mendirikan salah satu toko pengetahuan berikut.
+ Agen Batuan Dasar Amazon — Untuk informasi selengkapnya, lihat [Membuat Agen Batuan Dasar](https://docs.aws.amazon.com/bedrock/latest/userguide/agents.html).
+ Basis Pengetahuan Amazon Bedrock — Untuk informasi selengkapnya, lihat [Membangun Basis Pengetahuan](https://docs.aws.amazon.com/bedrock/latest/userguide/knowledge-base-create.html).

Untuk menggunakan AMAZON. BedrockAgentIntent, pastikan bahwa peran IAM Anda memiliki izin yang tepat dengan mengikuti langkah-langkah di Izin yang diperlukan [di Lex V2 untuk Intent Agen Batuan Dasar](https://docs.aws.amazon.com/lexv2/latest/dg/bedrock-agent-intent-permissions.html).

**Topics**
+ [Aktifkan Intent Agen Batuan Dasar di layar konfigurasi Generative AI](bedrock-agent-intent-genai.md)
+ [Aktifkan Intent Agen Batuan Dasar dengan menambahkan intent bawaan ke bot Anda](bedrock-agent-intent-level.md)
+ [Izin diperlukan di Lex V2 untuk Intent Agen Batuan Dasar](bedrock-agent-intent-permissions.md)
+ [Permintaan sampel dengan atribut sesi](bedrock-agent-intent-sample.md)

# Aktifkan Intent Agen Batuan Dasar di layar konfigurasi Generative AI
<a name="bedrock-agent-intent-genai"></a>

Anda dapat mengaktifkan Bedrock Agent Intent dengan menavigasi ke layar Generative AI.

1. Masuk ke AWS Management Console dan buka konsol Amazon Lex V2 di [https://console.aws.amazon.com/lexv2/rumah](https://console.aws.amazon.com/lexv2/home).

1. Di panel navigasi di bawah **Bots**, pilih bot yang ingin Anda gunakan untuk Bedrock Agent Intent.

1. Pilih bahasa untuk bot yang ingin Anda aktifkan. 

1. Buka bagian **konfigurasi Generative AI** di layar, dan pilih **Configure**.

1. Di bagian BedrockAgentIntent konfigurasi, pilih **Buat BedrockAgent maksud.**

# Aktifkan Intent Agen Batuan Dasar dengan menambahkan intent bawaan ke bot Anda
<a name="bedrock-agent-intent-level"></a>

Anda dapat mengaktifkan Intent Agen Batuan Dasar dengan menambahkan intent bawaan ke bot Amazon Lex V2 Anda.

**catatan**  
Anda harus terlebih dahulu mengaktifkan fitur Bedrock Agent Intent pada panel Generative AI untuk mengaktifkan fitur untuk bot individual. 

1. Masuk ke AWS Management Console dan buka konsol Amazon Lex V2 di https://console.aws.amazon.com/lexv2/ rumah.

1. Di panel navigasi di bawah **Bots**, pilih bot yang ingin Anda gunakan untuk Intent Agen Batuan Dasar.

1. Di bawah Semua bahasa, pilih **Bahasa Inggris (AS**) untuk memperluas daftar.

1. Pilih **Tambah maksud** dan pilih **Gunakan maksud bawaan** dari menu tarik-turun.

1. Untuk detail lebih lanjut tentang konfigurasi untuk AMAZON. BedrockAgentIntent, lihat[AMAZON.BedrockAgentIntent](built-in-intent-bedrockagent.md).

# Izin diperlukan di Lex V2 untuk Intent Agen Batuan Dasar
<a name="bedrock-agent-intent-permissions"></a>
+ Untuk mengakses fitur ini di konsol Amazon Lex V2, pastikan peran konsol Anda memiliki `bedrock:ListFoundationModels` dan `bedrock:ListInferenceProfiles` izin.
+ Peran IAM yang terkait dengan bot harus memiliki izin yang diperlukan untuk. `AMAZON.BedrockAgentIntent`

  Peran bot harus memiliki izin untuk menelepon `bedrock:InvokeAgent` jika menggunakan Agen Amazon Bedrock, `bedrock:InvokeModel` dan `bedrock:RetrieveAndGenerate` jika menggunakan Pangkalan Pengetahuan Amazon Bedrock dalam intent. Anda juga harus melampirkan pernyataan untuk setiap agen yang Anda tentukan di bot Anda `AMAZON.BedrockAgentIntent` (lihat Izin untuk mengakses Agen Amazon Bedrock atau Izin untuk mengakses pernyataan Pangkalan Pengetahuan Amazon Bedrock dalam kebijakan di bawah). 

  Saat Anda mengaktifkan fitur dengan konsol Amazon Lex, kebijakan akan ditambahkan secara otomatis ke peran bot asalkan bot Anda menggunakan peran terkait layanan yang dihasilkan oleh Amazon Lex.

# Permintaan sampel dengan atribut sesi
<a name="bedrock-agent-intent-sample"></a>

Contoh berikut menunjukkan cara memanggil AMAZON. BedrockAgentIntent dan menunjukkan atribut sesi dan permintaan yang diisi dalam respons. Atribut ini berisi data respons Agen Bedrock dan dapat digunakan untuk mengakses output agen, sumber Pangkalan Pengetahuan Amazon Bedrock, dan detail pemanggilan grup tindakan.

```
{
    "sessionId": "user-session-123",
    "messages": [{
        "content": "Your order #12345 is currently being processed and will ship within 2-3 business days. You will receive a tracking number via email once it ships.",
        "contentType": "PlainText"
    }],
    "sessionState": {
        "sessionAttributes": {
            "x-amz-lex:bedrock-agent-search-response": "Your order #12345 is currently being processed and will ship within 2-3 business days. You will receive a tracking number via email once it ships.",
            "x-amz-lex:bedrock-knowledge-base-search-response-source": "[{\"title\": \"Order Processing Guide\", \"uri\": \"s3://knowledge-base/orders/processing.pdf\", \"excerpt\": \"Standard orders typically ship within 2-3 business days...\"}]",
            "x-amz-lex:bedrock-agent-action-group-invocation-input": "{\"actionGroupName\": \"OrderLookup\", \"function\": \"getOrderStatus\", \"parameters\": {\"orderId\": \"12345\", \"customerId\": \"67890\"}}",
            "x-amz-lex:bedrock-agent-knowledge-base-lookup-input": "{\"knowledgeBaseId\": \"KB123456\", \"query\": \"order status processing time\", \"numberOfResults\": 3}"
        },
        "intent": {
            "name": "BedrockAgentIntent",
            "slots": {},
            "state": "Fulfilled",
            "confirmationState": "None"
        },
        "dialogAction": {
            "type": "ElicitIntent"
        }
    },
    "interpretations": [{
        "intent": {
            "name": "FallbackIntent",
            "slots": {}
        },
        "interpretationSource": "Lex"
    }],
    "requestAttributes": {
        "x-amz-lex:channels:platform": "Web",
        "x-amz-lex:accept-content-types": "PlainText",
        "x-amz-lex:bedrock-agent-search-response": "Your order #12345 is currently being processed and will ship within 2-3 business days. You will receive a tracking number via email once it ships.",
        "x-amz-lex:bedrock-knowledge-base-search-response-source": "[{\"title\": \"Order Processing Guide\", \"uri\": \"s3://knowledge-base/orders/processing.pdf\", \"excerpt\": \"Standard orders typically ship within 2-3 business days...\"}]",
        "x-amz-lex:bedrock-agent-action-group-invocation-input": "{\"actionGroupName\": \"OrderLookup\", \"function\": \"getOrderStatus\", \"parameters\": {\"orderId\": \"12345\", \"customerId\": \"67890\"}}",
        "x-amz-lex:bedrock-agent-knowledge-base-lookup-input": "{\"knowledgeBaseId\": \"KB123456\", \"query\": \"order status processing time\", \"numberOfResults\": 3}"
    }
}
```

Dalam contoh ini, atribut sesi menunjukkan cara BedrockAgentIntent mengisi data respons termasuk jawaban agen, sumber Pangkalan Pengetahuan Amazon Bedrock yang digunakan, pemanggilan grup tindakan, dan detail pencarian Pangkalan Pengetahuan Amazon Bedrock yang digunakan untuk menghasilkan respons.

Untuk informasi selengkapnya, lihat [AMAZON. BedrockAgentIntent](https://docs.aws.amazon.com/lexv2/latest/dg/built-in-intent-bedrockagent.html).