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

agent

package

Go to main page

Versions in this module

v0

v0.5.1

Aug 28, 2026

v0.5.0

Aug 12, 2026

Changes in this version

+ const PermissionModeAutoApprove

+ const PermissionModeInteractive

+ const RuntimeTypeBuiltin

+ const TopologyKindCustom

+ const TopologyKindDeep

+ const TopologyKindLoop

+ const TopologyKindParallel

+ const TopologyKindPlanExecute

+ const TopologyKindSequential

+ const TopologyKindSingle

+ const TopologyKindSupervisor

+ var ErrAgentRouteTarget = fmt.Errorf("agent is targeted by an agent route")

+ func BuiltinFactoryRegistered(name string) bool

+ func RegisterBuiltinFactoryName(name string)

type ACPRuntime

+ AgentType string

+ AllowedRoots []string

+ CWD string

+ Codex *runtimeconfig.CodexConfig

+ ConfigOverrides map[string]string

+ DefaultModel string

+ Env map[string]string

+ IdleTTL time.Duration

+ MaxInstances int

+ PermissionMode string

+ type AgentRouteLookup interface

+ AgentRouteIDsForAgent func(ctx context.Context, agentID string) ([]string, error)

+ type BuiltinAgentsMD struct

+ Docs []BuiltinAgentsMDDoc

+ Enabled bool

+ MaxTotalBytes int

+ type BuiltinAgentsMDDoc struct

+ Content string

+ Path string

+ type BuiltinGeneration struct

+ MaxTokens int

+ Temperature *float32

+ TopP *float32

+ type BuiltinLimits struct

+ MaxConcurrentTurns int

+ TurnTimeoutSeconds int

+ type BuiltinMiddlewares struct

+ AgentsMD *BuiltinAgentsMD

+ PatchToolCalls *BuiltinPatchToolCalls

+ PlanTask *BuiltinPlanTask

+ Reduction *BuiltinReduction

+ Skill *BuiltinSkill

+ Summarization *BuiltinSummarization

+ ToolSearch *BuiltinToolSearch

+ type BuiltinModel struct

+ LLMRouteID string

+ Model string

+ Retry *BuiltinModelRetry

+ type BuiltinModelRetry struct

+ MaxRetries int

+ type BuiltinPatchToolCalls struct

+ Enabled bool

+ type BuiltinPermissions struct

+ AutoApproveTools []string

+ MaxPending int

+ Mode string

+ TimeoutSeconds int

+ func (p *BuiltinPermissions) Interactive() bool

+ type BuiltinPlanExecute struct

+ Executor *BuiltinPlanExecuteRole

+ Planner *BuiltinPlanExecuteRole

+ Replanner *BuiltinPlanExecuteRole

+ type BuiltinPlanExecuteRole struct

+ Generation *BuiltinGeneration

+ MaxIterations int

+ Model *BuiltinModel

+ Tools []BuiltinToolSelection

+ type BuiltinPlanTask struct

+ Enabled bool

+ type BuiltinReduction struct

+ ClearExcludeTools []string

+ ClearRetentionSuffixLimit int

+ Enabled bool

+ MaxTokensForClear int

+ type BuiltinRuntime struct

+ Generation *BuiltinGeneration

+ Limits *BuiltinLimits

+ Middlewares *BuiltinMiddlewares

+ Model BuiltinModel

+ Permissions *BuiltinPermissions

+ SystemPrompt string

+ Tools []BuiltinToolSelection

+ Topology BuiltinTopology

+ type BuiltinSkill struct

+ Enabled bool

+ Skills []BuiltinSkillDoc

+ type BuiltinSkillDoc struct

+ Content string

+ Description string

+ Name string

+ type BuiltinSubAgent struct

+ Description string

+ Generation *BuiltinGeneration

+ Model *BuiltinModel

+ Name string

+ SystemPrompt string

+ Tools []BuiltinToolSelection

+ Topology *BuiltinTopology

+ type BuiltinSummarization struct

+ Enabled bool

+ TriggerTokens int

+ type BuiltinToolSearch struct

+ Enabled bool

+ type BuiltinToolSelection struct

+ MCPServiceID string

+ Tools []string

+ type BuiltinTopology struct

+ Factory string

+ Kind string

+ MaxIterations int

+ PlanExecute *BuiltinPlanExecute

+ SubAgents []BuiltinSubAgent

+ type DefinitionCleanup func(context.Context)

+ type DefinitionCommit func() DefinitionCleanup

+ type DefinitionListener func(ctx context.Context, agents []Agent) DefinitionCommit

type Manager

+ func (m *Manager) AddDefinitionListener(listener DefinitionListener)

+ func (m *Manager) GetSnapshot(id string) (Agent, bool)

+ func (m *Manager) HasAgent(id string) bool

+ func (m *Manager) Recommit(ctx context.Context) error

+ func (m *Manager) Snapshot() []Agent

+ func (m *Manager) SnapshotGeneration() uint64

type Runtime

+ Builtin *BuiltinRuntime

v0.4.3

Jul 11, 2026

v0.4.2

Jul 5, 2026

v0.4.1

Jul 4, 2026

v0.4.0

Jun 21, 2026

Changes in this version

+ const RuntimeTypeACP

+ const RuntimeTypeHTTP

+ var ErrAgentNotConfigured = fmt.Errorf("agent is not configured")

+ func DecodeStoredAgentConfig(data []byte) (any, error)

+ type ACPRouteServiceLookup interface

+ ACPRouteServiceID func(ctx context.Context, routeID string) (string, error)

+ type ACPRuntime struct

+ ServiceID string

+ type Agent struct

+ CreatedAt time.Time

+ Description string

+ Disabled bool

+ ID string

+ Name string

+ OwnsService bool

+ Policy Policy

+ Resources Resources

+ Routes Routes

+ Runtime Runtime

+ UpdatedAt time.Time

+ func (a *Agent) Normalize()

+ func (a *Agent) NormalizeTimestamps(now time.Time)

+ func (a Agent) ACPServiceID() string

+ func (a Agent) Validate() error

+ type Budget struct

+ MaxTokensPerDay int

+ MaxTurnsPerDay int

+ type HTTPRuntime struct

+ AuthRef string

+ Endpoint string

+ type Manager struct

+ func NewManager(store configstore.ConfigStore) *Manager

+ func (m *Manager) Create(ctx context.Context, a Agent) error

+ func (m *Manager) Delete(ctx context.Context, id string) error

+ func (m *Manager) Get(ctx context.Context, id string) (Agent, error)

+ func (m *Manager) List(ctx context.Context) ([]Agent, error)

+ func (m *Manager) Refresh(ctx context.Context) error

+ func (m *Manager) ResolveAgentID(routeID, serviceID, sessionID string) (string, bool)

+ func (m *Manager) SetRouteLookup(lookup ACPRouteServiceLookup)

+ func (m *Manager) Update(ctx context.Context, id string, a Agent) error

+ type Policy struct

+ Budget *Budget

+ MaxAgentDepth int

+ type Resources struct

+ MCPServiceIDs []string

+ ProviderIDs []string

+ VirtualKeyIDs []string

+ type Routes struct

+ ACPRouteIDs []string

+ LLMRouteIDs []string

+ MCPRouteIDs []string

+ type Runtime struct

+ ACP *ACPRuntime

+ HTTP *HTTPRuntime

+ Type string