Saltar a contenido

🤖 Explicar con IA

Primeros pasos con 4Geeks AI Studio: De la consola al primer despliegue

Descripción general

4Geeks AI Studio entrega software mediante pods: un pod lead humano de 4Geeks más un equipo pequeño de agentes de IA trabajando en tu repositorio. Tú describes el resultado, apruebas un plan y revisas un merge request. El pod se encarga de la planificación, el código, las pruebas y la evidencia.

En este tutorial aprenderás a:

  • Elegir el plan que coincide con tu carga de trabajo (Lite, Starter o Pro)
  • Crear tu primer pod desde el asistente
  • Responder la entrevista y conectar tu repositorio
  • Aprobar el plan y seguir la construcción
  • Revisar y mergear lo que el pod entrega

Requisitos previos

  • Una cuenta de 4Geeks (regístrate en console.4geeks.io)
  • Un repositorio de GitLab o GitHub con un token de acceso con permiso de escritura en el proyecto
  • Un plan de AI Studio activo, o una tarjeta registrada para iniciar uno

Paso 1: Elige tu plan

Abre AI Studio en la consola. La tarjeta Plan y saldo muestra tu plan actual, las tareas y horas de pod lead usadas, el saldo prepago y el límite de pods simultáneos.

Plan Base mensual Tareas / mes Pod lead / mes Pods a la vez
Lite $390 10 Bajo demanda ($75/h) 1
Starter $790 15 2 h 1
Pro $1,590 40 6 h 3
  • Solo se factura el trabajo entregado: un intento fallido y un reintento corren por cuenta de 4Geeks.
  • El trabajo por encima de la bolsa mensual se paga desde la billetera prepago, nunca como una factura sorpresa.
  • El dueño o un admin de la organización puede comprar o cambiar el plan desde AI Studio; los cambios se prorratean.

Los tokens se miden para costo y soporte, pero no son una cuota del cliente y nunca bloquean una tarea.

Paso 2: Abre el asistente

En AI Studio, haz clic en Nuevo pod. El asistente tiene cuatro pasos: lo que necesitas, unas preguntas, el repositorio y la confirmación.

Elige el resultado más cercano: primera rebanada de mi producto, agregar una funcionalidad, encontrar y corregir un bug, auditar mi código, migrar mi base de datos, documentar mi sistema, mejorar calidad y pruebas, actualizar mis dependencias, o un producto o una plataforma.

Si ninguno encaja, elige Algo más y describe el objetivo tú mismo. Si prefieres a una persona, elige No estoy seguro, quiero ayuda y un pod lead lee tus respuestas.

Paso 3: Responde la entrevista

La entrevista son cinco preguntas en lenguaje de negocio. Solo las marcadas son obligatorias.

Pregunta Por qué importa
¿Qué debe hacer? El resultado al que apuntará el plan. Describe el resultado, no las pantallas.
¿Quién lo va a usar? La audiencia y los roles que el plan debe cubrir.
¿Qué debe poder hacer? Las tres o cuatro cosas que no pueden faltar.
¿Con qué sistemas debe hablar? Opcional. Integraciones como pagos, email o un ERP.
¿Cómo sabrás que está terminado? La prueba de aceptación con tus palabras. Esto se convierte en la definición de terminado.

Tus respuestas se convierten en el brief que revisa el pod lead y que el planner usa para construir el plan.

Paso 4: Conecta el repositorio

  1. Elige GitLab o GitHub e ingresa la URL de la instancia (por ejemplo https://gitlab.com).
  2. Ingresa la ruta del proyecto y la rama desde la que debe empezar el pod.
  3. Pega un token de acceso con permiso de escritura en ese proyecto. Se guarda cifrado en la bóveda y solo lo usa el sandbox del pod.
  4. Elige la imagen de runtime: Base, Web, JVM o Android. El asistente sugiere una cuando puede inspeccionar el repositorio.

El pod trabaja en una rama y abre un merge request. Nunca hace push a tu rama protegida.

Paso 5: Confirma y crea el pod

La pantalla de confirmación muestra el tamaño (S, M, L o XL), el brief, el playbook, el repositorio, la imagen de runtime, las capacidades, las herramientas, el saldo disponible y la primera estimación.

  • Capacidades activan lo que el pod puede ejecutar: docs, SCRUM, data, quality, E2E, security, design y preview. Puedes cambiarlas hasta aprobar el plan.
  • Herramientas son Jira, Confluence, Notion o una base de datos de solo lectura; puedes conectar credenciales después.
  • Estimación y saldo: recarga la billetera primero si el saldo está bajo.

Haz clic en Crear pod. El pod aparece en la lista y luego se genera el plan.

Paso 6: Aprueba el plan

Cuando el plan esté listo, el pod aparece bajo Te necesitamos. Revisa el resumen, las tareas y sus criterios de aceptación, los supuestos, los riesgos y lo que no está incluido.

Haz clic en Aprobar e iniciar para llevar el pod a construcción, o Pedir cambios para devolverlo con comentarios. Aprobar el plan es lo que inicia la construcción.

Paso 7: Sigue la construcción

La sala del pod está organizada de arriba hacia abajo:

Zona Qué responde
Encabezado Entidad, estado y una línea de progreso: fase más tareas completadas.
Te necesitamos La decisión pendiente más importante: plan, presupuesto, permiso de herramienta o una pregunta.
Qué está pasando El timeline en vivo y el composer, con un filtro Todo/Conversación.
Tareas Primero los fallos, luego la tarea en curso y las siguientes.
Detalles del pod El plan decidido, el equipo, la billetera, los entregables y los detalles técnicos.

Mientras el pod trabaja, el quality gate corre los scripts de build y test de tu repositorio en el sandbox. Un pod con Quality o E2E no se puede marcar como entregado sin una corrida en verde, así que el merge request que llega ya pasó por QA.

Paso 8: Revisa y mergea

Cuando el trabajo esté terminado, el pod abre un merge request con pruebas y evidencia:

  1. Abre el merge request en tu repositorio.
  2. Revisa el diff, las pruebas y la evidencia adjunta al pod.
  3. Revisa el timeline del pod si quieres el registro completo; se exporta como JSON con las credenciales redactadas.
  4. Mergea cuando quedes conforme. Tu pipeline despliega.

El pod nunca mergea por su cuenta y nunca despliega a producción.

Mejores prácticas

  • Describe el resultado, no los pasos. “Los clientes pueden pagar con una tarjeta guardada” es mejor que “agrega una tabla y un endpoint”.
  • Escribe la definición de terminado en la entrevista. Cuanto más claro sea “terminado”, menos vueltas dará el plan.
  • Responde rápido a “Te necesitamos”. El pod se pausa en una decisión, no en segundo plano.
  • Mantén activo el quality gate. Build y pruebas son el seguro más barato contra un mal merge.
  • Recarga antes de que se agote la billetera. Una pausa por presupuesto cuesta más tiempo que una recarga.
  • Usa al pod lead. Está incluido para alcance, riesgo y trabajo bloqueado.

¿Qué sigue?

¿Necesitas ayuda?

¿Aún tienes dudas? Pregunta en Discord o explora los tutoriales.