View a markdown version of this page

Connect ke basis pengetahuan Anda melalui AgentCore Gateway - Amazon Bedrock
Memohon dengan Agen Strands

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

Connect ke basis pengetahuan Anda melalui AgentCore Gateway

AgentCore Gateway memungkinkan Anda mengekspos basis pengetahuan terkelola Amazon Bedrock sebagai alat menggunakan Model Context Protocol (MCP). Setelah Anda menambahkan target basis pengetahuan ke gateway, MCP-compatible klien mana pun dapat menanyakan basis pengetahuan sebagai alat MCP standar. Konektor memperlihatkan dua alat:

  • AgenticRetrieveStream— pengambilan agen streaming multi-langkah yang merencanakan, mengambil secara berulang, dan mengalirkan kembali hasil dan jawaban opsional yang disintesis dan didukung kutipan.

  • Retrieve— pencarian tunggal yang mengembalikan bagian yang paling relevan dengan referensi sumber.

Gateway bertindak sebagai perantara yang menangani otentikasi, injeksi parameter, dan subpengaturan skema. Sebagai administrator, Anda mengikat basis pengetahuan dan mengontrol parameter mana yang diekspos ke agen pemanggil dan yang disembunyikan dengan default yang telah dikonfigurasi sebelumnya.

catatan

Target gateway basis pengetahuan hanya didukung untuk basis pengetahuan terkelola, dan hanya dengan otentikasi IAM-based keluar (jenis penyedia GATEWAY_IAM_ROLE kredensi).

Prasyarat

  • Basis pengetahuan terkelola, dan ID basis pengetahuannya.

  • AgentCore Gateway dan peran layanan gateway dengan izin untuk mengambil dari basis pengetahuan (bedrock:Retrievepada basis pengetahuan ARN).

Untuk petunjuk selengkapnya — termasuk membuat target gateway dengan AWS SDK atau AWS CLI, mengonfigurasi peran layanan gateway dan kebijakan kepercayaan, mengontrol parameter pengambilan yang dapat disetel agen, menjalankan alat, dan skema input dan respons lengkap — lihat Pangkalan Pengetahuan Terkelola Amazon Bedrock sebagai Target Konektor di Panduan Pengembang Amazon Bedrock. AgentCore

Memohon dengan Agen Strands

Jika Anda memiliki agen yang sudah ada yang dibangun dengan Strands Agents SDK dan toolkit AgentCore starter, Anda dapat menghubungkannya ke target gateway basis pengetahuan Anda dengan mengalihkan klien MCP untuk menggunakan otentikasi SiGv4 terhadap titik akhir gateway.

Instal mcp-proxy-for-aws paket:

pip install mcp-proxy-for-aws

Kemudian perbarui klien MCP Anda untuk menunjuk ke URL gateway dengan otentikasi IAM:

from mcp_proxy_for_aws.client import aws_iam_streamablehttp_client
from strands.tools.mcp.mcp_client import MCPClient

GATEWAY_URL = "https://your-gateway-url/mcp"

def get_streamable_http_mcp_client() -> MCPClient:
    """Returns an MCP Client with SigV4 auth for AgentCore Gateway."""
    return MCPClient(lambda: aws_iam_streamablehttp_client(
        endpoint=GATEWAY_URL,
        aws_region="us-west-2",
        aws_service="bedrock-agentcore",
    ))

Perubahan utama dari pengaturan klien MCP standar adalah:

  • Ganti streamablehttp_client dari mcp paket dengan aws_iam_streamablehttp_client frommcp-proxy-for-aws.

  • Atur endpoint ke URL AgentCore Gateway Anda.

  • Tentukan aws_service="bedrock-agentcore" untuk penandatanganan SiGv4.

Setelah terhubung, alat basis pengetahuan ditemukan secara otomatis tools/list dan tersedia untuk agen tanpa konfigurasi tambahan.