AgentCore Gateway 시작하기

이 빠른 시작 안내서에서는 AgentCore CLI를 사용하여 게이트웨이를 설정하고 에이전트에 통합하는 방법을 알아봅니다. 보다 포괄적인 가이드와 예제는 Amazon Bedrock AgentCore Gateway GitHub 리포지토리를 참조하세요.

사전 조건

시작하기 전에 다음이 있는지 확인합니다.

1단계: 설정 및 설치

AgentCore CLI를 전역적으로 설치합니다.

npm install -g @aws/agentcore

에이전트와 게이트웨이를 사용하여 새 AgentCore 프로젝트를 생성합니다.

2단계: 게이트웨이 생성

AgentCore CLI를 사용하여 게이트웨이와 대상을 프로젝트에 추가합니다.

대신 JWT 기반 권한 부여를 사용하려면 OAuth 검색 URL--authorizer-type CUSTOM_JWT로를 지정합니다.

3단계: 설정 실행

프로젝트를 AWS다음에 배포합니다.

agentcore deploy

CLI는 AWS CDK 스택을 합성하고 게이트웨이, 대상 및 에이전트를 Amazon Bedrock AgentCore에 배포합니다. 이 작업은 약 2~3분이 걸립니다.

4단계: 에이전트와 함께 게이트웨이 사용

AgentCore CLI를 사용하여 게이트웨이 URL을 검색합니다.

agentcore status

라는 새 파일을 run_agent.py 생성하고 다음 코드를 삽입합니다. 먼저 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()

에이전트 실행

에이전트를 실행하고 도구와 상호 작용하여 게이트웨이를 테스트합니다.

python run_agent.py

이것이 바로 입니다! 에이전트가 시작되고 다음과 같은 질문을 할 수 있습니다.

빌드한 내용

이 시작하기 자습서를 통해 다음 리소스를 생성했습니다.

문제 해결

다음 표에는 몇 가지 가능한 문제와 해결 방법이 나와 있습니다.

빠른 검증

터미널에서 다음 명령을 실행하여 게이트웨이가 작동하는지 확인합니다.

# 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

정리

프로젝트에서 게이트웨이와 해당 대상을 제거하려면:

agentcore remove gateway --name TestGateway

모든 리소스를 제거하고 재배포하려면:

agentcore remove all
agentcore deploy

다음 단계