ContextQMD
Back to Copilotkit

CopilotKit + AWS AgentCore

examples/integrations/agentcore/README.md

1.57.03.4 KB
Original Source

CopilotKit + AWS AgentCore

Chat UI with generative charts, shared-state todo canvas, and inline tool rendering — deployed on AWS Bedrock AgentCore. Pick LangGraph or Strands.

Prerequisites

ToolVersion
AWS CLIconfigured (aws configure)
Node.js18+
Python3.8+
Dockerrunning

Deploy to AWS

  1. Create your config:

    bash
    cp config.yaml.example config.yaml
# Edit config.yaml — set stack_name_base and admin_user_email

  2. Deploy:

    bash
    ./deploy-langgraph.sh                    # LangGraph agent (infra + frontend)
./deploy-langgraph.sh --skip-frontend    # infra/agent only
./deploy-langgraph.sh --skip-backend     # frontend only
# or
./deploy-strands.sh                      # AWS Strands agent
./deploy-strands.sh --skip-frontend
./deploy-strands.sh --skip-backend

  3. Open the Amplify URL printed at the end. Sign in with your email.

Local Development

bash
cd docker
cp .env.example .env
# Fill in AWS creds — STACK_NAME, MEMORY_ID, and aws-exports.json are auto-resolved
./up.sh --build
  • Frontend → hot reloads on save (volume mount + Vite)
  • Agent → rebuild on changes: docker compose up --build agent
  • Browser → http://localhost:3000, auth redirects back to localhost

The full chain runs locally: browser:3000 → bridge:3001 → agent:8080. AWS is only used for Memory and Gateway (SSM/OAuth2).

See docs/LOCAL_DEVELOPMENT.md for full details.

What's inside

PieceWhat it does
frontend/Vite + React with CopilotKit chat, charts, todo canvas
agents/langgraph-single-agent/LangGraph agent with tools + shared todo state
agents/strands-single-agent/Strands agent with tools + shared todo state
infra-cdk/CDK: Cognito, AgentCore, CopilotKit Lambda bridge, Amplify
infra-terraform/Terraform equivalent — see infra-terraform/README.md
docker/Local dev via Docker Compose
docs/LOCAL_DEVELOPMENT.md, LOCAL_DOCKER_TESTING.md

Architecture

Browser → API Gateway → CopilotKit Lambda (Node.js, AG-UI bridge)
                              ↓
                        AgentCore Runtime
                              ↓
                    langgraph_agent.py / strands_agent.py
                              ↓ MCP (OAuth2 M2M)
                        AgentCore Gateway → Lambda tools

Auth: Cognito OIDC → Bearer token forwarded from browser through Lambda to AgentCore.

Tear down

bash
cd infra-cdk && npx cdk@latest destroy --all --output ../cdk.out-lg   # LangGraph stack
cd infra-cdk && npx cdk@latest destroy --all --output ../cdk.out-st   # Strands stack

Docs