Möchten Sie das nicht manuell einrichten? Fügen Sie einen Link zu dieser Seite in eine Devin-Sitzung ein und bitten Sie Devin, alles für Sie einzurichten. Ein*e Entwickler*in hat Devin gebeten, einem API-Endpunkt Paginierung hinzuzufügen. Der Prompt war kurz und klang vernünftig: ```txt Original prompt (vague) theme={null} Add pagination to GET /api/users. Run the tests when done. ``` Die Sitzung wurde erfolgreich abgeschlossen – die Tests wurden bestanden, der PR sah gut aus. Aber sie verbrauchte **42 ACUs** für eine Aufgabe, die **\~12 ACUs** hätte kosten sollen. Dreieinhalbmal so hohe Kosten wie erwartet, und das für ein Feature, das an anderer Stelle in der Codebasis bereits ein funktionierendes Muster hatte. So finden Sie heraus, was schiefgelaufen ist, und stellen sicher, dass es nicht wieder passiert. Jede abgeschlossene Session kann eine kostenlose [Session Insights](/de/product-guides/session-insights)-Analyse haben. Klicke auf das **Glühbirnensymbol** in der oberen Leiste einer beliebigen abgeschlossenen Session und dann auf **Generate Analysis**, um sie auszulösen – keine Advanced-Session erforderlich. Für diese Paginations-Session hat Session Insights Folgendes hervorgehoben: * **Issue Timeline** — Rote Markierungen bei Minute 14 und Minute 28, an denen Devin den Ansatz komplett geändert hat. * **Issues Detected** — „Falsche Annahme über Codebasis: Paginierung von Grund auf neu implementiert, obwohl `src/utils/paginate.ts` bereits existierte“ und „Falsche Implementierungsart: cursor-basierte Paginierung verwendet, aber Tests erwarten offset-basierte.“ * **Improved Prompt** — Eine neu formulierte Version mit dem zuvor fehlenden Kontext, bereit zum Kopieren. * **ACU Usage** — 42 ACUs, als unverhältnismäßig für den Umfang der Aufgabe markiert. Für viele Sessions ist das ausreichend. Kopiere den verbesserten Prompt, starte eine neue Session und vergleiche. Wenn du jedoch die vollständige, phasenbezogene Kostenaufschlüsselung möchtest, kannst du tiefer einsteigen. Klicken Sie im Panel **Session Insights** auf **Investigate with Devin**, um eine Devin-Sitzung zu starten, die mit der vollständigen Historie der ursprünglichen Sitzung vorgeladen ist. Oder starten Sie manuell eine neue Sitzung und beschreiben Sie, was analysiert werden soll: ```txt Analysiere die Pagination-Sitzung theme={null} Diese Sitzung hat 42 ACUs verbraucht, um Pagination zu GET /api/users hinzuzufügen. Ich hatte etwa 12 erwartet. Bitte analysiere: 1. Wo hat Devin ungewöhnlich viel Zeit verbracht? 2. Welche Sackgassen oder falschen Ansätze hat es verfolgt? 3. Was hätte es effizienter machen können? 4. Welcher Kontext hat in meinem Prompt gefehlt? 5. Gib mir einen überarbeiteten, strukturierten Prompt, der diese Probleme vermeidet. ``` Devin überprüft jede Aktion aus der ursprünglichen Sitzung und identifiziert, wo Zeit ineffizient aufgewendet wurde: ``` Sitzungsanalyse | Aufgabe: Paginierung zu GET /api/users hinzufügen Tatsächlich: 42 ACUs | Erwartet: ~12 ACUs Identifizierte Ineffizienzen: 1. Unnötige Erkundung — Untersuchungsphase dauerte ungewöhnlich lange Devin durchsuchte 23 Dateien auf der Suche nach einem Paginierungs-Helper. Die Paginierung wurde von Grund auf neu erstellt, dann wurde src/utils/paginate.ts entdeckt und alles musste refaktoriert werden. Lösung: Vorhandene Hilfsfunktionen im Prompt erwähnen. 2. Falscher Ansatz — gesamte Implementierung musste neu geschrieben werden Devin implementierte cursor-basierte Paginierung. Tests schlugen fehl, da die API offset-basierte Paginierung verwendet. Die gesamte Implementierung wurde von Grund auf neu geschrieben. Lösung: „offset-basiert" im Prompt angeben. 3. Umgebungsproblem — wiederholt fehlgeschlagene Installationen npm install schlug zweimal fehl aufgrund einer fehlenden .npmrc-Konfiguration für die private Registry. Devin versuchte es erneut mit Workarounds. Lösung: Registry-Konfiguration zum Repository-Setup hinzufügen. ``` Drei Hauptursachen, die sich alle mit einem besseren Prompt oder einer besseren Repo-Konfiguration vermeiden lassen. Sie können Devin bitten, direkt mit dem verbesserten Prompt eine neue Sitzung zu starten – ganz ohne Copy-&-Paste. Die Analyse erzeugt einen strukturierten Prompt, der genau den zuvor fehlenden Kontext enthält: ```txt Optimierter Prompt (strukturiert) theme={null} Füge eine offset-basierte Paginierung zu GET /api/users hinzu. ## Kontext - Verwende unsere bestehende Paginierungs-Hilfsfunktion unter src/utils/paginate.ts - Folge demselben Muster wie bei GET /api/projects (bereits paginiert) - Query-Parameter: page (Standard 1), limit (Standard 20, max. 100) - Antwortstruktur: { data: User[], meta: { page, limit, total, totalPages } } ## Implementierung 1. Füge die Query-Parameter page und limit mit Zod-Validierung hinzu 2. Verwende paginate() aus src/utils/paginate.ts, um die Prisma-Query zu kapseln 3. Gib die paginierte Antwort in der obigen Struktur zurück ## Tests - Führe die bestehenden Tests mit npm test aus - Überprüfe, dass die Paginierung mit 0 Ergebnissen, 1 Seite und mehreren Seiten funktioniert - Überprüfe, dass ungültige page/limit-Parameter 400 zurückgeben Öffne keinen PR, bevor alle Tests bestanden sind. ``` Vergleiche die beiden Prompts nebeneinander: | | Original | Optimiert | | --------------------- | --------------- | ----------------------- | | **Pagination type** | Nicht angegeben | "offset-basiert" | | **Existing utility** | Nicht erwähnt | `src/utils/paginate.ts` | | **Reference pattern** | Keines | "wie GET /api/projects" | | **Response shape** | Nicht angegeben | Explizites Schema | | **Testing criteria** | "Run the tests" | Konkrete Randfälle | | **ACU result** | 42 ACUs | \~12 ACUs | Der optimierte Prompt beseitigt alle drei Hauptursachen. Devin überspringt die Erkundung von 23 Dateien, wählt die richtige Paginierungsart gleich beim ersten Versuch und folgt einem bewährten Muster. Das einmalige Umschreiben eines Prompts spart ACUs in einer Sitzung. Wenn Sie die Erkenntnisse in eine dauerhafte Konfiguration überführen, sparen Sie ACUs in jeder zukünftigen Sitzung. **Fügen Sie wiederkehrenden Kontext zu [Knowledge](/de/product-guides/knowledge) hinzu.** Die Paginierungsanalyse hat zwei Fakten offengelegt, die Devin wiederholt benötigt – den Paginierungstyp und den Speicherort der Utility. Fügen Sie sie als Knowledge-Einträge hinzu, damit jede Sitzung automatisch mit diesem Kontext startet: * *"Alle API-Endpunkte verwenden offset-basierte Paginierung. Die gemeinsame Utility befindet sich unter `src/utils/paginate.ts`. Siehe GET /api/projects für die Referenzimplementierung."* * *"Führen Sie Tests mit `npm test` aus. Führen Sie Typprüfungen mit `npm run typecheck` aus."* **Beheben Sie Workspace-Probleme in der [Umgebungskonfiguration](/de/onboard-devin/environment).** Die 3 ACUs, die durch `npm install`-Fehler verschwendet wurden, wurden durch eine fehlende `.npmrc`-Konfiguration für die private Registry verursacht. Das Hinzufügen der Registry-Konfiguration zu Ihrer Umgebung verhindert, dass zukünftige Sitzungen auf diesen Fehler stoßen. **Führen Sie Batch-Analysen durch, um teamweite Muster zu finden.** Wenn mehrere Entwickler Sitzungen mit hohem ACU-Verbrauch haben, analysieren Sie mehrere auf einmal, um gemeinsame Ursachen zu finden: ```txt Batch-analyze recent sessions theme={null} Hier sind 5 Sitzungen aus dieser Woche: [paste session links] Finden Sie gemeinsame Muster von ACU-Verschwendung über alle diese Sitzungen hinweg. Welche Knowledge-Einträge sollte ich hinzufügen, um diese Probleme in jeder zukünftigen Sitzung zu verhindern? ```

{title}