Why Go
- Case Studies
  
  Common problems companies solve with Go
- Use Cases
  
  Stories about how and why companies use Go
- Security
  
  How Go can help keep you secure by default
Learn
Docs
- Effective Go
  
  Tips for writing clear, performant, and idiomatic Go code
- Go User Manual
  
  A complete introduction to building software with Go
- Standard library
  
  Reference documentation for Go's standard library
- Release Notes
  
  Learn what's new in each Go release
- API
  
  Reference documentation for the pkg.go.dev API
Packages
Community
- Recorded Talks
  
  Videos from prior events
- Meetups
  
  Meet other local Go developers
- Conferences
  
  Learn and network with Go developers from around the world
- Go blog
  
  The Go project's official blog.
- Go project
  
  Get help and stay informed from Go
- Get connected

agents

package module

Go to main page

Versions in this module

v0

v0.4.0

Jul 20, 2026

Changes in this version

type Harness

+ StepLimitMessage string

type Runner

+ func (r Runner) Advance(ctx context.Context, conv *Conversation) (string, error)

v0.3.0

Jul 20, 2026

v0.2.0

Jul 20, 2026

Changes in this version

type Message

+ Meta map[string]any

v0.1.0

Jul 19, 2026

Changes in this version

+ const RoleAssistant

+ const RoleSystem

+ const RoleTool

+ const RoleUser

+ var ErrAwaitingApproval = errors.New("agents: awaiting tool approval")

+ type Conversation struct

+ Messages []Message

+ func NewConversation(systemPrompt string) *Conversation

+ type Engine interface

+ Complete func(ctx context.Context, req Request) (*Response, error)

+ type Harness struct

+ MaxSteps int

+ Model string

+ Name string

+ SystemPrompt string

+ Tools *Registry

+ type Message struct

+ Content string

+ Name string

+ Role string

+ ToolCallID string

+ ToolCalls []ToolCall

+ type Registry struct

+ func NewRegistry(tools ...Tool) *Registry

+ func (r *Registry) Get(name string) (Tool, bool)

+ func (r *Registry) Register(t Tool)

+ func (r *Registry) Schemas() []ToolSchema

+ type Request struct

+ MaxTokens int

+ Messages []Message

+ Model string

+ Temperature float64

+ Tools []ToolSchema

+ type Response struct

+ Content string

+ Model string

+ ToolCalls []ToolCall

+ Usage Usage

+ type Runner struct

+ Approve func(ctx context.Context, calls []ToolCall) (bool, error)

+ Authorize func(ctx context.Context, tool Tool, call ToolCall) error

+ Engine Engine

+ Harness Harness

+ func (r Runner) Resume(ctx context.Context, conv *Conversation) (string, error)

+ func (r Runner) Turn(ctx context.Context, conv *Conversation, userMessage string) (string, error)

+ type Tool struct

+ Description string

+ Handler func(ctx context.Context, args json.RawMessage) (string, error)

+ Mutates bool

+ Name string

+ Parameters map[string]any

+ type ToolCall struct

+ Arguments string

+ ID string

+ Name string

+ type ToolSchema struct

+ Description string

+ Name string

+ Parameters map[string]any

+ type Usage struct

+ CompletionTokens int

+ PromptTokens int