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

# Konfigurasikan agen inline saat runtime
<a name="agents-create-inline"></a>

Anda dapat mengonfigurasi dan memanggil agen Amazon Bedrock sebaris secara dinamis saat runtime menggunakan API. [InvokeInlineAgent](https://docs.aws.amazon.com//bedrock/latest/APIReference/API_agent-runtime_InvokeInlineAgent.html) Menggunakan agen inline memberi Anda fleksibilitas untuk menentukan kemampuan agen Anda seperti model dasar, instruksi, kelompok tindakan, pagar pembatas, dan basis pengetahuan pada saat yang sama Anda memanggil agen Anda. Anda tidak perlu menentukan kemampuan agen sebelum Anda dapat menggunakannya. 

Berikut ini adalah beberapa kasus penggunaan di mana menggunakan agen inline dapat membantu dengan memberi Anda fleksibilitas untuk mengonfigurasi agen Anda pada waktu pemanggilan.
+ Lakukan eksperimen cepat dengan mencoba berbagai fitur agen dengan konfigurasi berbeda dan memperbarui alat secara dinamis yang tersedia untuk agen Anda tanpa membuat agen terpisah.
+ Secara dinamis memanggil agen untuk melakukan tugas-tugas tertentu tanpa membuat versi agen baru atau mempersiapkan agen. 
+ Jalankan kueri sederhana atau gunakan penerjemah kode untuk tugas-tugas sederhana dengan membuat dan memanggil agen saat runtime.
+ Buat beberapa agen dalam pengaturan [kolaborasi multi-agen](agents-multi-agent-collaboration.md) untuk bekerja sama dalam tugas atau percakapan.

  Untuk menggunakan kolaborasi multi-agen, Anda dapat membuat agen Anda dalam kombinasi berikut menggunakan agen inline. APIs  
**Jenis agen**    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/bedrock/latest/userguide/agents-create-inline.html)

**Model dan Wilayah yang didukung**

Anda dapat menggunakan model dasar apa pun yang didukung oleh Agen Bedrock Amazon untuk mengonfigurasi agen inline Anda dan dapat memanggil agen inline Anda di salah satu Wilayah tempat Agen Amazon Bedrock didukung. Untuk informasi selengkapnya tentang model dan Wilayah yang didukung oleh Amazon Bedrock Agents, lihat berikut ini:
+ [Wilayah yang Didukung untuk Agen Batuan Dasar Amazon](https://docs.aws.amazon.com//bedrock/latest/userguide/agents-supported.html)
+ [Dukungan model berdasarkan fitur](https://docs.aws.amazon.com//bedrock/latest/userguide/models-features.html)

Dengan agen inline Anda dapat beralih antar model. Kami menyarankan Anda beralih di antara model yang termasuk dalam keluarga yang sama. Beralih di antara model yang termasuk dalam keluarga yang berbeda dapat mengakibatkan perilaku yang tidak konsisten dan dapat menyebabkan kegagalan. 

Mengonfigurasi dan memanggil agen inline saat ini tidak didukung di konsol Amazon Bedrock.

## Pedoman untuk menggunakan templat prompt lanjutan untuk agen inline
<a name="advanced-prompts-inline-guidelines"></a>
+ **Template prompt dasar** - Secara default, Amazon Bedrock akan menggunakan template prompt dasar default untuk agen inline Anda dan petunjuknya dapat diubah di latar belakang kapan saja. Ini mungkin membuat tanggapan tidak konsisten. Jika Anda menginginkan respons yang konsisten terhadap kueri Anda, sesuaikan perilaku agen inline Anda dengan mengganti logika di templat prompt dasar default dengan konfigurasi Anda sendiri. Untuk informasi selengkapnya, lihat [Templat prompt lanjutan](https://docs.aws.amazon.com//bedrock/latest/userguide/advanced-prompts-templates.html).
+ **Enkripsi** — Gunakan `customer managed key ` untuk mengenkripsi detail sesi saat istirahat/penyimpanan. Jika sesi dimulai dengan kunci yang dikelola pelanggan, itu akan diperlukan untuk semua permintaan future yang dibuat untuk sesi yang sama. menggunakan kunci terkelola pelanggan yang berbeda untuk sesi yang sama akan menghasilkan pengecualian. 
+ **Berbagi sesi** - Ke depan semua sesi adalah tingkat akun, bukan tingkat peran. Anda dapat mengisolasi sesi di tingkat agen dengan menentukan nilai unik untuk. `agentName`
+ **Status sesi sebaris** - Atribut di dalam `InlineSessionState` bertahan melalui sesi. Gunakan atribut untuk memberikan konteks tambahan untuk model Anda dan untuk beberapa [bidikan yang diminta](https://docs.aws.amazon.com//bedrock/latest/userguide/what-is-a-prompt.html#few-shot-prompting-vs-zero-shot-prompting).

# Prasyarat
<a name="inline-agent-prereq"></a>

**catatan**  
Mengonfigurasi dan menjalankan fitur agen inline ada dalam rilis pratinjau untuk Amazon Bedrock dan dapat berubah sewaktu-waktu.

Lengkapi prasyarat berikut sebelum Anda memanggil agen inline Anda:

1. Tentukan model dasar yang ingin Anda gunakan untuk mengonfigurasi agen inline Anda, Wilayah tempat Anda ingin memanggil agen, dan instruksi yang memberi tahu agen inline apa yang harus dilakukan. 

1. Buat atau siapkan satu atau lebih properti agen Amazon Bedrock berikut yang ingin Anda gunakan untuk agen inline Anda.   
****    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/bedrock/latest/userguide/inline-agent-prereq.html)

1. Buat peran AWS Identity and Access Management (IAM) dan lampirkan kebijakan yang disebutkan dalam langkah ini ke peran tersebut. 

   Sebelum Anda dapat memanggil agen inline, Anda harus membuat peran IAM yang memberikan izin yang diperlukan untuk menggunakan `InvokeInlineAgent` API dan mengakses sumber daya seperti fungsi Lambda, basis pengetahuan, dan model dasar. 

   Buat peran layanan kustom untuk agen inline Anda dengan mengikuti langkah-langkah di [Membuat peran untuk mendelegasikan izin ke](https://docs.aws.amazon.com//bedrock/latest/userguide/getting-started.html) pengguna IAM. Setelah Anda membuat peran IAM, lampirkan kebijakan berikut ke peran tersebut.
**catatan**  
Sebagai praktik terbaik untuk tujuan keamanan, ganti, dan *\$1.ids* dengan Wilayah*\$1\$1account-id\$1*, id akun Anda, dan id sumber daya tertentu. setelah Anda membuatnya. *\$1\$1region\$1*

# Memanggil agen inline
<a name="inline-agent-invoke"></a>

**catatan**  
Mengonfigurasi dan menjalankan fitur agen inline ada dalam rilis pratinjau untuk Amazon Bedrock dan dapat berubah sewaktu-waktu.

[Sebelum Anda memanggil agen inline Anda, pastikan Anda telah menyelesaikan Prasyarat.](https://docs.aws.amazon.com//bedrock/latest/userguide/inline-agent-prereq.html)

Untuk memanggil agen inline, kirim permintaan [InvokeInlineAgent](https://docs.aws.amazon.com//bedrock/latest/APIReference/API_agent-runtime_InvokeInlineAgent.html)API dengan [titik akhir waktu proses Agen untuk Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-rt) dan sertakan bidang berikut secara minimal.


****  

| Bidang | Kasus penggunaan | 
| --- | --- | 
| instruksi | Berikan instruksi yang memberi tahu agen inline apa yang harus dilakukan dan bagaimana ia harus berinteraksi dengan pengguna. | 
| FoundationModel | Tentukan [model dasar](https://docs.aws.amazon.com//bedrock/latest/userguide/foundation-models-reference.html) yang akan digunakan untuk orkestrasi oleh agen inline yang Anda buat. Misalnya, claude antropik, meta Llama3.1, dll. | 
| sessionId | Pengidentifikasi unik sesi. Gunakan nilai yang sama di seluruh permintaan untuk melanjutkan percakapan yang sama. | 

Bidang berikut adalah opsional:


****  

| Bidang | Kasus penggunaan | 
| --- | --- | 
| ActionGroups | Daftar grup aksi dengan masing-masing kelompok tindakan yang menentukan tindakan yang dapat dilakukan agen inline.  | 
| Basis pengetahuan | Asosiasi basis pengetahuan dengan agen inline untuk menambah respons yang dihasilkan oleh model.  | 
| GuardrailConfiguration | Konfigurasi pagar pembatas untuk memblokir topik, mencegah halusinasi, dan menerapkan perlindungan untuk aplikasi Anda.  | 
| Kolaborasi Agen | Mendefinisikan bagaimana agen kolaborator menangani informasi di beberapa agen kolaborator untuk mengoordinasikan respons akhir. Agen kolaborator juga bisa menjadi supervisor. | 
| CollaboratorConfigurations | Konfigurasi untuk agen kolaborator.  | 
| kolaborator | Daftar agen kolaborator. | 
| promptOverrideConfiguration | Konfigurasi untuk prompt lanjutan yang digunakan untuk mengganti prompt default. | 
| AktifkanTrace | Tentukan apakah akan mengaktifkan jejak atau tidak untuk melacak proses penalaran agen inline. | 
| Detik IdleSession TTLIn | Tentukan durasi setelah agen inline harus mengakhiri sesi dan menghapus informasi yang tersimpan. | 
| customerEncryptionKeyArn | Tentukan ARN kunci KMS untuk mengenkripsi sumber daya agen, | 
| EndSession | Tentukan apakah akan mengakhiri sesi dengan agen inline atau tidak. | 
| inlineSessionState | Parameter yang menentukan berbagai atribut sesi. | 
| InputTeks | Tentukan teks prompt untuk dikirim ke agen. | 
| alasan\$1config | Untuk mengaktifkan penalaran model sehingga model menjelaskan bagaimana ia mencapai kesimpulannya. Gunakan di dalam additionalModelRequestFields bidang. Anda harus menentukan jumlah budget\$1tokens yang digunakan untuk penalaran model, yang merupakan bagian dari token output. Untuk informasi lebih lanjut, lihat [Meningkatkan respons model dengan penalaran model](https://docs.aws.amazon.com/bedrock/latest/userguide/inference-reasoning.html). | 

Contoh `InvokeInlineAgent` API berikut menyediakan konfigurasi agen inline lengkap termasuk model dasar, instruksi, grup tindakan dengan interpreter kode, pagar pembatas, dan basis pengetahuan. 

```
response = bedrock_agent_runtime.invoke_inline_agent(
    // Initialization parameters: cannot be changed for a conversation
    sessionId='uniqueSessionId',
    customerEncryptionKeyArn: String,
    
    // Input
    inputText="Hello, can you help me with a task?",
    endSession=False,
    enableTrace=True,
    
    // Agent configurations
    foundationModel='anthropic.claude-3-7-sonnet-20250219-v1:0',
    instruction="You are a helpful assistant...",
    actionGroups=[
        {
            'name': 'CodeInterpreterAction',
            'parentActionGroupSignature': 'AMAZON.CodeInterpreter'
        },
        {
            'actionGroupName': 'FetchDetails',
            'parentActionGroupSignature': '',
            "actionGroupExecutor": { ... },
            "apiSchema": { ... },
            "description": "string",
            "functionSchema": { ... }
        }
    ],
    knowledgeBases=[
        {
            knowledgeBaseId: "string",
            description: 'Use this KB to get all the info',
            retrievalConfiguration: { 
                vectorSearchConfiguration: { 
                    filter: { ... },
                    numberOfResults: number,
                    overrideSearchType: "string"
               }
            }
        }
    ],
    guardrailConfiguration={
        guardrailIdentifier: 'BlockEverything',
        gurardrailVersion: '1.0'
    },
    promptOverrideConfiguration: {...}
    
    // session properties: persisted throughout conversation
    inlineSessionState = {
        sessionAttributes = { 'key': 'value' },
        promptSessionAttributes = {k:v},
        returnControlInvocationResults = {...},
        invocationId = 'abc',
        files = {...},
    }
  }
```

Anda dapat memasukkan parameter penalaran model dalam permintaan. Berikut ini adalah contoh dari satu prompt yang mengaktifkan penalaran model di. `additionalModelRequestFields`

```
{
    "basePromptTemplate": " ... ",
    "inferenceConfiguration": {
        "stopSequences": [
            "</answer>"
        ]
    },
    "parserMode": "DEFAULT",
    "promptCreationMode": "DEFAULT",
    "promptState": "DISABLED",
    "promptType": "ORCHESTRATION",
    "additionalModelRequestFields":
    "reasoning_config": {
        "type": "enabled",
        "budget_tokens": 1024
    }
}
```