> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aihubmix.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Gute Aufgaben schreiben

> Praktische Tipps für Aufgaben an den Agent: Ziel und Abschlusskriterien nennen, Kontext liefern, große Aufgaben aufteilen, passende Berechtigungen wählen, wiederkehrende Arbeit automatisieren und den Agent einen PR öffnen lassen.

Wenn Ihre Aufgabe klar ist, macht der Agent weniger Umwege und hält seltener an, um nachzufragen. Die folgenden Tipps gelten für die meisten Sitzungen.

## Ziel, Umfang und Abschlusskriterien nennen

Sagen Sie dem Agent, was erreicht werden soll, wo Änderungen vorzunehmen sind und woran zu erkennen ist, dass die Arbeit erledigt ist. Vergleichen Sie:

* "Repariere die Anmeldeseite."
* "Behebe die falsch ausgerichteten Eingabefelder auf der Anmeldeseite in Safari. Ändere nur die Styles der Anmeldeseite und lass andere Seiten unverändert. Führe danach die vorhandenen Tests aus und füge einen Test hinzu, der Safari abdeckt."

Die zweite Version nennt das Ziel, die Grenzen und die Art der Überprüfung. Der Agent muss nicht raten und weiß, wann er aufhören und die Arbeit an Sie zurückgeben soll.

## Relevante Dateien und Links angeben

* **Wählen Sie zuerst das richtige Projekt**, damit der Agent im richtigen Code und in der richtigen Umgebung arbeitet.
* Nennen Sie in der Aufgabe die relevanten Dateien, Ordner, Fehlermeldungen oder Links zur Dokumentation.
* Hängen Sie bei UI-Problemen einen Screenshot an oder verwenden Sie **Take a screenshot** im Eingabefeld. Senden Sie Logs, Designdateien und ähnliches Material als Anhänge. Siehe [Sitzung starten](https://docs.aihubmix.com/de/cloud/sessions/start-a-session.md).
* Speichern Sie Secrets, die der Agent benötigen wird, vorab in den Secrets und Umgebungsvariablen des Projekts, damit er nicht anhalten und Sie danach fragen muss. Siehe [Projekte und Einrichtung der Umgebung](https://docs.aihubmix.com/de/cloud/environments/projects.md).

## Große Aufgaben aufteilen

Eine Sitzung funktioniert in der Regel am besten, wenn sie sich auf eine Sache konzentriert. Teilen Sie eine große Anfrage auf mehrere Sitzungen auf, lassen Sie den Agent zum Beispiel zuerst Optionen recherchieren und starten Sie dann die Umsetzung auf Grundlage seiner Ergebnisse.

* Wenn Teile einer Aufgabe unabhängig voneinander sind, geben Sie an, welche Teile parallel laufen können. Bei komplexen Aufgaben kann der Agent [Subagents](https://docs.aihubmix.com/de/cloud/sessions/subagents.md) starten, die gleichzeitig daran arbeiten, und die Ergebnisse automatisch zusammenführen, sobald alle fertig sind.
* Um einen anderen Ansatz auszuprobieren, zweigen Sie mit **Fork** von einer Antwort eine neue Sitzung ab. Die ursprüngliche Sitzung ist davon nicht betroffen.
* Wenn der Agent vom Kurs abkommt, müssen Sie nicht warten, bis er fertig ist. Korrigieren Sie ihn sofort mit **Steer**, oder bearbeiten Sie eine frühere Nachricht und führen Sie sie erneut aus. Siehe [Mit dem Agent arbeiten](https://docs.aihubmix.com/de/cloud/sessions/work-with-agent.md).

## Passende Berechtigungen wählen

Neue Sitzungen verwenden standardmäßig **Full access**, sodass der Agent Sie nicht bei jedem Schritt fragt. Das eignet sich für Aufgaben, die er auf dem Cloud-Server selbstständig erledigen soll. Sitzungen auf dem Cloud-Server berühren Ihren Computer nie.

Wechseln Sie in diesen Fällen zu **Ask for approval** oder **Approve for me**:

* Die Sitzung läuft auf Ihrem eigenen Computer und betrifft wichtige Dateien oder Systemeinstellungen.
* Das Projekt enthält Secrets, die der Agent nicht frei verwenden soll. Mit Full access kann der Agent alle Secrets des Projekts lesen.
* Die Aufgabe greift auf externe Dienste oder Websites zu, und Sie möchten bestätigen, bevor er handelt.

## Geplante Aufgaben für wiederkehrende Arbeit nutzen

Für Arbeit, die regelmäßig anfällt, etwa "Prüfe jeden Werktag um 9 Uhr auf Abhängigkeits-Updates", sagen Sie es dem Agent in natürlicher Sprache in einer Sitzung. Er erstellt den Entwurf einer geplanten Aufgabe, die erst wirksam wird, wenn Sie auf **Create** klicken. Für Nachfassaktionen, die an die aktuelle Sitzung gebunden sind, etwa "Prüfe das Deployment in 30 Minuten noch einmal", bitten Sie den Agent, einen Sitzungstimer zu stellen. Geplante Aufgaben laufen auf dem Cloud-Server und laufen weiter, wenn Ihr Computer ausgeschaltet ist. Siehe [Geplante Aufgaben](https://docs.aihubmix.com/de/cloud/automation/scheduled-tasks.md).

## Den Agent einen PR öffnen lassen

Wenn die Änderungen fertig sind, bitten Sie den Agent in der Sitzung, zu committen, zu pushen oder einen PR zu erstellen, zum Beispiel "Erstelle einen PR, sobald die Tests bestehen, mit einem Titel, der die Korrektur beschreibt." Das Standardverhalten ergibt sich aus dem Ship behavior in den Projekteinstellungen: einen PR erstellen, einen Branch pushen oder nach einem von Ihnen geschriebenen Prompt committen. Bei hochgeladenen Projekten ohne verknüpftes Remote-Repository werden Änderungen als Patch übergeben. Wie Sie Änderungen prüfen und Ergebnisse übergeben, lesen Sie unter [Ergebnisse prüfen und übergeben](https://docs.aihubmix.com/de/cloud/sessions/review-and-deliver.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.