1
0
mirror of https://github.com/docker/docs.git synced 2026-10-25 06:09:46 +03:00
Files
docs/content/guides/lab-docker-agent.md
David Karlsson f02e2a5633 Revamp the guides section: taxonomy, single-page structure, and new landing/filter UX (#25338)
## What

A full revamp of the `/guides` section — taxonomy, structure, and UX.

Preview: https://deploy-preview-25338--docsdocker.netlify.app/guides/

### Taxonomy & structure
- Replaces the sprawling 24-tag set with a focused 9-tag taxonomy
aligned to use case / SDLC: **Languages & frameworks, AI, Testing,
CI/CD, Security, Databases, Deployment, Admin, Hands-on labs**.
- Removes the languages taxonomy entirely (`data/languages.yaml` and all
`languages:` front matter).
- Collapses all multi-page guide series into single pages, with aliases
so old sub-page URLs continue to resolve.
- Deletes redirect-only shim pages and flattens directory-wrapped single
pages.

### Landing page (`/guides/`)
- A clean index: hero, then category sections listing each guide as a
plain **title / summary** row.
- **Browse rail** (sticky, left): click a topic to filter the page to
just that topic's guides; "All guides" resets. A count + Clear bar
appears while filtering.
- **Text filter**: instant client-side search over title, summary, and
tags. Topic filter and text search are mutually exclusive and share the
same flat-list view.
- No more "Featured guides" section.

### Guide content pages
- Removes the left sidebar for the guides section (mobile drawer kept).
- Centered reading column (`92ch`) with the TOC taking the remaining
width.
- Summary rendered as a lead paragraph under the h1.
- TOC scrollbar auto-hides until hover; breadcrumbs render at a
consistent size inside and outside `prose`.

## Notes
- Deep full-text search across guide bodies is still handled by the
existing site-wide Pagefind (⌘K); the landing filter is the fast
metadata-narrowing surface.
- `series.html` is retained — it's still used by `get-started` pages.

## Validation
- Site builds clean locally (Hugo dev server, no errors / broken refs).
- All collapsed sub-page URLs redirect via aliases.

## Follow-ups

- Prune guides that we no longer need/want
- Tighten the guides that span too many concepts (e.g. language guides;
remove cicd/deploy/sscs)

🤖 Generated with [Claude Code](https://claude.com/claude-code)

---------

Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-07-01 10:47:10 +02:00

1.7 KiB

title, linkTitle, description, summary, keywords, aliases, params
title linkTitle description summary keywords aliases params
Lab: Getting Started with Docker Agent Lab: Docker Agent Build intelligent multi-agent teams with Docker Agent and Docker in this hands-on interactive lab. Hands-on lab: Create, share, and orchestrate intelligent AI agents using Docker Agent, MCP Toolkit, and Docker. AI, Docker, docker agent, agents, multi-agent, MCP Toolkit, lab, labspace
/labs/docker-for-ai/cagent/
/guides/lab-cagent/
tags time
labs
20 minutes

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

Launch the lab

{{< labspace-launch image="dockersamples/labspace-cagent" >}}

What you'll learn

  • Create simple agents with Docker Agent
  • Use built-in generic agentic tools for common tasks
  • Integrate MCP servers from the MCP Toolkit
  • Share agents using the Docker Registry
  • Build multi-agent systems for complex workflows
  • Use Docker Model Runner with Docker Agent (preview)

Modules

# Module Description
1 Introduction Overview of Docker Agent and intelligent agent concepts
2 Getting Started Create your first agent with Docker Agent
3 Using Built-in Tools Leverage the generic agentic tools in Docker Agent
4 Using MCP Integrate MCP servers from the MCP Toolkit
5 Sharing Agents Package and share agents via Docker Registry
6 Introduction to Sub-agents Build multi-agent systems with sub-agent orchestration
7 Conclusion Summary and next steps