Geben Sie Ihrem Agent Projektkontext

Jede Sitzung beginnt Ihr Codierungs-Agent neu. Ohne eine ständige Quelle für Projektkonventionen werden dieselben Anweisungen wiederholt, und der Agent wich ab, wenn eine vergessen wird. Eine Kontextdatei löst dies: eine Datei, die der Agent zu Beginn einer Sitzung automatisch liest und die die Regeln und Konventionen enthält, die er jedes Mal befolgen sollte.

Warum eine Kontextdatei

Das erneute Eingeben Ihrer Konventionen in jeder Eingabeaufforderung ist langsam und leicht falsch zu verstehen. Eine Kontextdatei macht diese Anweisungen persistent und konsistent, sodass der Agent standardmäßig Ihrem Workflow-Stil folgt, anstatt zu raten.

AgentS.md, die allgemeine Konvention

AGENTS.md ist eine aufkommende produktübergreifende Konvention: eine Markdown-Datei im Stammverzeichnis Ihres Projekts, die Codierungsagents für Projektanweisungen lesen. Einige Agents suchen stattdessen nach ihrem eigenen Dateinamen, aber die Idee ist unabhängig vom genauen Namen dieselbe. In der eigenen Dokumentation des Agents sind der Dateiname und der Speicherort aufgeführt, den er erwartet.

Global und Projekt-Scope

Die meisten Agents unterstützen zwei Kontextebenen:

• Global enthält Ihre persönlichen Organisationseinstellungen, die auf jedes Projekt angewendet werden, z. B. Ihre standardmäßige UiPath-Organisation und Ihren bevorzugten Stil.
• Das Projekt enthält Konventionen, die für ein Projekt spezifisch sind und in der Kontextdatei des Projekts gespeichert werden, sodass sie mit dem Repository und den gesamten Teamvorteilen übernommen werden.

Organisationsweite Regeln gehören in den globalen Kontext; projektspezifische Regeln gehören in die Projektdatei.

Was darin enthalten sein soll

Eine nützliche Kontextdatei ist kurz und prägnant. Für die Arbeit mit UiPath gehören zu den nützlichen Inhalten:

• Die UiPath-Fähigkeiten für dieses Projekt, sodass der Agent nach der richtigen Fähigkeit greift (z. B. uipath-rpa für die Arbeit mit Robotic Process Automation (RPA) oder uipath-maestro-flow für die Prozessorchestrierung).
• Eine ständige Qualitätsregel, wie z. B. „Führen Sie immer die Workflow-Analyse aus und beheben Sie alle Probleme, bevor die erledigte Arbeit deklariert wird.“
• Bevorzugte und angeheftete Pakete und die Aktivitäten, die bevorzugt oder vermieden werden sollen (z. B. native Aktivitäten anstelle von „Invoke Code“).
• Projektkonventionen: Benennung, Struktur und die Muster, denen Ihr Team folgt.
• Explizite Beschränkungen, die der Agent respektieren muss, wie z. B. dass die aufgezeichneten UI-Workflows oder vorhandenen Konfigurationsdateien nicht überschrieben werden.

Ein kurzes AGENTS.md für ein UiPath-Projekt könnte folgendermaßen aussehen:

# Project conventions

- Use the `uipath-rpa` skill for automation work in this project.
- Always run the Workflow Analyzer (Analyze Project) and resolve every problem before calling work done.
- Prefer native activities over Invoke Code; keep UI activities inside a Use Application/Browser scope.
- Pin package versions in project.json; do not upgrade packages without asking.

RPA-spezifische Konventionen, die hier erfasst werden sollten, finden Sie unter RPA-Workflows.

Halten Sie es aktuell

Eine Kontextdatei ist nur so gut wie ihr Inhalt. Eine Datei, die veraltet ist, führt den Agent auf die gleiche Weise in die irre