Skip to content

Add Amazon Bedrock AgentCore Runtime deployment example#21

Open
sundargthb wants to merge 2 commits intolivekit-examples:mainfrom
sundargthb:add-bedrock-agentcore-runtime-example
Open

Add Amazon Bedrock AgentCore Runtime deployment example#21
sundargthb wants to merge 2 commits intolivekit-examples:mainfrom
sundargthb:add-bedrock-agentcore-runtime-example

Conversation

@sundargthb
Copy link
Copy Markdown

Adds bedrock-agentcore/ with deployment configuration and example code for
running LiveKit agents on Amazon Bedrock AgentCore Runtime — a serverless
container hosting service with auto-scaling, session isolation, and
CloudWatch observability.

What's included

  • README.md — Full setup guide (VPC, TURN, build, deploy, test locally)
  • agent.py — Standard LiveKit voice agent with TURN configuration
  • kvs_turn.py — KVS Managed TURN helper (GetIceServerConfig API)
  • deploy.py — boto3 deployment script
  • Dockerfile — ARM64 container (required by AgentCore)
  • .env.example — Environment variable template
  • Architecture diagrams (simple + detailed)

Why this example includes agent-side code

Unlike aws-ecs/ or kubernetes/, this example includes agent.py and
kvs_turn.py in addition to deployment configuration. AgentCore runs
agents in microVMs inside a VPC behind a NAT Gateway, which requires
TURN server configuration for WebRTC NAT traversal — a requirement that
doesn't apply to ECS or Kubernetes where the agent has direct network
access. It also includes its own Dockerfile because AgentCore requires
linux/arm64 (the shared python-agent-example-app/Dockerfile targets
amd64).

TURN options

Two TURN configurations are supported:

  • KVS Managed TURN (recommended) — AWS-native, auto-rotating
    credentials via GetIceServerConfig API
  • Third-party TURN — Cloudflare, Twilio, or metered.ca via env vars

Validated

Tested with a pipeline-mode agent (Transcribe STT + Bedrock Nova Lite
LLM + Polly TTS) deployed to AgentCore Runtime in VPC mode, connecting
to LiveKit Cloud via both KVS TURN and Cloudflare TURN.

Related

  • GitHub issue requesting docs cross-links on /deploy/custom/deployments/
    and /agents/integrations/aws/

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant