Lektion 4 · GitLab Duo

AI Catalog & Customization

Von „GitLabs Agents nutzen" zu „eigene Agents bauen und Verhalten steuern".

Der eine Win dieser Lektion Du weisst, wo Agents & Flows wohnen (AI Catalog), wie du das Verhalten über AGENTS.md steuerst, und wie du Agents über MCP & Knowledge Graph erweiterst.

Der AI Catalog

Der AI Catalog ist der zentrale Ort, um Agents und Flows zu entdecken, zu erstellen und für Projekte zu aktivieren.¹ Hier entstehen Custom Agents für team-spezifische Workflows (Code-Review-Standards, Compliance-Checks, Deployment-Automatik …).

AGENTS.md — die Steuerdatei

AGENTS.md gibt Agents/Flows Kontext und Instruktionen — vergleichbar mit Custom-Instructions, die du aus anderen KI-Tools kennst.² Drei Geltungsebenen, die kombiniert werden:

Ebene	Ort	Gilt für
User	`~/.gitlab/duo/AGENTS.md` (Win: `%APPDATA%\GitLab\duo\AGENTS.md`)	alle deine Projekte
Projekt	`./AGENTS.md` im Repo-Root	dieses Projekt
Unterordner	`./frontend/AGENTS.md`, `./backend/AGENTS.md` …	Monorepo-Komponente

Beispielinhalt:

# Project-specific guidelines

- This project uses React with TypeScript
- Follow the component structure in /src/components
- Use our custom hooks from /src/hooks
- State management uses Redux Toolkit

Wichtiges Verhalten Beim Editieren in einem Unterordner liest Duo dessen AGENTS.md vor der Änderung. Aber: Nur neue Konversationen übernehmen geänderte Instruktionen — laufende nicht. Nach dem Anpassen also neue Konversation starten.²

Erweitern: MCP & Knowledge Graph

MCP (Model Context Protocol): bindet externe Tools/Datenquellen an, die Agents aufrufen dürfen (mit Freigabe-Modell aus Lektion 2).
Knowledge Graph: gibt Agents mehr strukturiertes Projektwissen für bessere Antworten.

Beides ergänzt AGENTS.md: Datei = Instruktionen, MCP = Werkzeuge, Knowledge Graph = Wissen.

Hands-on: ersten Custom Agent

AGENTS.md ins Repo-Root legen mit 3–4 euer-spezifischen Regeln (Stil, Struktur, Test-Befehl).
Neue Agentic-Chat-Konversation starten und eine Datei ändern lassen.
Beobachten, dass der Agent eure Konventionen befolgt (z. B. euren Test-Runner nennt).
Optional: im AI Catalog einen Custom Agent für einen wiederkehrenden Task definieren und für das Projekt aktivieren.

Selbsttest

Wo entdeckst und erstellst du Agents und Flows zentral?

Eine Änderung an AGENTS.md wirkt …

Wofür ist MCP in der Agent Platform da?

Workshop-Winkel Zeig denselben Auftrag mit und ohne AGENTS.md. Der Unterschied („jetzt hält er sich an unseren Stil!") macht greifbar, warum Customization der Hebel für echten Team-Nutzen ist — nicht die Gimmicks.

Primärquelle

📖 AGENTS.md customization files — GitLab Docs.

Quellen

Frag deinen Teacher-Agent: „Wie sieht eine gute AGENTS.md für unser Repo aus?" — bring dein echtes Projekt mit, dann bauen wir sie zusammen.

◀ Lektion 3 Glossar Lektion 5: Code Suggestions ▸