1
0
mirror of https://github.com/docker/docs.git synced 2026-10-25 06:09:46 +03:00
Files
docs/content/guides/lab-agentic-apps.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

2.0 KiB

title, linkTitle, description, summary, keywords, aliases, params
title linkTitle description summary keywords aliases params
Lab: Building Agentic Apps with Docker Lab: Building Agentic Apps Build agentic applications with Docker Model Runner, MCP Gateway, and Compose in this hands-on interactive lab. Hands-on lab: Build agentic apps with Docker Model Runner, MCP Gateway, and Compose. Learn about models, tools, and agentic frameworks. AI, Docker, Model Runner, MCP Gateway, agentic apps, lab, labspace
/labs/docker-for-ai/agentic-apps/
tags time
labs
20 minutes

Get up and running with building agentic applications using Compose, Docker Model Runner, and the Docker MCP Gateway. This hands-on lab takes you from understanding AI models to building complete agentic applications.

Launch the lab

{{< labspace-launch image="dockersamples/labspace-agentic-apps-with-docker" model-download="true" >}}

What you'll learn

This lab covers three core areas of agentic application development:

Models: What models are, how to interact with them, configuring Docker Model Runner in Compose, and writing code that connects to the Model Runner

Tools: Understanding tools and how they work, how MCP (Model Context Protocol) fits in, configuring the Docker MCP Gateway, and connecting to the MCP Gateway in code

Code: What agentic frameworks are, defining models and tools in a Compose file, and configuring your app to use those models and tools

Modules

# Module Description
1 Introduction Overview of agentic applications and the Docker AI stack
2 Understanding Model Interactions Learn how to interact with AI models
3 The Docker Model Runner Configure and use Docker Model Runner with Compose
4 Understanding Tools and MCP Deep dive into tools, tool calling, and MCP
5 The Docker MCP Gateway Set up and configure the MCP Gateway
6 Putting It All Together Build a complete agentic application
7 Conclusion Summary and next steps