adk-go-bedrock

Requirements

• Go 1.25+ (aligned with google.golang.org/adk)
• AWS account with Bedrock model access in your chosen region
• Credentials via the default AWS chain (environment variables, shared config, IAM role, etc.)
• A region where Bedrock is available: AWS_REGION, or region in ~/.aws/config for your profile
• IAM permission to call inference, for example:
• bedrock:InvokeModel for Converse
• bedrock:InvokeModelWithResponseStream for ConverseStream (when ADK uses SSE streaming)

Install

go get github.com/craigh33/adk-go-bedrock

Replace the module path with your fork or published path if you rename the module in go.mod.

Usage

ctx := context.Background()
llm, err := bedrock.New(ctx, "us.anthropic.claude-3-5-sonnet-20241022-v2:0", &bedrock.Options{
    Region: os.Getenv("AWS_REGION"),
})
if err != nil {
    log.Fatal(err)
}

agent, err := llmagent.New(llmagent.Config{
    Name:  "assistant",
    Model: llm,
    Instruction: "You are helpful.",
})
// Wire agent into runner.New(...) as usual.

bedrock.New accepts a model ID or inference profile ARN as documented by AWS. LLMRequest.Model can override the model ID at runtime (e.g. from ADK callbacks).

The bedrock/mappers package holds genai ↔ Bedrock conversions (requests, responses, tools, usage). Import it if you need the same mappings outside the default bedrock package. It also exports MIMETypeFromExtension for inferring MIME types from a filename when building genai parts. The Bedrock Runtime API abstraction used by converse.go is exported from bedrock (RuntimeAPI, StreamReader, and NewRuntimeAPI).

Examples

These runnable programs show how to wire adk-go-bedrock into ADK agents: chat runners, tools, streaming, multimodal and document flows, guardrails, and provider-specific options. Each example has its own README.md and Makefile:

• examples/bedrock-a2a: A2A remote-agent example backed by Bedrock.
• examples/bedrock-chat: runner-based chat example.
• examples/bedrock-mcp: MCP support via ADK's mcptoolset with an in-memory MCP server (MCP support).
• examples/bedrock-tool-calling: tool-calling agent example with function declarations.
• examples/bedrock-function-tool: ADK functiontool with typed args/results and llmagent + runner (contrasts with hand-written genai.Tool in bedrock-tool-calling).
• examples/bedrock-image-gen: ADK runner with the imagegenerator tool—Nova Canvas image generation via Bedrock InvokeModel and artifact storage.
• examples/bedrock-video-gen: ADK runner with the videogenerator tool—Nova Reel text-to-video via Bedrock async invoke, S3 output, and optional MP4 download into artifacts.
• examples/bedrock-nova-grounding: Nova Web Grounding via tools/novagrounding; prints answers and bedrock_citations metadata (see Nova Web Grounding).
• examples/bedrock-stream: direct streaming example using GenerateContent(..., true).
• examples/bedrock-tool-variants: function declaration support plus early detection of non-function ADK tool variants that Bedrock does not currently support.
• examples/bedrock-multimodal: comprehensive image analysis, document processing, tool calling with rich media, and vision-based reasoning.
• examples/bedrock-prompt-cache: ModelOption / Bedrock prompt caching for fewer repeated tokens (see AWS prompt caching docs).
• examples/bedrock-document: CLI to debug document uploads (-dry-run mapper check, optional -combined / -stream).
• examples/bedrock-guardrails: safety assessments, content filtering, and guardrail metadata handling.
• examples/bedrock-system-instruction: system instructions for role definition, output formatting, and behavioral control.
• examples/bedrock-web-ui: ADK local web UI launcher.

All examples load AWS configuration with config.LoadDefaultConfig and require BEDROCK_MODEL_ID plus region configuration (AWS_REGION or profile region).

export BEDROCK_MODEL_ID=us.anthropic.claude-3-5-sonnet-20241022-v2:0
export AWS_REGION=us-east-1   # optional if your profile already defines region
make -C examples/bedrock-chat run

Run streaming example:

make -C examples/bedrock-stream run