CurriculumCurrículoAIGrades 9 to 12Grados 9 a 12AI-HS-03
Build a Tool IConstruya una herramienta I
Go from a specification to a working AI-backed tool at a web address, with a README a stranger can follow and visible handling for when things go wrong.Pase de una especificación a una herramienta con IA que funciona en una dirección web, con un README que un desconocido pueda seguir y un manejo visible de lo que sale mal.
- Ways in:Formas de empezar:
- Read, 1 minuteLeer, 1 minuto
- Do, 270 minutesHacer, 270 minutos
- GradesGrados
- Grades 9 to 12, and any learner ready for itGrados 9 a 12, y cualquier persona lista para ello
- TimeTiempo
- 6 sessions of about 45 minutes6 sesiones de unos 45 minutos
- CostCosto
- Needs equipmentNecesita equipo
The MESH'D components this unit uses:Los componentes MESH'D que usa esta unidad:SoftwareSoftwareHolistic DesignDiseño integral
The driving questionLa pregunta central
Can you ship something useful?¿Puede construir y entregar algo útil?
Learners go from a specification to a deployed tool with a README, including the part most demos skip: what happens when things go wrong. The model is only one piece; the code wrapped around it is what makes a tool.Los estudiantes pasan de una especificación a una herramienta publicada con su README, incluida la parte que casi todas las demostraciones omiten: qué pasa cuando algo sale mal. El modelo es solo una pieza; el código que lo rodea es lo que hace la herramienta.
Learners will be able toAl terminar se podrá
- Write done-criteria before building.Escribir los criterios de terminado antes de construir.
- Place the model correctly inside an application: what wraps it and why.Ubicar correctamente el modelo dentro de una aplicación: qué lo rodea y por qué.
- Handle three failure paths: bad input, a model refusal or nonsense answer, and downtime.Manejar tres rutas de falla: entradas malas, un rechazo o una respuesta sin sentido del modelo, y una caída del servicio.
- Write a README a stranger can follow.Escribir un README que un desconocido pueda seguir.
Words to knowPalabras para conocer
- specificationespecificación
- done-criteriacriterios de terminado
- wrapperenvoltura
- failure pathruta de falla
- deploymentdespliegue
- READMEREADME o archivo léame
Standards and ideasEstándares e ideas
Big ideas in AIGrandes ideas de la IA
- Representation and reasoning: They keep models of the world and use them to reason.Representación y razonamiento: Guardan modelos del mundo y los usan para razonar.
- Natural interaction: Making machines talk with people well is hard.Interacción natural: Hacer que las máquinas conversen bien con las personas es difícil.
Session by sessionSesión por sesión
What to doQué hacer
- Hold a specification workshop: name the user, the job and the done-criteria, then cut the scope hard until it is small enough to finish.Haga un taller de especificación: nombre al usuario, la tarea y los criterios de terminado, y luego recorte el alcance sin piedad hasta que sea lo bastante pequeño para terminarlo.
- Sketch how the tool fits together: where the model sits, and what the wrapper checks before the model is called and after it answers.Dibuje cómo se arma la herramienta: dónde va el modelo y qué revisa la envoltura antes de llamar al modelo y después de que responde.
- Build sprint one in an online coding environment, with a text AI model through an adult-managed account.Primer periodo de construcción en un entorno de programación en línea, con un modelo de IA de texto mediante una cuenta administrada por un adulto.
- Handle bad input, a refusal and downtime, each one visibly, so the user sees what happened instead of a silent failure.Maneje las entradas malas, un rechazo y una caída del servicio, cada uno de forma visible, para que el usuario vea qué pasó en lugar de una falla silenciosa.
- Build sprint two, and write the README.Segundo periodo de construcción, y escriba el README.
- Give live demos, including a round where others try hostile inputs on your tool.Haga demostraciones en vivo, con una ronda en la que otros prueban entradas hostiles en su herramienta.
What you needLo que necesita
- paper and pencils for the specification, screen sketch and logic tablespapel y lápices para la especificación, el boceto de la pantalla y las tablas lógicas
EquipmentEquipo
- a laptop or computeruna computadora portátil o de escritorio
- an online coding environmentun entorno de programación en línea
- a text AI model through an adult-managed accountun modelo de IA de texto mediante una cuenta administrada por un adulto
- a web hosting service, only where a build needs oneun servicio de alojamiento web, solo si el proyecto lo necesita
Needs equipment.Necesita equipo.
With no device at allSin ningún aparato
Write the specification, mock up the screen, and work out the logic in tables on paper. The build picks up on a device day without losing any of that design work.Escriba la especificación, dibuje la pantalla y resuelva la lógica en tablas en papel. La construcción continúa cuando haya un dispositivo, sin perder nada de ese trabajo de diseño.
An adult manages the AI account and supervises every session, and agents and tools that can act are always supervised. Never use an AI tool for personal or emotional questions; talk with a trusted person instead. Use no real personal data in test inputs, and an adult decides who can see a deployed tool. You are accountable for everything you ship, including the parts a model wrote: if you cannot explain it, do not deliver it.Un adulto administra la cuenta de IA y supervisa cada sesión, y los agentes y las herramientas que pueden actuar siempre se supervisan. Nunca use una herramienta de IA para preguntas personales o emocionales; hable con una persona de confianza. No use datos personales reales en las entradas de prueba, y un adulto decide quién puede ver una herramienta publicada. Usted es responsable de todo lo que entrega, incluidas las partes que escribió un modelo: si no puede explicarlo, no lo entregue.
What learners make and showLo que se hace y se muestra
A live demo of the tool. A strong demo meets its done-criteria, survives at least one failure path in front of the audience, and has a README checked by a peer who never saw the build.Una demostración en vivo de la herramienta. Una buena demostración cumple sus criterios de terminado, resiste al menos una ruta de falla frente al público y tiene un README revisado por un compañero que nunca vio la construcción.
Mix-ups to expectConfusiones que esperar
- A demo is a product. A demo works once for its maker; a product keeps working for other people, on bad days too.Una demostración es un producto. Una demostración funciona una vez para quien la hizo; un producto sigue funcionando para otras personas, también en los días malos.
- The model is the app. The wrapper is the app: it checks the input, calls the model, checks the answer and handles failures.El modelo es la aplicación. La envoltura es la aplicación: revisa la entrada, llama al modelo, revisa la respuesta y maneja las fallas.
- Error handling is polish. It is the difference between a tool and a toy.Manejar errores es un detalle de acabado. Es la diferencia entre una herramienta y un juguete.
At homeEn casa
Try it at the kitchen tablePruébelo en la mesa de la cocina
Hand your README to a family member and watch them run your tool from it alone, without helping. Every place they get stuck is something to fix.Entregue su README a un familiar y observe cómo usa su herramienta solo con eso, sin ayudarle. Cada lugar donde se atore es algo que corregir.
Use it, share it, adapt itÚsela, compártala, adáptela
The credit to copyEl crédito para copiar
Free BYRD, CC BY. “Build a Tool I” from the Byrd Academy STEM Curriculum by Byrd EDU, byrdathome.org.Free BYRD, CC BY. “Construya una herramienta I”, del Currículo STEM de Byrd Academy, de Byrd EDU, byrdathome.org.
This is free to use, share and adapt, even commercially, under the Creative Commons Attribution 4.0 International license (CC BY 4.0), with this credit. What Free BYRD means.Esto es libre de usar, compartir y adaptar, incluso con fines comerciales, bajo la licencia Creative Commons Atribución 4.0 Internacional (CC BY 4.0), con este crédito. Qué significa Free BYRD.