View a markdown version of this page

Gunakan AgentCore gateway - Batu Dasar Amazon AgentCore

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

Gunakan AgentCore gateway

Setelah menyiapkan gateway Anda dengan target, Anda dapat mengonfigurasi aplikasi atau agen Anda untuk menggunakan gateway melalui Model Context Protocol (MCP). MCP menyediakan cara standar bagi agen untuk menemukan dan memanggil alat.

catatan

AgentCore Gateway mendukung versi MCP berikut: 2026-07-28, 2025-11-25, 2025-06-18, dan 2025-03-26.

Versi 2026-07-28 adalah revisi protokol stateless. Klien tidak melakukan initialize jabat tangan. Setiap permintaan membawa versi protokolnya di MCP-Protocol-Version header dan di _meta bidang (io.modelcontextprotocol/protocolVersion). Gateway menemukan kemampuan melaluiserver/discover. Versi 2025-11-25 dan sebelumnya terus menggunakan initialize jabat tangan.

Anda dapat menggunakan operasi MCP berikut dengan AgentCore gateway:

Operasi Deskripsi

tools/call

Memanggil alat tertentu dengan argumen yang disediakan

tools/list

Daftar semua alat yang tersedia yang disediakan oleh gateway

prompts/list

Daftar semua petunjuk yang tersedia yang disediakan oleh gateway

prompts/get

Mengambil template prompt tertentu, dirender dengan argumen yang disediakan

resources/list

Daftar semua sumber daya yang tersedia yang disediakan oleh gateway

resources/read

Membaca isi sumber daya tertentu dengan URI

resources/templates/daftar

Daftar semua templat sumber daya yang tersedia yang disediakan oleh gateway

elicitation/create

Meminta masukan tambahan dari klien selama panggilan alat (dimulai oleh server)

sampling/createMessage

Meminta penyelesaian LLM dari klien selama panggilan alat (dimulai oleh server)

notifications/progress

Melaporkan kemajuan pada panggilan alat yang berjalan lama (dimulai oleh server)

notifications/message

Mengirim pesan log dari server selama eksekusi alat (dimulai oleh server)

Pada versi2026-07-28, interaksi yang diprakarsai server (elicitation/createdansampling/createMessage) menggunakan pola permintaan multi pulang-pergi (MRTR):

  1. Server mengembalikan hasil sementara dengan diset resultType el keinput_required.

  2. Klien memberikan masukan yang diminta pada percobaan ulang permintaan asli.

Gateway mengirimkan notifikasi (notifications/progressdannotifications/message) hanya untuk permintaan yang mengikutinya. Pada versi 2025-11-25 dan sebelumnya, gateway mengirimkan interaksi ini sebagai pesan yang diprakarsai server pada aliran terbuka.

Topik berikut menjelaskan cara memanggil AgentCore gateway Anda:

Topik