¿Prefieres no configurarlo manualmente? Pega un enlace a esta página en una sesión de Devin y pídele que lo configure todo por ti. Un desarrollador le pidió a Devin que añadiera paginación a un endpoint de la API. El prompt era breve y sonaba razonable: ```txt Prompt original (impreciso) theme={null} Add pagination to GET /api/users. Run the tests when done. ``` La sesión terminó correctamente: las pruebas pasaron y el PR se veía bien. Pero consumió **42 ACU** para lo que debería haber sido una tarea de **\~12 ACU**. Tres veces y media el costo esperado, en una funcionalidad que ya seguía un patrón funcionando en otras partes de la base de código. Aquí se explica cómo averiguar qué salió mal y asegurarse de que no vuelva a ocurrir. Cada sesión completada puede incluir un análisis gratuito de [Session Insights](/es/product-guides/session-insights). Haz clic en el **icono de bombilla** en la barra superior de cualquier sesión finalizada y luego en **Generate Analysis** para activarlo; no se requiere una sesión Advanced. Para esta sesión de paginación, Session Insights señaló: * **Issue Timeline** — Marcas rojas en los minutos 14 y 28, donde Devin cambió de enfoque por completo. * **Issues Detected** — "Suposición incorrecta sobre la codebase: implementó la paginación desde cero cuando `src/utils/paginate.ts` ya existía" y "Tipo de implementación incorrecto: usó paginación basada en cursor, pero las pruebas esperan paginación basada en desplazamiento (offset)". * **Improved Prompt** — Una versión reescrita con el contexto que faltaba añadido, lista para copiar. * **ACU Usage** — 42 ACUs, señalados como desproporcionados para el alcance de la tarea. Para muchas sesiones, esto es suficiente. Copia el prompt mejorado, inicia una sesión nueva y compáralo. Pero si quieres el desglose completo de costes fase por fase, profundiza más. Haz clic en **Investigate with Devin** en el panel Session Insights para iniciar una sesión de Devin precargada con el historial completo de la sesión original. O inicia manualmente una nueva sesión y describe qué quieres que se analice: ```txt Analizar la sesión de paginación theme={null} Esta sesión usó 42 ACU para añadir paginación a GET /api/users. Esperaba ~12. Desglosa: 1. ¿En qué partes Devin pasó un tiempo anormalmente largo? 2. ¿Qué callejones sin salida o enfoques equivocados intentó? 3. ¿Qué podría haber hecho de forma más eficiente? 4. ¿Qué contexto faltaba en mi prompt? 5. Dame un prompt revisado y estructurado que evite estos problemas. ``` Devin revisa cada acción de la sesión original e identifica en qué partes se dedicó tiempo de forma ineficiente: ``` Análisis de sesión | Tarea: Agregar paginación a GET /api/users Real: 42 ACUs | Esperado: ~12 ACUs Ineficiencias identificadas: 1. Exploración innecesaria — la fase de investigación llevó un tiempo anormalmente largo Devin exploró 23 archivos buscando un helper de paginación. Construyó la paginación desde cero y luego descubrió src/utils/paginate.ts, por lo que tuvo que refactorizar todo. Solución: Mencionar las utilidades existentes en el prompt. 2. Enfoque incorrecto — toda la implementación tuvo que reescribirse Devin implementó paginación basada en cursor. Las pruebas fallaron porque la API usa paginación basada en offset. Reescribió toda la implementación desde cero. Solución: Especificar "offset-based" en el prompt. 3. Problema de entorno — fallos repetidos en la instalación npm install falló dos veces por falta de configuración de .npmrc para el registro privado. Devin reintentó con soluciones alternativas. Solución: Agregar la configuración del registro a la configuración del repositorio. ``` Tres causas raíz, todas evitables con un mejor prompt o una mejor configuración del repositorio. Puedes pedirle a Devin que inicie una nueva sesión directamente con el prompt mejorado, sin tener que copiar y pegar. El análisis produce un prompt estructurado que incluye exactamente el contexto que faltaba: ```txt Optimized prompt (structured) theme={null} Add offset-based pagination to GET /api/users. ## Context - Use our existing pagination utility at src/utils/paginate.ts - Follow the same pattern as GET /api/projects (already paginated) - Query params: page (default 1), limit (default 20, max 100) - Response shape: { data: User[], meta: { page, limit, total, totalPages } } ## Implementation 1. Add page and limit query params with Zod validation 2. Use paginate() from src/utils/paginate.ts to wrap the Prisma query 3. Return the paginated response matching the shape above ## Testing - Run existing tests with npm test - Verify pagination works with 0 results, 1 page, and multiple pages - Verify invalid page/limit params return 400 No abras un PR hasta que todas las pruebas pasen. ``` Compara ambos prompts en paralelo: | | Original | Optimizado | | --------------------- | --------------- | --------------------------- | | **Pagination type** | No especificado | "offset-based" | | **Existing utility** | No mencionada | `src/utils/paginate.ts` | | **Reference pattern** | Ninguno | "same as GET /api/projects" | | **Response shape** | No especificada | Esquema explícito | | **Testing criteria** | "Run the tests" | Casos límite específicos | | **ACU result** | 42 ACUs | \~12 ACUs | El prompt optimizado elimina las tres causas raíz. Devin se salta la exploración de 23 archivos, elige el tipo de paginación correcto a la primera y sigue un patrón comprobado. Una única reescritura de un prompt ahorra ACUs en una sesión. Convertir los hallazgos en configuración permanente ahorra ACUs en todas las sesiones futuras. **Agrega contexto recurrente a [Knowledge](/es/product-guides/knowledge).** El análisis de paginación reveló dos datos que Devin necesita de forma recurrente: el tipo de paginación y la ubicación de la utilidad compartida. Agrégalos como entradas de Knowledge para que cada sesión comience automáticamente con ese contexto: * *"Todos los endpoints de la API usan paginación basada en offset. La utilidad compartida está en `src/utils/paginate.ts`. Consulta GET /api/projects para ver la implementación de referencia."* * *"Ejecuta las pruebas con `npm test`. Ejecuta las comprobaciones de tipos con `npm run typecheck`."* **Corrige problemas del espacio de trabajo en [configuración de Environment](/es/onboard-devin/environment).** Los 3 ACUs desperdiciados en fallos de `npm install` se debieron a la ausencia de una configuración `.npmrc` para el registro privado. Agregar la configuración del registro a tu environment evita que las sesiones futuras se encuentren con ese error. **Analiza por lotes para encontrar patrones a nivel de equipo.** Si varios desarrolladores están viendo sesiones con alta utilización de ACUs, analiza varias a la vez para encontrar causas raíz compartidas: ```txt Analizar por lotes sesiones recientes theme={null} Aquí tienes 5 sesiones de esta semana: [pega los enlaces de las sesiones] Encuentra patrones comunes de desperdicio de ACUs en todas ellas. ¿Qué entradas de Knowledge debería agregar para prevenir estos problemas en todas las sesiones futuras? ```

{title}