Erste Schritte mit AgentCore Gateway

In dieser Schnellstartanleitung erfahren Sie, wie Sie ein Gateway einrichten und es mithilfe der AgentCore CLI in Ihre Agenten integrieren. Umfassendere Anleitungen und Beispiele finden Sie im Amazon Bedrock AgentCore GitHub Gateway-Repository.

Voraussetzungen

Bevor Sie beginnen, stellen Sie sicher, dass Sie über Folgendes verfügen:

Schritt 1: Einrichtung und Installation

Installieren Sie die AgentCore CLI global:

npm install -g @aws/agentcore

Erstellen Sie ein neues AgentCore Projekt mit einem Agenten und einem Gateway:

Schritt 2: Gateway erstellen

Fügen Sie Ihrem Projekt mithilfe der AgentCore CLI ein Gateway und ein Ziel hinzu:

Um stattdessen die JWT-based Autorisierung zu verwenden, geben Sie --authorizer-type CUSTOM_JWT mit Ihrer OAuth-Discovery-URL Folgendes an:

Schritt 3: Führen Sie das Setup aus

Stellen Sie Ihr Projekt bereit für AWS:

agentcore deploy

Die CLI synthetisiert einen AWS CDK-Stack und stellt Ihr Gateway, Ihre Ziele und Ihren Agenten auf Amazon Bedrock bereit. AgentCore Dies dauert etwa 2-3 Minuten.

Schritt 4: Verwenden Sie das Gateway mit einem Agenten

Rufen Sie Ihre Gateway-URL mit der AgentCore CLI ab:

agentcore status

Erstellen Sie eine neue Datei mit dem Namen run_agent.py und fügen Sie den folgenden Code ein. Installieren Sie zuerst die Python-Abhängigkeiten:

pip install strands-agents mcp

"""
Agent script to test the Gateway
Run this after setup: python run_agent.py
"""

from strands import Agent
from strands.models import BedrockModel
from strands.tools.mcp.mcp_client import MCPClient
from mcp.client.streamable_http import streamablehttp_client
import json
import sys

def create_streamable_http_transport(mcp_url: str):
    return streamablehttp_client(mcp_url)

def get_full_tools_list(client):
    """Get all tools with pagination support"""
    more_tools = True
    tools = []
    pagination_token = None
    while more_tools:
        tmp_tools = client.list_tools_sync(pagination_token=pagination_token)
        tools.extend(tmp_tools)
        if tmp_tools.pagination_token is None:
            more_tools = False
        else:
            more_tools = True
            pagination_token = tmp_tools.pagination_token
    return tools

def run_agent():
    # Get the gateway URL from agentcore status
    gateway_url = "<YOUR_GATEWAY_URL>"  # Replace with URL from 'agentcore status'

    # Model configuration - change if needed
    model_id = "anthropic.claude-3-7-sonnet-20250219-v1:0"

    print("Starting AgentCore Gateway Test Agent")
    print(f"Gateway URL: {gateway_url}")
    print(f"Model: {model_id}")
    print("-" * 60)

    # Setup Bedrock model
    bedrockmodel = BedrockModel(
        model_id=model_id,
        streaming=True,
    )

    # Setup MCP client (no auth token needed for NONE authorizer)
    mcp_client = MCPClient(lambda: create_streamable_http_transport(gateway_url))

    with mcp_client:
        # List available tools
        tools = get_full_tools_list(mcp_client)
        print(f"\nAvailable tools: {[tool.tool_name for tool in tools]}")
        print("-" * 60)

        # Create agent
        agent = Agent(model=bedrockmodel, tools=tools)

        # Interactive loop
        print("\nInteractive Agent Ready!")
        print("Try asking: 'What's the weather in Seattle?'")
        print("Type 'exit', 'quit', or 'bye' to end.\n")

        while True:
            user_input = input("You: ")
            if user_input.lower() in ["exit", "quit", "bye"]:
                print("Goodbye!")
                break

            print("\nThinking...\n")
            response = agent(user_input)
            print(f"\nAgent: {response.message.get('content', response)}\n")

if __name__ == "__main__":
    run_agent()

Führen Sie Ihren Agenten aus

Testen Sie Ihr Gateway, indem Sie den Agenten ausführen und mit den Tools interagieren.

python run_agent.py

Das ist es! Der Agent wird gestartet und Sie können Fragen stellen wie:

Was du gebaut hast

In diesem Tutorial für die ersten Schritte haben Sie die folgenden Ressourcen erstellt:

Fehlerbehebung

Die folgende Tabelle zeigt einige mögliche Probleme und deren Lösungen:

Schnelle Validierung

Führen Sie die folgenden Befehle in einem Terminal aus, um zu überprüfen, ob Ihr Gateway funktioniert.

# Check your Gateway is working
curl -X POST YOUR_GATEWAY_URL \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'

# Watch live logs
aws logs tail /aws/bedrock-agentcore/gateways/YOUR_GATEWAY_ID --follow

Bereinigen

Um das Gateway und seine Ziele aus Ihrem Projekt zu entfernen:

agentcore remove gateway --name TestGateway

So entfernen Sie alle Ressourcen und stellen sie erneut bereit:

agentcore remove all
agentcore deploy

Nächste Schritte