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

Target AgentCore Runtime Amazon Bedrock

Anda dapat menambahkan agen Amazon Bedrock AgentCore Runtime sebagai target gateway. Gateway mengirimkan lalu lintas langsung ke agen runtime tanpa agregasi atau terjemahan protokol. Tidak seperti target MCP yang menggabungkan kemampuan alat menjadi server MCP virtual terpadu, target AgentCore Runtime meneruskan permintaan dan respons antara klien dan agen runtime tanpa modifikasi.

Menambahkan target AgentCore Runtime ke gateway Anda berguna ketika Anda ingin:

Pertimbangan dan batasan utama

Saat bekerja dengan target AgentCore Runtime, perhatikan pertimbangan berikut:

Konfigurasi target

Saat Anda membuat target AgentCore Runtime, Anda menyediakan ARN runtime dan kualifier opsional. Gateway menyelesaikan titik akhir runtime secara internal, jadi Anda tidak perlu membuat URL runtime sendiri.

Konfigurasi target untuk target AgentCore Runtime menggunakan struktur berikut:

{
    "http": {
        "agentcoreRuntime": {
            "arn": "arn:aws:bedrock-agentcore:us-west-2:111122223333:runtime/RUNTIME_ID",
            "qualifier": "DEFAULT",
            "schema": {
                "source": {
                    "s3": {
                        "uri": "s3://DOC-EXAMPLE-BUCKET/agent-schema.yaml"
                    }
                }
            }
        }
    }
}

Memanggil target AgentCore Runtime

Untuk memanggil target AgentCore Runtime melalui gateway, kirim permintaan POST ke URL pemanggilan target. Format URL adalah:

https://{gatewayId}.gateway.bedrock-agentcore.{region}.amazonaws.com/{targetName}/invocations

Ganti {gatewayId} dengan ID gateway Anda, {region} dengan Wil AWS ayah, dan {targetName} dengan nama target.

Contoh berikut menggunakan curl untuk memanggil target AgentCore Runtime:

curl -X POST https://gateway-id.gateway.bedrock-agentcore.us-west-2.amazonaws.com/my-target/invocations \
    -H "Content-Type: application/json" \
    -H "Authorization: Bearer <token>" \
    -d '{"input": {"prompt": "Hello"}}'

Anda juga dapat menggunakan Amazon Bedrock AgentCore SDK dengan penggantian URL titik akhir:

aws bedrock-agentcore invoke-agent-runtime \
    --endpoint-url https://gateway-id.gateway.bedrock-agentcore.us-west-2.amazonaws.com/my-target \
    --runtimeArn arn:aws:bedrock-agentcore:us-west-2:111122223333:runtime/RUNTIME_ID

Otorisasi keluar

AgentCore Target runtime mendukung jenis otorisasi keluar berikut:

Menegakkan lalu lintas melalui gateway

Anda dapat memajukan AgentCore Runtime Anda dengan AgentCore Gateway sehingga gateway menjadi titik masuk tunggal yang diatur ke runtime — memberi Anda otorisasi berbasis kebijakan, Amazon Bedrock Guardrails, pencegat permintaan dan respons, dan pengamatan terpadu, semuanya diterapkan di luar lingkungan agen itu sendiri. Untuk alasan lengkapnya, lihat Mengaw ali runtime Anda dengan AgentCore Gateway. Tetapi ini hanya berguna jika Anda tidak dapat melewati gateway dan mengakses runtime secara langsung. Anda sekarang dapat mencapai ini terlepas dari apakah runtime menggunakan otorisasi masuk IAM (SigV4) atau OAuth (JWT).

Anda mengkonfigurasi pembatasan ini pada runtime. Gateway mencap sumber dari setiap permintaan yang diteruskan, dan runtime memvalidasi sumber itu saat masuk. Mekanisme spesifik tergantung pada jenis otorisasi inbound runtime:

Perbandingan kemampuan dengan target MCP

Anda dapat mengintegrasikan server MCP dengan AgentCore gateway Amazon Bedrock menggunakan dua pendekatan: menggunakan tipe target MCP dalam mode agregasi, atau menggunakan tipe target AgentCore Runtime. Tabel berikut membandingkan kemampuan setiap pendekatan.