Introduction

​

Your First Agent

llmClient, _ := openai.NewClient(
    llm.WithAPIKey(os.Getenv("OPENAI_API_KEY")),
    llm.WithModel("gpt-4o"),
)

a, _ := agent.NewAgent(
    agent.WithName("my-agent"),
    agent.WithSystemPrompt("You are a helpful assistant."),
    agent.WithLLMClient(llmClient),
)
defer a.Close()

agentRun, _ := a.Run(ctx, "What is the capital of France?", nil)
result, _ := agentRun.Get(ctx)
fmt.Println(result.Content) // Paris.

​

Install

go get github.com/agenticenv/agent-sdk-go@latest

​

Why Agent SDK for Go

• Idiomatic Go — functional options, typed interfaces, no reflection magic. Swap any component (LLM client, memory backend, approval policy) by passing a different option.
• Same code, three runtimes — run in-process for development with no infrastructure, then add temporal.WithTemporalConfig (from pkg/agent/runtime/temporal) or restate.WithRestateConfig (from pkg/agent/runtime/restate) for crash-proof durable execution in production. Nothing else changes.
• Concurrent by default — one Agent instance handles parallel Run and Stream calls; durable runtimes issue each a unique run automatically.
• Protocol-native integrations — MCP tool servers, A2A agent-to-agent delegation, and AG-UI streaming events are first-class, not adapters bolted on after the fact.
• Middleware hooks — intercept LLM calls, tool use, retrieval, and memory at any lifecycle point for logging, PII scrubbing, and guardrails without touching agent logic.
• Cache-aware requests — LLM requests are structured for provider caching, with Anthropic prompt-cache breakpoints to reduce cost on multi-turn runs.

​

Runtimes

​

Start here