Skip to content

Commit 58df09f

Browse files
committed
Update docs to rename cagent => docker agent
Signed-off-by: Guillaume Tardif <guillaume.tardif@gmail.com>
1 parent bae49a2 commit 58df09f

29 files changed

Lines changed: 185 additions & 181 deletions

content/get-started/workshop/10_what_next.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -35,9 +35,9 @@ ai-development:
3535
- title: MCP Toolkit
3636
description: Set up, manage, and run containerized MCP servers to power your AI agents.
3737
link: /ai/mcp-catalog-and-toolkit/toolkit/
38-
- title: Build AI agents with cagent
38+
- title: Build AI agents with Docker Agent
3939
description: Create teams of specialized AI agents that collaborate to solve complex problems.
40-
link: /ai/cagent/
40+
link: /ai/docker-agent/
4141
- title: Use AI models in Compose
4242
description: Define AI model dependencies in your Docker Compose applications.
4343
link: /compose/how-tos/model-runner/

content/guides/agentic-ai.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,7 @@ params:
1313
>
1414
> This guide uses the familiar Docker Compose workflow to orchestrate agentic AI
1515
> applications. For a smoother development experience, check out [Docker
16-
> cagent](../manuals/ai/cagent/_index.md), a purpose-built agent runtime that
16+
> Docker Agent](../manuals/ai/docker-agent/_index.md), a purpose-built agent runtime that
1717
> simplifies running and managing AI agents.
1818
1919
## Introduction
Lines changed: 13 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -1,48 +1,49 @@
11
---
2-
title: "Lab: Getting Started with cagent"
3-
linkTitle: "Lab: Getting Started with cagent"
2+
title: "Lab: Getting Started with Docker Agent"
3+
linkTitle: "Lab: Getting Started with Docker Agent"
44
description: |
5-
Build intelligent multi-agent teams with cagent and Docker in this hands-on
5+
Build intelligent multi-agent teams with Docker Agent and Docker in this hands-on
66
interactive lab.
77
summary: |
88
Hands-on lab: Create, share, and orchestrate intelligent AI agents using
9-
cagent, MCP Toolkit, and Docker.
10-
keywords: AI, Docker, cagent, agents, multi-agent, MCP Toolkit, lab, labspace
9+
Docker Agent, MCP Toolkit, and Docker.
10+
keywords: AI, Docker, docker agent, agents, multi-agent, MCP Toolkit, lab, labspace
1111
aliases:
1212
- /labs/docker-for-ai/cagent/
13+
- /guides/lab-cagent/
1314
params:
1415
tags: [ai, labs]
1516
time: 20 minutes
1617
resource_links:
17-
- title: cagent documentation
18+
- title: Docker Agent documentation
1819
url: https://github.com/docker/cagent
1920
- title: Docker MCP Toolkit
2021
url: https://docs.docker.com/ai/mcp-catalog-and-toolkit/toolkit/
2122
- title: Labspace repository
2223
url: https://github.com/ajeetraina/labspace-cagent
2324
---
2425

25-
This lab walks you through building intelligent agents with cagent. You'll learn beginner
26+
This lab walks you through building intelligent agents with Docker Agent. You'll learn beginner
2627
agent concepts, then build sophisticated multi-agent teams that handle complex
2728
real-world tasks. Learn how to create, share, and orchestrate AI agents with
2829
Docker.
2930

3031
## What you'll learn
3132

32-
- Create simple agents with cagent
33+
- Create simple agents with Docker Agent
3334
- Use built-in generic agentic tools for common tasks
3435
- Integrate MCP servers from the MCP Toolkit
3536
- Share agents using the Docker Registry
3637
- Build multi-agent systems for complex workflows
37-
- Use Docker Model Runner with cagent (preview)
38+
- Use Docker Model Runner with Docker Agent (preview)
3839

3940
## Modules
4041

4142
| # | Module | Description |
4243
|---|--------|-------------|
43-
| 1 | Introduction | Overview of cagent and intelligent agent concepts |
44-
| 2 | Getting Started | Create your first agent with cagent |
45-
| 3 | Using Built-in Tools | Leverage the generic agentic tools in cagent |
44+
| 1 | Introduction | Overview of Docker Agent and intelligent agent concepts |
45+
| 2 | Getting Started | Create your first agent with Docker Agent |
46+
| 3 | Using Built-in Tools | Leverage the generic agentic tools in Docker Agent |
4647
| 4 | Using MCP | Integrate MCP servers from the MCP Toolkit |
4748
| 5 | Sharing Agents | Package and share agents via Docker Registry |
4849
| 6 | Introduction to Sub-agents | Build multi-agent systems with sub-agent orchestration |

content/manuals/_index.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -32,10 +32,10 @@ params:
3232
description: Run containers programmatically in your preferred programming language.
3333
icon: /icons/Testcontainers.svg
3434
link: /testcontainers/
35-
- title: Cagent
35+
- title: Docker Agent
3636
description: The open-source multi-agent solution to assist you in your tasks.
3737
icon: /icons/cagent.svg
38-
link: /ai/cagent
38+
link: /ai/docker-agent
3939
ai:
4040
- title: Ask Gordon
4141
description: Streamline your workflow and get the most out of the Docker ecosystem with your personal AI assistant.
Lines changed: 17 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -1,27 +1,30 @@
11
---
2-
title: cagent
3-
description: cagent lets you build, orchestrate, and share AI agents that work together as a team.
2+
title: Docker Agent
3+
description: Docker Agent lets you build, orchestrate, and share AI agents that work together as a team.
44
weight: 60
5+
aliases:
6+
- /ai/cagent/
7+
- /manuals/ai/cagent/
58
params:
69
sidebar:
710
group: Open source
811
badge:
912
color: violet
1013
text: Experimental
11-
keywords: [ai, agent, cagent]
14+
keywords: [ai, agent, docker agent, cagent]
1215
---
1316

14-
{{< summary-bar feature_name="cagent" >}}
17+
{{< summary-bar feature_name="Docker Agent" >}}
1518

16-
[cagent](https://github.com/docker/cagent) is an open source tool for building
19+
[Docker Agent](https://github.com/docker/cagent) is an open source tool for building
1720
teams of specialized AI agents. Instead of prompting one generalist model, you
1821
define agents with specific roles and instructions that collaborate to solve
1922
problems. Run these agent teams from your terminal using any LLM provider.
2023

2124
## Why agent teams
2225

2326
One agent handling complex work means constant context-switching. Split the work
24-
across focused agents instead - each handles what it's best at. cagent manages
27+
across focused agents instead - each handles what it's best at. Docker Agent manages
2528
the coordination.
2629

2730
Here's a two-agent team that debugs problems:
@@ -58,15 +61,15 @@ its specialty.
5861

5962
## Installation
6063

61-
cagent is included in Docker Desktop 4.49 and later.
64+
Docker Agent is included in Docker Desktop 4.49 and later.
6265

6366
For Docker Engine users or custom installations:
6467

6568
- **Homebrew**: `brew install cagent`
6669
- **Winget**: `winget install Docker.Cagent`
6770
- **Pre-built binaries**: [GitHub
6871
releases](https://github.com/docker/cagent/releases)
69-
- **From source**: See the [cagent
72+
- **From source**: See the [Docker Agent
7073
repository](https://github.com/docker/cagent?tab=readme-ov-file#build-from-source)
7174

7275
## Get started
@@ -86,7 +89,7 @@ Try the bug analyzer team:
8689
3. Run your agent team:
8790

8891
```console
89-
$ cagent run debugger.yaml
92+
$ docker agent run debugger.yaml
9093
```
9194

9295
You'll see a prompt where you can describe bugs or paste error messages. The
@@ -138,8 +141,8 @@ Agent configurations are packaged as OCI artifacts. Push and pull them like
138141
container images:
139142

140143
```console
141-
$ cagent push ./debugger.yaml myusername/debugger
142-
$ cagent pull myusername/debugger
144+
$ docker agent push ./debugger.yaml myusername/debugger
145+
$ docker agent pull myusername/debugger
143146
```
144147

145148
Use Docker Hub or any OCI-compatible registry. Pushing creates the repository if
@@ -149,11 +152,11 @@ it doesn't exist yet.
149152

150153
- Follow the [tutorial](./tutorial.md) to build your first coding agent
151154
- Learn [best practices](./best-practices.md) for building effective agents
152-
- Integrate cagent with your [editor](./integrations/acp.md) or use agents as
155+
- Integrate Docker Agent with your [editor](./integrations/acp.md) or use agents as
153156
[tools in MCP clients](./integrations/mcp.md)
154-
- Browse example agent configurations in the [cagent
157+
- Browse example agent configurations in the [Docker Agent
155158
repository](https://github.com/docker/cagent/tree/main/examples)
156-
- Use `cagent new` to generate agent teams with AI <!-- TODO: link to some page
159+
- Use `docker agent new` to generate agent teams with AI <!-- TODO: link to some page
157160
where we explain this, probably a CLI reference? -->
158161
- Connect agents to external tools via the [Docker MCP
159162
Gateway](/manuals/ai/mcp-catalog-and-toolkit/mcp-gateway.md)

content/manuals/ai/cagent/best-practices.md renamed to content/manuals/ai/docker-agent/best-practices.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,11 +1,11 @@
11
---
22
title: Best practices
3-
description: Patterns and techniques for building effective cagent agents
4-
keywords: [cagent, best practices, patterns, agent design, optimization]
3+
description: Patterns and techniques for building effective Docker Agent agents
4+
keywords: [docker agent, best practices, patterns, agent design, optimization]
55
weight: 40
66
---
77

8-
Patterns you learn from building and running cagent agents. These aren't
8+
Patterns you learn from building and running Docker Agent agents. These aren't
99
features or configuration options - they're approaches that work well in
1010
practice.
1111

Lines changed: 9 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
title: Evals
33
description: Test your agents with saved conversations
4-
keywords: [cagent, evaluations, testing, evals]
4+
keywords: [docker agent, evaluations, testing, evals]
55
weight: 80
66
---
77

@@ -12,7 +12,7 @@ tell you if behavior changed, not whether it's right or wrong.
1212

1313
## What are evals
1414

15-
An eval is a saved conversation you can replay. When you run evals, cagent
15+
An eval is a saved conversation you can replay. When you run evals, Docker Agent
1616
replays the user messages and compares the new responses against the original
1717
saved conversation. High scores mean the agent behaved similarly; low scores
1818
mean behavior changed.
@@ -48,7 +48,7 @@ bad.
4848
Save a conversation from an interactive session:
4949

5050
```console
51-
$ cagent run ./agent.yaml
51+
$ docker agent run ./agent.yaml
5252
```
5353

5454
Have a conversation with your agent, then save it as an eval:
@@ -66,25 +66,25 @@ directory. You can organize eval files in subdirectories if needed.
6666
Run all evals in the default directory:
6767

6868
```console
69-
$ cagent eval ./agent.yaml
69+
$ docker agent eval ./agent.yaml
7070
```
7171

7272
Use a custom eval directory:
7373

7474
```console
75-
$ cagent eval ./agent.yaml ./my-evals
75+
$ docker agent eval ./agent.yaml ./my-evals
7676
```
7777

7878
Run evals against an agent from a registry:
7979

8080
```console
81-
$ cagent eval agentcatalog/myagent
81+
$ docker agent eval agentcatalog/myagent
8282
```
8383

8484
Example output:
8585

8686
```console
87-
$ cagent eval ./agent.yaml
87+
$ docker agent eval ./agent.yaml
8888
--- 0
8989
First message: tell me something interesting about kil
9090
Eval file: c7e556c5-dae5-4898-a38c-73cc8e0e6abe
@@ -96,7 +96,7 @@ Output tokens: 177
9696

9797
## Understanding results
9898

99-
For each eval, cagent shows:
99+
For each eval, Docker Agent shows:
100100

101101
- **First message** - The initial user message from the saved conversation
102102
- **Eval file** - The UUID of the eval file being run
@@ -156,7 +156,7 @@ see what shifted.
156156

157157
## What's next
158158

159-
- Check the [CLI reference](reference/cli.md#eval) for all `cagent eval`
159+
- Check the [CLI reference](reference/cli.md#eval) for all `docker agent eval`
160160
options
161161
- Learn [best practices](best-practices.md) for building effective agents
162162
- Review [example configurations](https://github.com/docker/cagent/tree/main/examples)

content/manuals/ai/cagent/images/cagent-acp-zed.avif renamed to content/manuals/ai/docker-agent/images/cagent-acp-zed.avif

File renamed without changes.

content/manuals/ai/cagent/integrations/_index.md renamed to content/manuals/ai/docker-agent/integrations/_index.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
title: Integrations
3-
description: Connect cagent agents to editors, MCP clients, and other agents
4-
keywords: [cagent, integration, acp, mcp, a2a, editor, protocol]
3+
description: Connect Docker Agent agents to editors, MCP clients, and other agents
4+
keywords: [docker agent, integration, acp, mcp, a2a, editor, protocol]
55
weight: 60
66
---
77

@@ -12,7 +12,7 @@ want to use them. Each integration type serves a specific purpose.
1212

1313
### ACP - Editor integration
1414

15-
Run cagent agents directly in your editor (Neovim, Zed). The agent sees your
15+
Run Docker Agent agents directly in your editor (Neovim, Zed). The agent sees your
1616
editor's file context and can read and modify files through the editor's
1717
interface. Use ACP when you want an AI coding assistant embedded in your
1818
editor.
@@ -21,7 +21,7 @@ See [ACP integration](./acp.md) for setup instructions.
2121

2222
### MCP - Tool integration
2323

24-
Expose cagent agents as tools in MCP clients like Claude Desktop or Claude
24+
Expose Docker Agent agents as tools in MCP clients like Claude Desktop or Claude
2525
Code. Your agents appear in the client's tool list, and the client can call
2626
them when needed. Use MCP when you want Claude Desktop (or another MCP client)
2727
to have access to your specialized agents.
@@ -30,7 +30,7 @@ See [MCP integration](./mcp.md) for setup instructions.
3030

3131
### A2A - Agent-to-agent communication
3232

33-
Run cagent agents as HTTP servers that other agents or systems can call using
33+
Run Docker Agent agents as HTTP servers that other agents or systems can call using
3434
the Agent-to-Agent protocol. Your agent becomes a service that other systems
3535
can discover and invoke over the network. Use A2A when you want to build
3636
multi-agent systems or expose your agent as an HTTP service.

content/manuals/ai/cagent/integrations/a2a.md renamed to content/manuals/ai/docker-agent/integrations/a2a.md

Lines changed: 9 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -1,12 +1,12 @@
11
---
22
title: A2A mode
33
linkTitle: A2A
4-
description: Expose cagent agents via the Agent-to-Agent protocol
5-
keywords: [cagent, a2a, agent-to-agent, multi-agent, protocol]
4+
description: Expose Docker Agent agents via the Agent-to-Agent protocol
5+
keywords: [docker agent, a2a, agent-to-agent, multi-agent, protocol]
66
weight: 40
77
---
88

9-
A2A mode runs your cagent agent as an HTTP server that other systems can call
9+
A2A mode runs your Docker Agent agent as an HTTP server that other systems can call
1010
using the Agent-to-Agent protocol. This lets you expose your agent as a service
1111
that other agents or applications can discover and invoke over the network.
1212

@@ -29,7 +29,7 @@ Before starting an A2A server, you need:
2929
Basic usage:
3030

3131
```console
32-
$ cagent a2a ./agent.yaml
32+
$ docker agent a2a ./agent.yaml
3333
```
3434

3535
Your agent is now accessible via HTTP. Other A2A systems can discover your
@@ -38,19 +38,19 @@ agent's capabilities and call it.
3838
Custom port:
3939

4040
```console
41-
$ cagent a2a ./agent.yaml --port 8080
41+
$ docker agent a2a ./agent.yaml --port 8080
4242
```
4343

4444
Specific agent in a team:
4545

4646
```console
47-
$ cagent a2a ./agent.yaml --agent engineer
47+
$ docker agent a2a ./agent.yaml --agent engineer
4848
```
4949

5050
From OCI registry:
5151

5252
```console
53-
$ cagent a2a agentcatalog/pirate --port 9000
53+
$ docker agent a2a agentcatalog/pirate --port 9000
5454
```
5555

5656
## HTTP endpoints
@@ -142,7 +142,7 @@ Here's a concrete scenario where A2A is useful. You have two agents:
142142
Run the specialist as an A2A server:
143143

144144
```console
145-
$ cagent a2a ./code-reviewer.yaml --port 8080
145+
$ docker agent a2a ./code-reviewer.yaml --port 8080
146146
Listening on 127.0.0.1:8080
147147
```
148148

@@ -198,7 +198,7 @@ agents:
198198

199199
## What's next
200200

201-
- Review the [CLI reference](../reference/cli.md#a2a) for all `cagent a2a`
201+
- Review the [CLI reference](../reference/cli.md#a2a) for all `docker agent a2a`
202202
options
203203
- Learn about [MCP mode](./mcp.md) to expose agents as tools in MCP clients
204204
- Learn about [ACP mode](./acp.md) for editor integration

0 commit comments

Comments
 (0)