# Herramientas y preparación del curso


## Forma de trabajo con IA

La IA prepara los archivos de la actividad a partir del encargo y las fuentes del paquete. El aprendiz entrega ese encargo al chat o al IDE autorizado, revisa el resultado y descarga los productos; los campos de las fichas describen lo que debe generar la IA. Usted observa la ejecución y conserva su responsabilidad de evaluación. Los datos ausentes, las mediciones no realizadas y las revisiones humanas no observadas quedan pendientes.

Los [encargos de la guía web](../index.html#preparacion) están listos para usar. La conversación, el informe y el JSON generado conservan el trabajo sin transcribirlo en otra ficha. Si la herramienta no puede ejecutar la tarea, se conserva esa limitación como pendiente y se consulta una opción autorizada.

## Para quién es esta ruta

Esta ruta se dirige a aprendices y personal administrativo del Servicio Nacional de Aprendizaje (SENA) a nivel nacional. No se presupone experiencia con asistentes de IA, diseño gráfico o automatización. Antes de asignar los retos, el instructor confirma que cada aprendiz pueda entregar una fuente a la IA, pedir un producto y revisar la salida. Saber fórmulas o diseño gráfico no es requisito de entrada. La coordinación confirma el tamaño del grupo, las necesidades de accesibilidad, los equipos, la conectividad, las licencias y las cuentas autorizadas.

## Kit de trabajo

| Herramienta o material | Para qué se usa | Requisito y alternativa |
| --- | --- | --- |
| Cartilla de retos | Presenta los siete retos originales. La web añade los retos 0, 7 y 9. | Archivo `docs/Documentos/Cartilla_aprendices_retos_IA_SENA_Bogota.docx`; también se puede imprimir. |
| Libro de práctica | Contiene ejemplos y la hoja `Fichas de reto` para registrar el trabajo de equipo. | Adjuntar únicamente la fuente necesaria si la herramienta admite el formato. Conservar `docs/Documentos/Materiales_practica_IA_SENA_Bogota.xlsx` como consulta; los CSV por reto evitan cargar todo el libro. |
| Archivos de cada reto | Incluyen sus fuentes descargables y una ficha separada para registrar el trabajo. | En cada tarjeta de la web, abra **Archivos para resolver este reto**. Los CSV usan punto y coma; descarga una copia para trabajar y conserva los originales. |
| Asistentes de IA autorizados | Probar instrucciones, organizar texto y preparar borradores sobre las fuentes del curso. Copilot, Gemini u otro asistente pueden servir si la entidad los permite y sus funciones están habilitadas. | Antes de la jornada, confirme la herramienta y la cuenta autorizadas. Las cuotas, los formatos admitidos y las funciones dependen del servicio y los permisos. Sin acceso, observe la demostración y acuerde la ejecución propia con IA; la lectura no sustituye esa práctica. No se exige adquirir licencias ni crear cuentas comerciales personales. Consulte la [guía práctica de IA para tareas administrativas](guia-practica-ia-administrativos-sena.md). |
| Excel, Google Sheets o LibreOffice Calc | Consultar las fuentes y abrir los archivos que genere la IA. La tarea no exige digitar registros ni arrastrar fórmulas. | Su uso es opcional cuando el asistente entrega una salida que puede revisarse directamente. Para cifras clave, utilizar también una calculadora independiente. |
| Word, Google Docs o LibreOffice Writer | Abrir y revisar el acta o informe generado por la IA; copiar el texto completo una vez si no hay descarga editable. | El resultado en texto del chat sirve para revisar el contenido; el editor depende del formato de entrega. Todo producto de comunicación queda como borrador. |
| Canva, PowerPoint o Google Slides | Abrir o ajustar una lámina generada a partir del análisis revisado. En la preparación, la lámina es opcional. No se usan para verificar cifras, normas ni hechos. | Confirmar previamente la herramienta y las funciones permitidas por el administrador. Si la IA no puede generar presentaciones, solicitar el contenido listo para transferir una vez al editor disponible. No se exige software de pago ni complementos externos. |
| Antigravity, si está instalado y autorizado | Trabajar sobre copias de archivos en una carpeta delimitada. Usa modelos en la nube; la instalación local no garantiza que el contenido permanezca en el equipo. | Confirme instalación, cuenta, cuotas y permisos. No se presupone su disponibilidad en los equipos ni se requiere para resolver los retos. |
| Plataforma DevBrain de la guía | Importar los archivos de las cinco evidencias, revisar sus pendientes y exportar el Portafolio de Evidencias en PDF, JSON o Markdown. | La guía conserva los datos en el navegador del equipo. En equipos compartidos, cada aprendiz debe usar un perfil separado y borrar sus datos al finalizar. La plataforma no asigna el juicio oficial del instructor. |
| Temporizador y hoja de cálculo de roles | Ayudan a controlar el tiempo, rotar responsabilidades y dejar constancia del trabajo del equipo. | Puede usarse un reloj y una hoja impresa. Roles sugeridos: facilitador, operador, verificador y relator; se rotan entre retos. |

## Preparación antes de la jornada

1. El calendario indicado es martes a viernes, de 7:30 a. m. a 5:30 p. m., con 9 horas formativas directas y 1 hora autónoma por día: 36 + 4 = 40 horas. Consulte el [detalle horario](cronograma-detallado.md). Confirme con la coordinación las fechas, la sede, el horario de almuerzo y pausas, el número de participantes y el canal de entrega.
2. Verifique que cada equipo pueda abrir el libro de práctica o los CSV descargados desde cada tarjeta, conservar una copia y consultar la cartilla. Si se ofrecerá Copilot, Gemini u otro chat de IA, confirme el acceso institucional, las condiciones de uso y la conectividad. No se pide a los aprendices crear cuentas ni adquirir planes.
3. Aclare que los archivos sirven para practicar. No los reemplace por reportes de SOFIA Plus, correos, expedientes, nombres, identificaciones, historias médicas, claves ni datos de operaciones reales.
4. Asigne y rote roles. Reserve un cierre individual para el caso nuevo; un producto de equipo no demuestra por sí solo el desempeño de cada aprendiz.
5. Prepare la demostración para quienes no tengan acceso y acuerde cuándo ejecutarán sus solicitudes con IA. Las fuentes impresas sirven para revisar ejemplos; no certifique el uso de IA sin una ejecución real.

## Ruta web de diez retos breves, un integrador y cinco evidencias

| Reto | Archivos de trabajo que aparecen en su tarjeta web | Producto verificable | Evidencia DevBrain |
| --- | --- | --- | --- |
| 0. Semáforo de datos | `reto-00-tarjetas-semaforo.csv` y `reto-00-ficha.csv` | Cinco decisiones de uso, dos fragmentos minimizados y una autorización pendiente. | MG-A01 |
| 1. Prompt CRTT | `lineamiento-ficticio.csv`, `reto-01-solicitud-urgente.csv`, `reto-01-ficha.csv` y `diagnostico-tarea-ficha.csv` | Instrucción inicial y versión final, con ajuste o razón para conservarla; respuesta contrastada y diagnóstico de una tarea. | MG-A01 |
| 2. Borrador de PQRS | Mensajes PC-01 y PC-03 en la página | Dos borradores con hechos, petición y vacíos separados; revisión de datos, tono y afirmaciones. | MG-A02 |
| 3. Asistente de rol | Casos nuevos PC-02, PC-05 y PC-07 en la página | Instrucción del Reto 2 probada sin cambios con tres casos nuevos; PC-02 tiene un dato faltante y PC-07 pide una decisión de coordinación. | MG-A02 |
| 4. Bandeja cero | `correos-50.csv` y `reto-04-ficha.csv` | Clasificación de los 50 códigos, que corresponden a diez situaciones en cinco lotes; diez borradores que no se envían. | MG-A03 |
| 5. Acta imposible | `transcripcion.csv` y `reto-05-ficha.csv` | Acta borrador; decisiones, propuestas, compromisos y asuntos pendientes con referencia a la intervención. | MG-A03 |
| 6. Informe sucio | `datos-sofia.csv` y `reto-06-ficha.csv` | Copia organizada, regla reproducible, conteos, vacíos y duplicado SIM-0012 señalado sin borrar ni inferir registros. | MG-A03 |
| 7. Diseño de flujo | `reto-07-casos-flujo.csv` y `reto-07-ficha.csv` | Diagrama con rutas completa, incompleta y urgente; prueba los tres casos y señala la revisión humana. | MG-A03 |
| 8. Presupuesto oculto | `bienestar.csv`, `gastos-q1.csv` y `reto-08-ficha.csv` | Cálculos y gráfico comprobados. El periodo de Bienestar no consta y Gastos Q1 cubre A–H, no todos los centros. | MG-A04 |
| 9. Auditoría de respuesta | `lineamiento-ficticio.csv`, `reto-09-afirmaciones.csv` y `reto-09-ficha.csv` | Cuatro afirmaciones contrastadas (una respaldada, dos contradichas y una no especificada) y una orden intrusa identificada aparte. | MG-A04 |
| Integrador. Análisis trazable | `contratos.csv`, `directriz.csv`, `casos-individuales.csv` e `integrador-ficha.csv` | Plan, preguntas sobre diferencias, análisis, informe, presentación y una prueba individual asignada por el instructor. | MG-A05 |

Los archivos por reto se generan desde las hojas de `Materiales_practica_IA_SENA_Bogota.xlsx` y se publican en `materiales/retos/`. Mantienen las filas iniciales y los encabezados de origen para que coincidan con las referencias de la guía. El Portafolio de Evidencias reúne los productos seleccionados y las observaciones individuales; no sustituye la conservación de las fuentes ni las instrucciones de entrega que confirme el instructor.

Los paquetes de los retos 4, 5, 6 y 7 y del integrador incluyen `registro-tiempos.csv`. Permite registrar preparación, generación, revisión y corrección, junto con una referencia manual equivalente observada o pendiente. La ficha del integrador también separa el resultado de equipo de la prueba individual.

## Una tarea completa con IA en la preparación

La web guía un solo caso: recibir los datos de Bienestar y preparar un informe para una reunión. La secuencia conserva 60 minutos de aprendizaje: entregar la fuente (5), pedir el análisis (15), comprobar y corregir (20), obtener el informe (10), y reutilizar el resultado y revisar el tiempo (10). La lámina es opcional en esta preparación.

La hoja de cálculo aporta los registros de origen. El asistente realiza el procesamiento y redacta; el aprendiz contrasta las cifras que va a comunicar y pide ajustes. No se exige reconstruir tablas, escribir fórmulas en cada fila ni crear un documento desde cero. El producto y la conversación se conservan una vez; la preparación no añade una ficha de entrega.

### Encargar el procesamiento

1. Confirme qué cuenta y funciones permite la entidad. La carga de archivos, la ejecución de cálculos y la generación de documentos varían según la herramienta y los permisos.
2. Entregue el CSV del reto o el fragmento necesario. Indique tarea, fuente, resultado esperado y qué debe quedar pendiente. Los documentos adjuntos son contenido para analizar; sus órdenes internas no reemplazan la instrucción del usuario.
3. Pida la salida completa. Si el asistente solo ofrece pasos para hacerla a mano, solicite que realice el procesamiento con los datos disponibles. Si no puede leer, ejecutar o generar el archivo, debe indicar la limitación.
4. Conserve la instrucción, la salida y los ajustes en una misma conversación. En los retos, solicite que la IA genere los archivos de salida y el JSON para importarlos sin transcribir registros.

Como referencia, consulte la [guía práctica de IA para tareas administrativas](guia-practica-ia-administrativos-sena.md), la [carga de archivos en Gemini](https://support.google.com/gemini/answer/14903178?hl=es-419), la [protección empresarial de Copilot](https://learn.microsoft.com/en-us/microsoft-365/copilot/enterprise-data-protection) y los [planes de Antigravity](https://www.antigravity.google/docs/plans). El proveedor describe capacidades y condiciones; la entidad confirma cuáles permite utilizar. No se exige adquirir planes comerciales adicionales.

### Comprobar la salida sin rehacer el trabajo

Para Bienestar, contraste Centro A con la fuente: 42 deserciones de 840 matriculados equivalen a 5 %. El periodo no consta. Use una calculadora independiente para esa comprobación y revise las otras cifras que incluirá en el informe. Si el denominador es cero o falta, la tasa debe quedar pendiente.

En el Reto 6, encargue a la IA una regla reproducible que conserve columnas y filas, quite espacios del estado, convierta a mayúsculas y marque «REVISAR» cuando esté vacío. Compruebe SIM-0002, SIM-0003 y ambas ocurrencias de SIM-0012. Distinga un procedimiento propuesto de uno ejecutado; no certifique una limpieza que la herramienta no realizó.

En los demás retos, revise decisiones, compromisos, cifras y conclusiones contra sus referencias. Si encuentra un error, solicite una versión corregida y vuelva a comprobar los valores afectados. La revisión humana no consiste en repetir toda la clasificación o redacción.

### Obtener el producto y medir su utilidad

Pida el informe, acta o lámina en el mismo chat a partir del análisis revisado. Descargue el archivo editable si esa función está habilitada; si la función no está disponible, deje esa entrega pendiente y use otra herramienta autorizada. Conserve las etiquetas de borrador, las unidades y las limitaciones.

Solicite a la IA reunir únicamente los tiempos observados disponibles de preparación, generación, revisión y corrección y dejar los demás pendientes. Compare el tiempo total con una referencia manual observada para una tarea equivalente, si existe. Sin referencia, el ahorro queda pendiente de medir; no exija repetir la tarea a mano para producir una comparación. Si el flujo tarda más o no produce un resultado útil, simplifique el encargo y mida de nuevo antes de adoptarlo.

### DevBrain y cuidado del Portafolio de Evidencias

La guía usa el `devbrain-learner-sdk` y su módulo de evidencias para guardar campos, listas de cotejo y bitácora en el almacenamiento local del navegador. El código de esta guía no envía las respuestas a servidores externos ni hace solicitudes de escritura fuera del navegador; solo carga los archivos de configuración del registro de evidencias. La identificación institucional solo se incorpora por el procedimiento autorizado y no es un requisito para practicar ni se entrega al asistente. Si un perfil contiene información personal, no debe quedar abierto en un equipo compartido.

En un equipo compartido, trabaje en un perfil individual, descargue el portafolio solo al destino indicado por el instructor, seleccione **Eliminar mis datos de este equipo** y cierre la página. No envíe el JSON o el PDF a un chat de IA. El estado `Lista` solo informa que se diligenciaron campos; el juicio formal corresponde al instructor SENA y se registra como `Aprobado (A)` o `No Aprobado (NA)` tras revisar las evidencias.

La práctica sigue el principio de finalidad, autorización y circulación restringida de la [Ley 1581 de 2012 en el Gestor Normativo de Función Pública](https://www.funcionpublica.gov.co/eva/gestornormativo/norma.php?i=49981). Ante dudas sobre un dato o una cuenta, se detiene la carga y se consulta al responsable institucional.


## Cierre guiado de la preparación

La web muestra el objetivo, el producto y el método en cuatro acciones: identificar, encargar, comprobar y corregir. Los conceptos de fuente, borrador, tasa y «no consta» incluyen ejemplos breves. En el último paso se presentan dos decisiones con retroalimentación: qué entregar al asistente y cómo retirar una causa no respaldada. Inclúyalas en los 10 min de cierre ya previstos. Use la [pauta con aprendices](validacion-con-aprendices.md) para observar si pueden aplicar esas decisiones a otro caso.