Strands.AgentCore 0.1.2

Strands.AgentCore

Deploy any Strands.NET agent to Amazon Bedrock AgentCore Runtime with one line. Optionally use AgentCore managed services — Memory, Browser, and Code Interpreter — as tools your agent can invoke.

dotnet add package Strands.AgentCore

Your agent code is unchanged

using Strands.AgentCore.Hosting;
using Strands.AgentCore.Extensions;
using Strands.Extensions.DI;

var builder = WebApplication.CreateBuilder(args);

// ── Agent configuration — identical whether running locally or on AgentCore Runtime ──
builder.Services
    .AddBedrockModel("us-east-1")
    .AddAgentCoreBrowser()                  // optional managed browser
    .AddAgentCoreCodeInterpreter()          // optional managed code execution
    .AddAgentCoreSessionManager(            // optional managed session storage
        Environment.GetEnvironmentVariable("AGENTCORE_MEMORY_ID") ?? "")
    .AddStrandsAgent("You are a helpful assistant.");

// ── AgentCore hosting — one line makes this deployable to AgentCore Runtime ──
var app = builder.Build();
app.MapAgentCoreEndpoints();  // POST /invocations + GET /health
app.UseAgentCorePort(8080);   // AgentCore Runtime expects port 8080
app.Run();

Python equivalent: BedrockAgentCoreApp() + @app.entrypoint + app.run()

Test locally before deploying

dotnet run

# Non-streaming
curl -X POST http://localhost:8080/invocations \
  -H "Content-Type: application/json" \
  -d '{"prompt": "What is 42 multiplied by 1764?"}'

# Streaming
curl -X POST http://localhost:8080/invocations \
  -H "Content-Type: application/json" \
  -H "Accept: text/event-stream" \
  -d '{"prompt": "Explain quantum computing in 3 sentences"}'

# Health check (required by AgentCore Runtime)
curl http://localhost:8080/health

What this package provides

Additive and optional

This package adds zero changes to Strands.Core, Strands.Models.Bedrock, or any other package. An agent built with Strands.Core compiles and runs identically with or without Strands.AgentCore installed.

AgentCore Gateway

Connect your agent to tools hosted on an Amazon Bedrock AgentCore Gateway — a managed MCP endpoint that proxies external APIs and services with built-in auth.

// Direct usage
await using var gateway = await AgentCoreGatewayToolProvider.CreateAsync(
    gatewayUrl: new Uri("https://...gateway-url.../mcp"),
    auth: new AgentCoreGatewayAuth.Iam(region: "us-east-1"));

var tools = await gateway.ListToolsAsync();
var agent = new Agent(model, tools: tools);

Three auth modes match your gateway's inbound authorization setting:

new AgentCoreGatewayAuth.Iam(region: "us-east-1")      // IAM SigV4
new AgentCoreGatewayAuth.Bearer(accessToken: token)     // JWT / OIDC
new AgentCoreGatewayAuth.None()                         // network-isolated

With DI, AddAgentCoreGatewayTools() registers all gateway tools directly into the container:

builder.Services
    .AddBedrockModel("us-east-1")
    .AddAgentCoreGatewayTools(gatewayUrl, auth: new AgentCoreGatewayAuth.Iam("us-east-1"))
    .AddStrandsAgent();