Mapa de la ruta
Contenido detallado
🏭 Qué es la AI Strategy Factory
Antes de instalar, entiende qué hace la herramienta, qué ofrece y por qué cuesta solo unos centavos. Siete temas que te dan el mapa mental completo.
Qué es
Casi todas las empresas quieren adoptar la IA, pero una consultoría estratégica seria cuesta miles de reales, demora semanas y depende de especialistas escasos. La mayoría de las empresas termina sin un plan claro.
Por qué aprender
Entender el problema muestra el valor real de la herramienta: democratiza algo que antes era exclusivo de los grandes presupuestos. Ahora puedes ofrecer (o tener) un diagnóstico que pocos tienen.
Conceptos clave
- Consultoría tradicional = semanas + miles de reales
- La herramienta = minutos + centavos
- Enfocado en quienes normalmente no tendrían acceso
Qué es
Proporcionas el nombre de una empresa (y, si quieres, un contexto) y la herramienta devuelve un paquete completo de estrategia de IA, investigado, redactado y formateado automáticamente.
Por qué aprender
Es el modelo mental central del curso: un embudo que parte de una entrada sencilla (el nombre) y genera muchas salidas listas (los documentos). Todo lo demás es un detalle de ese embudo.
Conceptos clave
- Entrada mínima = nombre de la empresa
- El contexto opcional mejora el resultado
- Salida = paquete listo para usar
Qué es
Son 15 documentos de texto (diagnóstico, roadmap, ROI, gobernanza, prompts y más), 2 presentaciones de PowerPoint, 2 informes en Word y diagramas de arquitectura en imagen (PNG).
Por qué aprender
Saber qué esperar evita frustraciones y ayuda a planificar cómo usar cada pieza. La Ruta 3 detalla cada documento; aquí solo necesitas tener una visión general.
Conceptos clave
- 15 documentos + 2 PPTX + 2 DOCX + diagramas
- Todo guardado en una carpeta por empresa
- Material listo para presentar
Qué es
El proceso tiene 3 fases consecutivas: Investigación (recopila datos de la empresa), Síntesis (redacta los documentos) y Generación (prepara presentaciones y diagramas). Cada fase usa una tecnología diferente.
Por qué aprender
Entender las fases te ayuda a seguir el progreso en pantalla y a saber dónde resolver problemas cuando algo sale mal (tema de la Trilha 2 y 3).
Conceptos clave
- Fase 1 Investigación → usa Perplexity
- Fase 2 Síntesis → usa Gemini
- Fase 3 Generación → se ejecuta en tu computadora, sin costo
Qué es
La herramienta combina dos servicios de IA: el Perplexity (busca información actualizada en internet, con fuentes) y el Google Gemini (convierte la investigación en documentos bien redactados).
Por qué aprender
Vas a necesitar una clave de cada servicio. Saber el papel de cada IA aclara por qué se necesitan ambas y qué cobra cada una.
Conceptos clave
- Perplexity = investigación con fuentes
- Gemini = redacción de los documentos
- Cada una requiere su propia clave de API
Qué es
El costo corresponde únicamente a las llamadas de IA: alrededor de US$ 0,05 en el modo rápido y US$ 0,50 en el modo profundo, por empresa. La fase de generación (en tu computadora) es gratuita.
Por qué aprender
Te quita el miedo al costo — es muy barato. Pero conviene entender que cada análisis consume un poco del crédito de tus claves de API.
Conceptos clave
- Rápido ~US$ 0,05 · en profundidad ~US$ 0,50
- Generación local = gratuita
- Pagas directamente a las API, no al curso
Qué es
Es útil para consultores que quieren entregar más rápido, fundadores que evalúan la IA en su propio negocio, equipos de innovación y cualquier persona que estudie estrategia de IA. No necesitas saber programar.
Por qué aprender
Te ayuda a definir el enfoque del uso: para clientes, para la propia empresa o para aprender. El resultado siempre es un borrador sólido que una persona revisa y personaliza.
Conceptos clave
- Consultoría, uso interno o educación
- Sin conocimientos previos de programación
- Genera borradores que una persona refina
🔑 Requisitos previos e instalación
Todo lo que necesitas para dejar la herramienta lista para funcionar: qué instalar, cómo obtener las dos claves gratuitas y cómo configurar el archivo de claves. Siete temas, paso a paso.
Qué es
Tres cosas: el Python 3.9 o superior instalado, las dos claves de API (Perplexity y Gemini) y un terminal (Símbolo del sistema en Windows; Terminal en Mac/Linux).
Por qué aprender
Tener los requisitos previos listos antes de empezar evita que te quedes atascado a mitad de la instalación — el error más común de quienes están empezando.
Conceptos clave
- Python 3.9+ (descárgalo en python.org/downloads)
- En Windows, marca "Add Python to PATH" al instalar
- Terminal abierto en la carpeta del proyecto
Qué es
Accede a perplexity.ai/settings/api, crea una cuenta y haz clic en "Generate API Key". La clave empieza con pplx-.
Por qué aprender
Es una de las dos claves obligatorias. Sin ella, la fase de Investigación no se ejecuta y no se genera ningún documento.
Conceptos clave
- Sitio: perplexity.ai/settings/api
- Formato de la clave: pplx-...
- Guárdala en un lugar seguro: es como una contraseña
Qué es
Accede a aistudio.google.com/apikey, inicia sesión con tu cuenta de Google y haz clic en "Create API Key". La clave empieza con AIzaSy.
Por qué aprender
Es la segunda clave obligatoria. Sin ella, la fase de Síntesis no puede escribir los documentos.
Conceptos clave
- Sitio: aistudio.google.com/apikey
- Formato de la clave: AIzaSy...
- Inicio de sesión con una cuenta de Google común
Qué es
Después de descargar el proyecto, ejecuta python setup.py. El script crea el entorno, instala las dependencias y prepara el archivo .env para ti.
Por qué aprender
Es la forma más sencilla para quien no quiere usar comandos manuales. Un solo comando y el entorno queda listo.
Conceptos clave
- 1 comando lo hace todo
- Crea el entorno virtual e instala las dependencias
- Genera el .env en blanco para que lo completes
Qué es
Si prefieres controlar cada etapa: crea el entorno con python3 -m venv venv, actívalo, instálalo con pip install -r requirements.txt y copia el archivo de ejemplo con cp .env.example .env.
Por qué aprender
Útil cuando falla la automatización o para entender qué ocurre entre bastidores. El «venv» es un entorno aislado solo para este proyecto.
Conceptos clave
- Activar: source venv/bin/activate (Mac/Linux)
- O .\venv\Scripts\activate (Windows)
- Activa siempre el venv antes de ejecutar la herramienta
Qué es
Abre el archivo .env en un editor de texto y completa PERPLEXITY_API_KEY e GEMINI_API_KEY con tus claves. Guarda el archivo.
Por qué aprender
Es donde las claves «entran» en el programa. Sin esto, la herramienta no puede acceder a las IA y da un error de autenticación.
Conceptos clave
- PERPLEXITY_API_KEY=pplx-...
- GEMINI_API_KEY=AIzaSy...
- Sin espacios adicionales · nunca compartas este archivo
Qué es
Antes de gastar, ejecuta una prueba de simulación: python -m strategy_factory.main run "Stripe" --dry-run. Si se ejecuta sin error de clave, todo está bien.
Por qué aprender
Confirma la instalación y la configuración de las claves sin gastar ni un centavo, porque el modo de simulación no realiza llamadas reales de IA.
Conceptos clave
- --dry-run = simulación, sin llamadas a IA
- Un error de clave aquí indica que .env es incorrecto
- Recuerda activar el venv antes
🖥️ Tu primer informe (modo web)
La forma más fácil de usar la herramienta: la interfaz web. Inicia la app, familiarízate con la pantalla y genera tu primer paquete de estrategia — con apuntar y hacer clic, sin comandos.
Qué es
Con el entorno activado, ejecuta python -m strategy_factory.webapp. El navegador se abre solo en http://localhost:8888.
Por qué aprender
El modo web es la forma más amigable de usar la herramienta, sin necesidad de memorizar ningún comando aparte de este.
Conceptos clave
- Comando: ...strategy_factory.webapp
- Se abre en localhost:8888
- ¿Puerto ocupado? Busca otro, o usa --port 9000
Qué es
La pantalla tiene un campo para el nombre de la empresa, un selector de modo (Quick/Comprehensive), un campo opcional de contexto y un botón para iniciar el análisis.
Por qué aprender
Conocer la pantalla antes de ejecutar te dará confianza para el primer análisis, sin miedo a hacer clic en el lugar equivocado.
Conceptos clave
- Campo de empresa (obligatorio)
- Modo: rápido o detallado
- Contexto (opcional) + botón Iniciar
Qué es
Escribe el nombre de la empresa que quieres analizar (por ejemplo, "Stripe"). Es la única información obligatoria para empezar.
Por qué aprender
Es el punto de partida de todo análisis. El nombre también se convierte en el nombre de la carpeta donde se guardarán los resultados.
Conceptos clave
- Nombre = entrada principal
- Se convierte en la carpeta de resultados (ej.: stripe)
- Usa el nombre conocido de la empresa
Qué es
En el campo de contexto puedes dar pistas como "fintech, B2B, 200 empleados". Esto ayuda a Perplexity a investigar con más precisión.
Por qué aprender
Un buen contexto mejora bastante la calidad de los documentos, sobre todo para empresas poco conocidas o con nombres ambiguos.
Conceptos clave
- Contexto = sector, tamaño, modelo de negocio
- Opcional, pero recomendado
- Cuanto más específico, mejor el resultado
Qué es
Después de iniciar, una barra muestra el progreso por las 3 fases (Investigación, Síntesis, Generación) en tiempo real e indica qué está ocurriendo.
Por qué aprender
Ves qué está pasando y cuánto falta, y notas claramente cuándo el paquete está listo.
Conceptos clave
- Barra de progreso por fase
- Rápido: 2-3 min · en profundidad: 5-10 min
- Da seguimiento sin cerrar la pestaña
Qué es
Al terminar, la pantalla muestra enlaces para descargar cada entregable (documentos, presentaciones, Word y diagramas). Todo también queda guardado en la carpeta output/ de tu máquina.
Por qué aprender
Es el objetivo final: tener los archivos a mano para usarlos, editarlos y presentarlos. La Ruta 3 muestra qué hacer con cada uno.
Conceptos clave
- Descarga por archivo, directamente desde la pantalla
- Todo guardado en output/nome-da-empresa/
- Puedes leer el markdown en la propia interfaz