Skip to content

aws/bedrock-agentcore-sdk-typescript

Bedrock AgentCore

Bedrock AgentCore SDK for TypeScript

Deploy AI agents to AWS with VM-level isolation and zero infrastructure

npm version TypeScript Node.js License

Documentation   |   Samples   |   Python SDK


Why AgentCore?

  • Zero infrastructure — No servers to provision, no containers to manage, no scaling to configure.
  • Session isolation — Each agent session runs in its own VM. No shared state, no noisy neighbors.
  • Long-lived sessions — Sessions persist across requests. Your agent maintains context without external storage.
  • Managed tools — Secure code execution and browser automation, ready to use.
  • Credential management — Centralized API keys and OAuth tokens, injected at runtime.

Works with Strands Agents, Vercel AI SDK, or any framework.


Quick Start

npm install bedrock-agentcore @strands-agents/sdk
import { BedrockAgentCoreApp } from 'bedrock-agentcore/runtime'
import { Agent, BedrockModel } from '@strands-agents/sdk'
import { z } from 'zod'

const agent = new Agent({
  model: new BedrockModel({ modelId: 'global.amazon.nova-2-lite-v1:0' }),
})

const app = new BedrockAgentCoreApp({
  invocationHandler: {
    requestSchema: z.object({ prompt: z.string() }),
    process: async function* (request) {
      for await (const event of agent.stream(request.prompt)) {
        if (event.type === 'modelContentBlockDeltaEvent' && event.delta?.type === 'textDelta') {
          yield { event: 'message', data: { text: event.delta.text } }
        }
      }
    },
  },
})

app.run()

BedrockAgentCoreApp creates an AgentCore Runtime-compliant server—handling request parsing, streaming responses, and session management for seamless deployment.


Tools

Give your agent secure code execution with three lines:

import { CodeInterpreterTools } from 'bedrock-agentcore/experimental/code-interpreter/strands'
import { Agent, BedrockModel } from '@strands-agents/sdk'

const codeInterpreter = new CodeInterpreterTools({ region: 'us-east-1' })

const agent = new Agent({
  model: new BedrockModel({ modelId: 'global.amazon.nova-2-lite-v1:0' }),
  tools: codeInterpreter.tools,
})

// Agent can now execute code in a secure sandboxed environment

Features

  • Runtime — Secure, session-isolated compute → Examples
  • Code Interpreter — Execute Python/JS/TS in a sandbox → Examples
  • Browser — Cloud-based web automation → Examples
  • Identity — Manage API keys and OAuth tokens → Examples
  • Memory — Persistent knowledge across sessions (coming soon)
  • Gateway — Transform APIs into MCP tools (coming soon)
  • Observability — OpenTelemetry tracing (coming soon)

Installation

npm install bedrock-agentcore

Prerequisites: Node.js 20+, AWS credentials, AgentCore access


Deployment


Resources


License

Apache 2.0 — see LICENSE

Contributing · Security

About

No description, website, or topics provided.

Resources

License

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Packages

No packages published

Contributors 8