La codificación vibe está ganando popularidad entre las organizaciones empresariales, lo que hace que sea crucial establecer estándares y flujos de trabajo para escalarla de manera sostenible. Una parte fundamental de esta base son los registros rápidos, los cuales documentan la creación del código generado por IA. Estos registros facilitan las auditorías, el mantenimiento y la transferencia de conocimientos.
La codificación de Vibe utiliza indicaciones en lenguaje natural para generar código. Mantener un registro de avisos permite capturar la intención, las decisiones y el proceso detrás del resultado.
A continuación se presentan ideas para crear un registro de avisos, que pueden adaptarse según las necesidades de cada organización. Es recomendable comenzar con una plantilla sencilla. La tabla a continuación describe los campos principales que se deben incluir en un registro de avisos.
| Categoría | Nombre del campo | Descripción y finalidad de la auditoría. | Valor de ejemplo |
| Identidad | ID de registro/marca de tiempo | ID de entrada único y hora universal coordinada (UTC) para trazabilidad cronológica | PL-992 / 2024-05-20 14:00Z |
| ID de desarrollador | El ser humano responsable del aviso y su resultado. | dev_jsmith_01 |
|
| Referencia del billete | Vincula el trabajo de la IA con un requisito empresarial | PROJ-104 |
|
| Técnico | Modelo inicial y versión. | El criterio de valoración específico utilizado (esencial para la reproducibilidad) para comenzar a refinar el mensaje | geminis-1.5-pro-002 |
| Modelo y versión | El criterio de valoración específico utilizado (esencial para la reproducibilidad) para la ejecución final | CDP_version23 |
|
| Semilla | El ADN determinista de la generación | 4294967295 |
|
| Hiperparámetros | Valores como temperatura, Top-P y Top-K | Temp: 0.7, Top-P: 0.9 |
|
| ID de aviso del sistema | Versión de la persona o guardrails aplicada al modelo | sys_v4.2_standard_dev |
|
| Contenido | Solicitud de entrada | El texto sin formato exacto enviado a la IA después de la depuración de prevención de pérdida de datos (DLP) | "Update API to include CDP identifier field..." |
| Bucle de refinamiento | Cualquier mensaje de seguimiento correctivo utilizado para arreglar la vibra. | "Too verbose, use arrow functions." |
|
| Enlace de salida | Enlace a la confirmación o solicitud de extracción (PR) específica generada por este mensaje | [github.com/repo/pull/12](https://github.com/repo/pull/12) |
|
| Cumplimiento | estado de DLP | Confirmación de que no se incluyó información de identificación personal (PII) ni información de salud protegida (PHI) en el mensaje | PASSED |
| Escaneo de seguridad | Estado de las pruebas de vulnerabilidad automatizadas en el código AI | Snyk: 0 Critical, 0 High |
|
| atribución de propiedad intelectual | Registros si la IA citó fuentes o documentos con licencia específicos | MIT License (suggested) |
|
| Validación | Revisor humano | El par o líder que verificó manualmente el resultado de la IA. | lead_dev_ananya |
| Cobertura de prueba | Porcentaje de pruebas unitarias aprobadas por el código generado | 94% Coverage |
Qué incluir en cada sección del registro
Sección de identidad
La sección de identidad distingue indicaciones individuales. Registra sus iteraciones, la persona que proporcionó el mensaje y las tareas para cada mensaje.
- ID de registro y marca de tiempo: Designa un identificador para cada mensaje e iteración del mensaje, y captura el tiempo de ejecución de cada uno.
- ID de desarrollador: Identifica y asigna responsabilidad a la persona que ejecutó el aviso.
- Referencia del billete: Vincula el mensaje a una tarea específica (por ejemplo, un número de ticket de JIRA o Workfront), revelando los requisitos comerciales.
Sección técnica
La sección técnica proporciona información sobre la plataforma de IA y los parámetros y condiciones de cada mensaje.
- Modelo y versión inicial: Registrar la plataforma de IA y el modelo asociado con cada mensaje es fundamental para reproducir los resultados. Este campo también ayuda a refinar las indicaciones, ya que cada plataforma y modelo de IA funciona de manera diferente. Utilice este campo para escenarios en los que refine las solicitudes en un sistema diferente de aquel en el que las ejecuta. Esta práctica sigue siendo eficiente. Por ejemplo, puede costar menos refinar un mensaje en un modelo de lenguaje grande (LLM) como Claude o Gemini antes de usarlo en una herramienta martech, como una plataforma de datos de clientes (CDP).
- Modelo y versión: Este campo registra el modelo y la versión del sistema de IA en el que finalmente ejecuta el mensaje. Esta información es especialmente útil si primero refina el mensaje en otro sistema.
- Semilla: Al responder a indicaciones y generar resultados, las plataformas de IA suelen implicar cierta aleatoriedad. Por ejemplo, dos personas que utilicen exactamente el mismo mensaje en exactamente la misma plataforma y modelo obtendrán resultados relacionados pero únicos. Las plataformas de inteligencia artificial rastrean estas iteraciones a través de valores iniciales. Si desea producir el mismo resultado desde un mensaje, el valor inicial aclara las variables en el proceso de generación.
- Hiperparámetros: Estos incluyen elementos de aviso como temperatura, Top-P y Top-K. Regulan cuánto ajuste permite el modelo de IA durante la generación de resultados. Al igual que la semilla, codificar hiperparámetros es esencial para la replicación.
- ID del mensaje del sistema: El ID del mensaje del sistema es un valor que la plataforma de IA asigna al mensaje.
- Mensaje de entrada: Este es el texto exacto del mensaje.
10 veces tu SEO con Semrush para empresas.
La plataforma SEO más poderosa del mundo, diseñada específicamente para empresas.
Solicitar demostración
Descubre la importancia de mantener un registro detallado en el desarrollo de software
¿Sabías que una de las partes más críticas del registro en el desarrollo de software es el seguimiento detallado de cada paso realizado? Mantener un registro adecuado puede marcar la diferencia entre un proyecto exitoso y uno lleno de obstáculos. A continuación, te explicamos por qué es fundamental tener un registro preciso en cada etapa del proceso.
Beneficios de mantener un registro detallado
- Bucle de refinamiento: Este bucle te permite ajustar la salida de manera eficiente para cumplir con los requisitos del proyecto.
- Enlace de salida: Almacenar el resultado final en un enlace de GitHub u otra plataforma es fundamental para mantener la trazabilidad del trabajo realizado.
Importancia del cumplimiento y validación
En el desarrollo de software, el cumplimiento y la validación son aspectos clave que no pueden pasarse por alto. Es fundamental:
- Estado del DLP: Garantizar la seguridad y transmisión adecuada para cumplir con las normativas vigentes.
- Escaneo de seguridad: Conservar los resultados del análisis de seguridad para garantizar la calidad del código antes de su implementación.
- Atribución de propiedad intelectual: Capturar las fuentes citadas por el modelo al generar el código para garantizar la integridad del trabajo.
Razones para mantener un registro detallado
Además de aumentar la productividad y eficiencia en el desarrollo de software, mantener un registro detallado ofrece otros beneficios:
Cumplir con estándares de software:
Los registros detallados son fundamentales para cumplir con los estándares y marcos de auditoría en el desarrollo de software.
Proporcionar documentación para usuarios finales:
Los registros son una herramienta útil para respaldar el mantenimiento del software y demostrar el cumplimiento de expectativas a los usuarios finales.
Capacitar a nuevos empleados:
Los registros facilitan la capacitación de nuevos miembros del equipo, permitiéndoles aprender de manera más eficiente.
Mejorar la eficiencia en el desarrollo:
Los registros ayudan a realizar notificaciones de manera más eficiente, ahorrando tiempo y dinero en el proceso.
Determinar el modelo correcto:
Un registro detallado permite seguir la evolución de los modelos de desarrollo y elegir la mejor opción para cada proyecto.
Conclusión
En resumen, mantener un registro detallado en el desarrollo de software es esencial para garantizar la calidad, cumplir con los estándares y optimizar el proceso de trabajo. No subestimes la importancia de llevar un seguimiento preciso en cada etapa del proyecto, ¡los resultados hablarán por sí mismos!
Optimiza la siguiente nota:
El pasado fin de semana se llevó a cabo un evento de recaudación de fondos para ayudar a los damnificados por el huracán. Durante el evento se realizaron diversas actividades como rifas, subastas y conciertos. La comunidad se unió para apoyar a quienes más lo necesitan y se logró recaudar una gran cantidad de dinero. Agradecemos a todos los que colaboraron y demostraron su solidaridad en estos momentos difíciles. Sin duda, juntos podemos lograr grandes cosas.
