aws-agentcore

AWS Bedrock AgentCore

AWS インフラストラクチャ上で本番環境に対応した AI エージェントを構築します。

クイックスタート

import boto3
from agentcore import Agent, Tool

# Initialize AgentCore client
client = boto3.client('bedrock-agent-runtime')

# Define a tool
@Tool(name="search_database", description="Search the product database")
def search_database(query: str, limit: int = 10) -> dict:
    # Tool implementation
    return {"results": [...]}

# Create agent
agent = Agent(
    model_id="anthropic.claude-3-sonnet",
    tools=[search_database],
    instructions="You are a helpful product search assistant."
)

# Invoke agent
response = agent.invoke("Find laptops under $1000")

AgentCore のコンポーネント

AgentCore は、以下のプリミティブを提供します。

コンポーネント	目的
Runtime	サーバーレスのエージェント実行（フレームワークに依存しません）
Gateway	API／Lambda を MCP 互換のツールに変換
Memory	複数の戦略に対応したメモリ（セマンティック、ユーザー設定）
Identity	Cognito、Okta、Google、EntraID による認証
Tools	コードインタープリター、ブラウザツール
Observability	詳細な分析とトレース

Lambda ツールの統合

# Lambda function as tool
import json

def lambda_handler(event, context):
    action = event.get('actionGroup')
    function = event.get('function')
    parameters = event.get('parameters', [])
    
    # Parse parameters
    params = {p['name']: p['value'] for p in parameters}
    
    if function == 'get_weather':
        result = get_weather(params['city'])
    elif function == 'book_flight':
        result = book_flight(params['origin'], params['destination'])
    
    return {
        'response': {
            'actionGroup': action,
            'function': function,
            'functionResponse': {
                'responseBody': {
                    'TEXT': {'body': json.dumps(result)}
                }
            }
        }
    }

エージェントのオーケストレーション

from agentcore import SupervisorAgent, SubAgent

# Create specialized sub-agents
research_agent = SubAgent(
    name="researcher",
    model_id="anthropic.claude-3-sonnet",
    instructions="You research and gather information."
)

writer_agent = SubAgent(
    name="writer", 
    model_id="anthropic.claude-3-sonnet",
    instructions="You write clear, engaging content."
)

# Create supervisor
supervisor = SupervisorAgent(
    model_id="anthropic.claude-3-opus",
    sub_agents=[research_agent, writer_agent],
    routing_strategy="supervisor"  # or "intent_classification"
)

response = supervisor.invoke("Write a blog post about AI agents")

ガードレールの統合

from agentcore import Agent, Guardrail

# Define guardrail
guardrail = Guardrail(
    guardrail_id="my-guardrail-id",
    guardrail_version="1"
)

agent = Agent(
    model_id="anthropic.claude-3-sonnet",
    guardrails=[guardrail],
    tools=[...],
)

AgentCore Gateway

既存の API を MCP 互換のツールに変換します。

# gateway_setup.py
from bedrock_agentcore import GatewayClient

gateway = GatewayClient()

# Create gateway from OpenAPI spec
gateway.create_target(
    name="my-api",
    type="OPENAPI",
    openapi_spec_path="./api-spec.yaml"
)

# Create gateway from Lambda function
gateway.create_target(
    name="my-lambda-tool",
    type="LAMBDA",
    function_arn="arn:aws:lambda:us-east-1:123456789:function:my-tool"
)

AgentCore Memory

from agentcore import Agent, Memory

# Create memory with multiple strategies
memory = Memory(
    name="customer-support-memory",
    strategies=["semantic", "user_preference"]
)

agent = Agent(
    model_id="anthropic.claude-3-sonnet",
    memory=memory,
    tools=[...],
)

# Memory persists across sessions
response = agent.invoke(
    "What did we discuss last time?",
    session_id="user-123"
)

公式ユースケースリポジトリ

AWS は、本番環境に対応した実装を提供しています。

リポジトリ：https://github.com/awslabs/amazon-bedrock-agentcore-samples

利用可能なユースケース（02-use-cases/）

ユースケース	説明
A2A Multi-Agent Incident Response	Strands + OpenAI SDK を使用したエージェント間連携
Customer Support Assistant	メモリ、ナレッジベース、Google OAuth
Market Trends Agent	ブラウザツールを使用した LangGraph
DB Performance Analyzer	PostgreSQL の統合
Device Management Agent	Cognito 認証を使用した IoT
Enterprise Web Intelligence	調査用のブラウザツール
Text to Python IDE	AgentCore Code Interpreter
Video Games Sales Assistant	Amplify + CDK によるデプロイ

ユースケースを使ったクイックスタート

git clone https://github.com/awslabs/amazon-bedrock-agentcore-samples.git
cd amazon-bedrock-agentcore-samples/02-use-cases/customer-support-assistant
# Follow README for deployment

リソース

• 公式サンプル：https://github.com/awslabs/amazon-bedrock-agentcore-samples
• ユースケース：https://github.com/awslabs/amazon-bedrock-agentcore-samples/tree/main/02-use-cases
• チュートリアル：https://github.com/awslabs/amazon-bedrock-agentcore-samples/tree/main/01-tutorials