🤖 Spiega con IA

Guida introduttiva a 4Geeks AI Studio: Dalla console al primo deploy¶

Panoramica¶

4Geeks AI Studio consegna software attraverso i pod: un pod lead umano di 4Geeks più un piccolo team di agenti IA che lavorano sul tuo repository. Tu descrivi l’obiettivo, approvi un piano e rivedi una merge request. Il pod si occupa di pianificazione, codice, test ed evidenze.

In questa guida imparerai a:

• Scegliere il piano adatto al tuo carico di lavoro (Lite, Starter o Pro)
• Creare il tuo primo pod dalla wizard
• Rispondere all’intake e collegare il repository
• Approvare il piano e seguire la costruzione
• Rivedere e mergiare ciò che il pod consegna

Prerequisiti¶

• Un account 4Geeks (registrati su console.4geeks.io)
• Un repository GitLab o GitHub con un token di accesso che abbia permessi di scrittura sul progetto
• Un piano AI Studio attivo, o una carta registrata per attivarne uno

Passo 1: Scegli il tuo piano¶

Apri AI Studio nella console. La scheda Piano e saldo mostra il piano attuale, i task e le ore di pod lead usate, il saldo prepagato e il limite di pod contemporanei.

• Solo il lavoro consegnato è fatturato: un tentativo fallito e un retry sono assorbiti da 4Geeks.
• Il lavoro sopra la borsa mensile si paga dal wallet prepagato, mai con una fattura a sorpresa.
• Il proprietario dell’organizzazione o un admin possono comprare o cambiare il piano da AI Studio; le modifiche sono prorrate.

I token sono misurati per costo e supporto, ma non sono una quota del cliente e non bloccano mai un task.

Passo 2: Apri la wizard¶

In AI Studio, clicca su Nuovo pod. La wizard ha quattro passi: di cosa hai bisogno, alcune domande, il repository e la conferma.

Scegli l’obiettivo più vicino: prima fetta del mio prodotto, aggiungere una funzionalità, trovare e correggere un bug, audire il mio codice, migrare il mio database, documentare il mio sistema, migliorare qualità e test, aggiornare le mie dipendenze, o un prodotto o una piattaforma.

Se nessuno si adatta, scegli Qualcos’altro e descrivi tu l’obiettivo. Se preferisci una persona, scegli Non sono sicuro, voglio aiuto e un pod lead legge le tue risposte.

Passo 3: Rispondi all’intake¶

L’intake ha cinque domande in linguaggio di business. Solo quelle contrassegnate sono obbligatorie.

Le tue risposte diventano il briefing che il pod lead rivede e che il planner usa per costruire il piano.

Passo 4: Collega il repository¶

1. Scegli GitLab o GitHub e inserisci l’URL dell’istanza (per esempio https://gitlab.com).
2. Inserisci il percorso del progetto e il branch da cui il pod deve partire.
3. Incolla un token di accesso con permessi di scrittura su quel progetto. È salvato cifrato nella vault e usato solo dalla sandbox del pod.
4. Scegli l’immagine runtime: Base, Web, JVM o Android. La wizard ne suggerisce una quando può ispezionare il repository.

Il pod lavora su un branch e apre una merge request. Non spinge mai sul branch protetto.

Passo 5: Conferma e crea il pod¶

La schermata di conferma mostra la dimensione (S, M, L o XL), il briefing, il playbook, il repository, l’immagine runtime, le capacità, gli strumenti, il saldo disponibile e la prima stima.

• Capacità attivano ciò che il pod può eseguire: docs, SCRUM, data, quality, E2E, security, design e preview. Puoi cambiarle finché il piano non è approvato.
• Strumenti sono Jira, Confluence, Notion o un database in sola lettura; puoi collegare le credenziali dopo.
• Stima e saldo: ricarica prima il wallet se il saldo è basso.

Clicca su Crea pod. Il pod appare nell’elenco e poi viene generato il piano.

Passo 6: Approva il piano¶

Quando il piano è pronto, il pod appare sotto Hai bisogno di noi. Rivedi il riepilogo, i task e i criteri di accettazione, le ipotesi, i rischi e ciò che non è incluso.

Clicca su Approva e avvia per portare il pod alla costruzione, oppure Richiedi modifiche per rimandarlo con feedback. Approvare il piano è ciò che avvia la costruzione.

Passo 7: Segui la costruzione¶

La pod room è organizzata dall’alto verso il basso:

Mentre il pod lavora, il quality gate esegue gli script di build e test del tuo repository nella sandbox. Un pod con Quality o E2E non può essere marcato come consegnato senza un run verde, quindi la merge request che arriva ha già superato il QA.

Passo 8: Revisiona e fai il merge¶

Quando il lavoro è finito, il pod apre una merge request con test ed evidenze:

1. Apri la merge request nel tuo repository.
2. Rivedi il diff, i test e le evidenze allegate al pod.
3. Controlla la timeline del pod se vuoi il registro completo; è esportabile in JSON con le credenziali oscurate.
4. Fai il merge quando sei soddisfatto. Il tuo pipeline fa il deploy.

Il pod non mergea mai da solo e non deploya mai in produzione.

Migliori pratiche¶

• Descrivi il risultato, non i passi. “I clienti possono pagare con una carta salvata” vale più di “aggiungi una tabella e un endpoint”.
• Scrivi la definizione di fatto nell’intake. Più è chiaro il “fatto”, meno round serve al piano.
• Rispondi subito a “Hai bisogno di noi”. Il pod si ferma su una decisione, non in background.
• Tieni attivo il quality gate. Build e test sono l’assicurazione più economica contro un merge sbagliato.
• Ricarica prima che il wallet si svuoti. Una pausa per budget costa più tempo di una ricarica.
• Usa il pod lead. È incluso per perimetro, rischio e lavoro bloccato.

Prossimi passi¶

• Leggi su Comprendere AI Factory: Orchestrazione Multi-Modello per imparare come vengono utilizzati diversi LLM
• Impara a Configurare Smart Context Injection per una migliore generazione di codice
• Esplora QA Automatizzato e Barriere di Sicurezza per comprendere i gate di qualità
• Consulta il Riferimento API per l’accesso programmatico

Hai bisogno di aiuto?¶

• Documentazione: docs.4geeks.io
• Discord: Discord
• Supporto: Disponibile dalla dashboard della console
• Vendite: Contattaci

Hai ancora domande? Chiedi su Discord o esplora i tutoriali.