DESAFIO 8 - AUTOMATION & AI AGENT MANAGER

Prueba de
Fuego

Has aprendido a diagnosticar, disenar y justificar. Ahora construyes el agente completo con codigo real. Este es el ultimo desafio antes de entrar en modo construccion con Lovable, Antigravity y n8n.

Este desafio vale el 30% de tu nota de certificacion de la Fase 1
Tienes 2 semanas para entregarlo. La fecha limite se anuncia en clase.
Importante: Si el notebook no ejecuta, la nota maxima es 4/10. Tomarte el tiempo necesario — 2 semanas es suficiente.
Desafio 8 - Prueba de Fuego - Fase 1

Construye el Agente
de PixelFlow

Google Colab - Python - Voyage AI - Claude API - RAG + Grounding

Este es el ultimo desafio de la Fase 1. Cuando lo entregues el programa entra en modo construccion — Lovable, Antigravity, n8n, Telegram y langchain. Todo lo que has aprendido es la base de lo que vas a construir. Hazlo bien.
Que vas a construir

El agente completo de PixelFlow

Un sistema RAG completo que:

  • Lee el Manual Interno de PixelFlow (el documento que Henry te proporciono)
  • Lo fragmenta en chunks y genera embeddings con Voyage AI
  • Almacena los vectores en FAISS local
  • Recibe preguntas de clientes en lenguaje natural
  • Recupera los fragmentos mas relevantes del Manual
  • Llama a Claude API con el contexto recuperado y grounding estricto
  • Devuelve la respuesta en formato JSON estructurado

Restriccion importante

El agente responde unicamente con informacion del Manual. Si la pregunta no esta, debe decirlo. Cero tolerancia a alucinaciones.

Stack obligatorio

Herramientas requeridas

  • Google Colab — entorno de ejecucion. Compartes el notebook con Henry como editor.
  • Python 3.x — lenguaje base.
  • Voyage AI (voyageai) — embeddings. Modelo: voyage-3 o voyage-3-lite.
  • FAISS (faiss-cpu) — base vectorial local.
  • Anthropic SDK (anthropic) — para llamar a Claude.
  • PyPDF2 (pypdf2) — para leer el Manual PDF.

Primera celda del notebook

!pip install anthropic voyageai faiss-cpu pypdf2

Estructura del Notebook

8 secciones obligatorias

  • Celda 1 — Instalacion de dependencias
  • Celda 2 — Configuracion: API keys con google.colab.userdata — nunca hardcodeadas
  • Celda 3 — Ingesta y Chunking: lee el Manual, divide en chunks. Justifica el chunk size en comentarios.
  • Celda 4 — Embeddings con Voyage AI: genera vectores de cada chunk.
  • Celda 5 — FAISS: crea el indice y muestra cuantos vectores se indexaron.
  • Celda 6 — Funcion de recuperacion: recibe pregunta, la vectoriza y busca chunks relevantes.
  • Celda 7 — Agente Claude: system prompt con grounding, inyecta chunks, llama a Claude, devuelve JSON.
  • Celda 8 — Pruebas: minimo 5 preguntas. Al menos 1 que NO este en el documento.
Como se Evalua
Rubrica — 10 puntos totales
3
puntos
El notebook ejecuta sin errores
Henry ejecutara tu notebook de arriba a abajo. Si falla en cualquier celda, nota maxima 4/10.
2
puntos
Voyage AI implementado correctamente
Embeddings con Voyage AI. FAISS indexa y recupera los chunks correctos para cada pregunta.
2
puntos
Grounding correcto — sin alucinaciones
Responde solo con el Manual. Si la info no esta, lo dice. System prompt con regla de grounding explicita.
2
puntos
Output en JSON estructurado
JSON valido con: respuesta, categoria, confianza, escalar_humano. Se puede hacer json.loads().
1
punto
Calidad tecnica y criterio propio
Codigo comentado. Chunk size y temperatura justificados. README claro.

Nota final del certificado Fase 1

30%
Desafio 8 (este)
20%
Desafio 6 (Nexura)
20%
Desafio 7 (Prompts)
30%
Desafios 1-5
Google Colab compartido
Acceso editor para Henry
Manual PixelFlow incluido
Notebook ejecutado completo
henry@evolupedia.com
2 semanas desde hoy

Listo para entregar?

Sigue estos pasos antes de enviar:

1Ejecuta el notebook completo de arriba a abajo sin errores
2Ve a Compartir en Google Colab y anade henry@evolupedia.com como editor
3Copia el enlace del notebook
4Haz clic abajo — se abrira tu email con los datos listos. Pega el enlace.
ENVIAR A HENRY
Introduce tu nombre y email arriba primero.
Scroll al inicio