Multiple Agents

The problem: You need more than one agent in the same process — different system prompts or roles. The solution: Create one NewAgent per role, each with its own distinct WithName.

cfg := &temporal.TemporalConfig{
    Host: "localhost", Port: 7233, Namespace: "default",
    TaskQueue: "my-app",
}

a1, _ := agent.NewAgent(
    agent.WithName("math-agent"),
    temporal.WithTemporalConfig(cfg),
    agent.WithLLMClient(llmClient),
)
defer a1.Close()

a2, _ := agent.NewAgent(
    agent.WithName("writing-agent"),
    temporal.WithTemporalConfig(cfg),
    agent.WithLLMClient(llmClient),
)
defer a2.Close()

Use the same options on NewAgent and NewAgentWorker for a given agent so client and worker pair correctly.

Restate

Same process: set a distinct Endpoint.ListenAddress per agent.

a1, _ := agent.NewAgent(
    agent.WithName("math-agent"),
    restate.WithRestateConfig(&restate.RestateConfig{
        Ingress: restate.IngressConfig{URL: "http://localhost:8080"},
        Endpoint: restate.EndpointConfig{
            ListenAddress: ":9081",
            AdminURL:      "http://localhost:9070",
        },
    }),
    agent.WithLLMClient(llmClient),
)
defer a1.Close()

a2, _ := agent.NewAgent(
    agent.WithName("writing-agent"),
    restate.WithRestateConfig(&restate.RestateConfig{
        Ingress: restate.IngressConfig{URL: "http://localhost:8080"},
        Endpoint: restate.EndpointConfig{
            ListenAddress: ":9082",
            AdminURL:      "http://localhost:9070",
        },
    }),
    agent.WithLLMClient(llmClient),
)
defer a2.Close()

See Restate runtime and the Multiple Agents example. Register specialists on the main agent with WithSubAgents. Sub-agent names must differ from the root agent name.

Same process, concurrent runs

Single agent, multiple requests

A single Agent instance handles concurrent Run and Stream calls from different goroutines. Each call gets its own unique Temporal workflow (or in-process goroutine) — no serialisation, no queuing.

var wg sync.WaitGroup
for _, prompt := range prompts {
    wg.Add(1)
    go func(p string) {
        defer wg.Done()
        agentRun, _ := a.Run(ctx, p, nil)
        result, _ := agentRun.Get(ctx)
        fmt.Println(result.Content)
    }(prompt)
}
wg.Wait()

Use this when one agent definition serves many parallel requests — a single Agent object is all you need. Example: Concurrent Runs.

Multiple agents, concurrent runs

var wg sync.WaitGroup
wg.Add(2)
go func() {
    defer wg.Done()
    agentRun, _ := a1.Run(ctx, "What is 7 times 8?", nil)
    result, _ := agentRun.Get(ctx)
    fmt.Println(result.Content)
}()
go func() {
    defer wg.Done()
    agentRun, _ := a2.Run(ctx, "Write a haiku about rain.", nil)
    result, _ := agentRun.Get(ctx)
    fmt.Println(result.Content)
}()
wg.Wait()

Example: Multiple Agents.

Shared vs separate resources

Resource	Per agent or shared
LLM client	Can share one client across agents — use `WithLLMSampling` for per-agent overrides
Temporal config	Can reuse the same `TemporalConfig` across agents
Restate in one process	Give each agent its own `ListenAddress`
Conversation store	Shared backend OK — isolate by conversation ID
Memory store	Shared backend OK — isolate by scope (user, tenant, agent name)
Tool registries	Per agent — each `Agent` has its own registries

Distributed execution with multiple agents

When splitting client and worker:

Create one NewAgentWorker per agent
Pass matching options to each worker and its corresponding NewAgent
Use Redis conversation when any agent uses remote workers

See Distributed Execution.

In-process runtime

Multiple in-process agents (no Temporal/Restate) are also supported — omit Temporal and Restate options on each NewAgent. Each agent runs its loop inside your Go process. Use this for development and single-process deployments. See In-Process runtime.

Examples

Concurrent Runs

Fan-out on a single Agent instance

Several agents in one process

Sub-agents

Orchestrator + specialist pattern

Distributed Execution

Client and worker pairing

Overview

Getting Started

Runtimes

Features

Advanced

Observability

Testing & Evaluation

Production

Reference Apps

Multiple Agents

Restate

Same process, concurrent runs

Single agent, multiple requests

Multiple agents, concurrent runs

Shared vs separate resources

Distributed execution with multiple agents

In-process runtime

Examples

Concurrent Runs

Multiple Agents

Sub-agents

Distributed Execution

​Restate

​Same process, concurrent runs

​Single agent, multiple requests

​Multiple agents, concurrent runs

​Shared vs separate resources

​Distributed execution with multiple agents

​In-process runtime

​Examples

Concurrent Runs

Multiple Agents

​Related

Sub-agents

Distributed Execution

Restate

Same process, concurrent runs

Single agent, multiple requests

Multiple agents, concurrent runs

Shared vs separate resources

Distributed execution with multiple agents

In-process runtime

Examples

Related