Uso Avanzado
Esta página cubre prácticas para operar Smart Engineering de forma eficiente después de que el flujo básico de repositorio y proceso ya funciona.
Retomar por el resumen
El resumen del repositorio en /repositories/:repositoryId es el mejor lugar para entender qué falta. Puede mostrar:
- Información general del repositorio y organización.
- Fechas de creación y de actualización, y el tipo de almacenamiento.
- Estado actual y la jornada del repositorio.
- El checklist de primeros pasos y la siguiente acción recomendada.
- Procesos recientes.
- Datos de preanálisis, estimaciones de costo de LLM y recomendaciones de modelo cuando estén disponibles.
- Mensajes de error cuando hay una falla.
Cuando no esté seguro de qué hacer a continuación, empiece por el resumen y siga la acción recomendada.
Use el command palette
Abra el command palette desde el header o con el atajo de teclado. Agrupa las acciones en Navegación, Agéntico, Personalizar, Modernización, Repositorio actual y Administración. Las acciones disponibles dependen del repositorio actual, las funcionalidades habilitadas y los permisos de la cuenta.
Tutorial contextual
Hay orientación contextual por pantalla en muchas pantallas. Aparece un recordatorio en la barra lateral cuando el tutorial del flujo actual aún no se ha abierto.
Grafo global
Abra el grafo global para usar las funciones de grafo fuera del workspace de un repositorio. Puede seleccionar un repositorio existente con código fuente disponible o subir un archivo .zip para generar un grafo.
Explorador de Costos
Administración → Explorador de Costos estima el costo de una ejecución de documentación antes de iniciarla, a partir de las mediciones de un repositorio o de una carga de trabajo manual. Consulte Explorador de Costos.
Claves de API
La pantalla de claves de API en /modernization/api-keys (Administración → Claves de API) da soporte a integraciones programáticas. Puede listar claves, crear una clave, copiarla en el momento de la creación, revocar una clave, eliminar una clave y actualizar la lista.
Copie la clave cuando se muestre. No se muestra de nuevo después de la creación.
Prácticas de modelo y costo
La salida generada depende de la selección de modelo y de las opciones de idioma. Use modelos más ligeros para enriquecimiento simple, indexación y documentación directa. Use modelos más potentes para análisis de arquitectura, diagramas y visiones abarcadoras. Los idiomas de salida distintos del inglés pueden agregar costo de traducción. Use el Explorador de Costos para comparar opciones antes.
Ajustes
Abra /settings para ajustar el modelo y el comportamiento de la app. El chat y la creación de procesos dependen de los modelos disponibles para la organización.
Consejos operativos
- Mantenga la organización activa visible y correcta antes de crear repositorios o procesos.
- Siga la secuencia natural: crear repositorio, indexar el código, confirmar el preanálisis, revisar las estadísticas, crear un proceso, supervisarlo, consumir la documentación.
- Use filtros cuando un repositorio tenga muchos procesos o archivos de documentación.
- Prefiera reiniciar procesos con error o cancelados antes que crear trabajo duplicado.
- Descargue los resultados exitosos cuando los artefactos deban compartirse fuera de la app.
Componentes de la experiencia
| Componente | Función |
|---|---|
| Barra lateral | Navegación por las rutas agéntico, repositorio, modernización y administración. |
| Header | Controles globales, selector de organización y acceso al command palette. |
| Command palette | Búsqueda y ejecución rápida de acciones globales o específicas del repositorio. |
| Pestañas del workspace del repositorio | Resumen, Indexación, Estadísticas, Código fuente, Procesos, Documentación, Grafo, Ajustes. |
| Breadcrumb | Ubicación dentro del flujo del repositorio. |
| Panel de Indexación | Conecta un repositorio Git o recibe una carga .zip, y muestra el historial de cargas. |
| Panel de Estadísticas | Muestra métricas, distribución por lenguaje, stack detectada y estimaciones de costo. |
| Cuadro de diálogo de confirmación del preanálisis | Revisa archivos, líneas, tokens y lenguajes antes de la indexación. |
| Tarjetas de repositorio | Representan los repositorios en el listado. |
| Tarjetas de proceso | Representan las ejecuciones de proceso y las acciones. |
| Logs de proceso | Muestran detalles recientes de la ejecución. |
| Visor de documentación | Renderiza Markdown, permite búsqueda y abre diagramas. |
| Canvas del grafo | Muestra relaciones de código, referencias y archivos relacionados. |
| Cuadros de diálogo de clave de API | Gestionan las claves de acceso programático. |
Componentes de feedback
La app usa estados de carga, estados vacíos, errores con reintento, alertas, cuadros de diálogo de confirmación e indicadores de operaciones más largas para mantener claras las acciones del usuario.
Principios de uso
- Confirme siempre la organización activa antes de crear o buscar repositorios.
- Siga la secuencia recomendada que muestra el estado del repositorio.
- Use el resumen para retomar el trabajo tras interrupciones.
- Use el command palette para una navegación rápida.
- Use filtros cuando haya muchos procesos o archivos de documentación.
- Revise el preanálisis y las estadísticas antes de crear procesos.
- Consulte los logs de proceso antes de reiniciar un trabajo con error.