Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Démarrez avec AgentCore Gateway

Dans ce guide de démarrage rapide, vous allez apprendre à configurer une passerelle et à l'intégrer à vos agents à l'aide de l' AgentCore interface de ligne de commande. Pour des guides et des exemples plus complets, consultez le GitHub référentiel https://github.com/awslabs/amazon-bedrock-agentcore-samples/tree/main/01-features/07-centralize-and-govern-your-ai-infrastructure/01-gateway Amazon Bedrock AgentCore Gateway.

Conditions préalables

Avant de commencer, assurez-vous de disposer des éléments suivants :

Étape 1 : Configuration et installation

Installez la AgentCore CLI dans le monde entier :

npm install -g @aws/agentcore

Créez un nouveau AgentCore projet avec un agent et une passerelle :

Étape 2 : Création d'une passerelle

Ajoutez une passerelle et une cible à votre projet à l'aide de la AgentCore CLI :

Pour utiliser l' JWT-based autorisation à la place, spécifiez à l'--authorizer-type CUSTOM_JWTaide de votre URL de découverte OAuth :

Étape 3 : Exécutez la configuration

Déployez votre projet pour AWS :

agentcore deploy

La CLI synthétise une pile AWS CDK et déploie votre passerelle, vos cibles et votre agent sur Amazon Bedrock. AgentCore Cela prend environ 2 à 3 minutes.

Étape 4 : Utiliser la passerelle avec un agent

Récupérez l'URL de votre passerelle à l'aide de la AgentCore CLI :

agentcore status

Créez un nouveau fichier appelé run_agent.py et insérez le code suivant. Installez d'abord les dépendances Python :

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()

Gérez votre agent

Testez votre passerelle en exécutant l'agent et en interagissant avec les outils.

python run_agent.py

C'est ça ! L'agent va commencer et vous pouvez lui poser des questions telles que :

Ce que tu as construit

Grâce à ce didacticiel de démarrage, vous avez créé les ressources suivantes :

Résolution des problèmes

Le tableau suivant présente certains problèmes possibles et leurs solutions :

Validation rapide

Exécutez les commandes suivantes dans un terminal pour vérifier que votre passerelle fonctionne.

# 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

Nettoyage

Pour supprimer la passerelle et ses cibles de votre projet :

agentcore remove gateway --name TestGateway

Pour supprimer toutes les ressources et les redéployer :

agentcore remove all
agentcore deploy

Étapes suivantes