adk

ADK - Agent Development Kit

简体中文

A lightweight, idiomatic Go library for building AI agents. ADK keeps agent logic separate from LLM providers, tools, and session storage, so agents stay stateless while the runner manages the durable event ledger.

Early development notice: this project is under active development and APIs may change without notice.

Module path: github.com/soasurs/adk · Go version: 1.26+

Features

• Provider-neutral adapters for OpenAI, DeepSeek, Gemini, Vertex AI, and Anthropic
• Stateless agents with event-based, persistent conversation history
• Automatic tool-call loops and structured tool results
• Sequential, parallel, and agent-as-tool composition
• Native Go streaming with iter.Seq2
• Agent Skills parsing, discovery, catalog rendering, and on-demand loading
• In-memory, SQLite, and PostgreSQL session backends
• MCP tools and span-oriented slog/OpenTelemetry tracing

Installation

go get github.com/soasurs/adk

Quick Start

package main

import (
    "context"
    "fmt"
    "os"

    "github.com/soasurs/adk/agent/llmagent"
    "github.com/soasurs/adk/model"
    "github.com/soasurs/adk/model/openai"
    "github.com/soasurs/adk/runner"
    "github.com/soasurs/adk/session"
    "github.com/soasurs/adk/session/memory"
)

func main() {
    ctx := context.Background()
    llm := openai.New(os.Getenv("OPENAI_API_KEY"), os.Getenv("OPENAI_BASE_URL"), "gpt-4o-mini")
    assistant := llmagent.New(llmagent.Config{
        Name: "assistant", Model: llm, Instruction: "You are a helpful assistant.", Stream: true,
    })

    sessions := memory.NewMemorySessionService()
    _, _ = sessions.CreateSession(ctx, session.CreateSessionRequest{
        SessionID: "session-1", AppID: "quickstart", UserID: "user-1",
    })
    r, err := runner.New(assistant, sessions)
    if err != nil {
        panic(err)
    }

    for event, err := range r.Run(ctx, "session-1", model.Content{Content: "Hello!"}) {
        if err != nil {
            panic(err)
        }
        if event.Partial {
            fmt.Print(event.Content.Content)
            continue
        }
        fmt.Printf("\n%s: %s\n", event.Content.Role, event.Content.Content)
    }
}

See examples/chat for a runnable chat application.

Documentation

API documentation is available on pkg.go.dev.

Package Map

License

Apache 2.0