Configurare i progetti
Questa è la pagina che risponde alla domanda centrale: come faccio in modo che Makion segua le nostre istruzioni esatte quando sviluppa codice o agisce nel sistema? La risposta è un progetto. Un progetto abbina un sistema SAP con le impostazioni e gli standard che plasmano ogni attività eseguita su di esso — il motore IA, la variante ABAP, se può girare senza supervisione, e le regole, i ruoli e gli esempi che l'agente legge a ogni esecuzione.
Imposta bene un progetto una volta, e ogni sviluppatore che vi lavora ottiene lo stesso comportamento prevedibile. Questa pagina illustra l'intera configurazione in ordine.
Un progetto per «team × sistema SAP × modo di lavorare». Se due team hanno standard diversi o sistemi diversi, assegna loro progetti separati e regola ciascuno in modo indipendente.
Le quattro cose che guidano l'agente#
Il comportamento di Makion su un progetto deriva da quattro livelli, impostati su due schede:
| Livello | Dove lo imposti | Cosa controlla |
|---|---|---|
| Destinazione e motore | Scheda Admin → tabella Progetti | Quale sistema SAP, quale variante ABAP, quale motore IA e se sono consentite le esecuzioni autonome. |
| Regole di base | Scheda Metodologia | Gli standard che l'agente segue sempre — denominazione, pattern, fare / non fare. |
| Metodologie dei ruoli | Scheda Metodologia | Come si comporta ogni ruolo e se quel ruolo può scrivere in SAP. |
| Base di conoscenza | Scheda Metodologia | Standard ed esempi elaborati che l'agente legge a ogni esecuzione. |
Il meccanismo preciso: a ogni attività, Makion combina regole di base + il ruolo scelto dallo sviluppatore + i file della base di conoscenza nel contesto da cui lavora l'agente. Quindi regole di base precise + buoni esempi = l'agente «segue le istruzioni» in modo affidabile. La pagina Metodologia spiega per intero questa stratificazione; questa pagina ti dice in quale ordine procedere.
Checklist di configurazione#
1. Crea il progetto#
Dal Selettore di progetto nella barra superiore, clicca + Nuovo progetto e assegnagli un nome. La persona che crea un progetto ne diventa l'amministratore del progetto, quindi può gestirne metodologia e membri anche senza essere superadmin. Vedi Accesso e progetti per il selettore.
2. Puntalo a un sistema SAP#
Apri la scheda Systems e configura la connessione SAP a cui punta questo progetto — livelli DEV / QAS / PROD, dove QAS e PROD sono in sola lettura. Poi, nella tabella Progetti della scheda Admin, imposta la colonna Sistema SAP su quel sistema, così il progetto e la sua connessione sono abbinati.
3. Imposta il profilo tecnico del progetto (Admin → Progetti)#
Nella scheda Admin, la tabella Progetti ha una riga per progetto. Imposta:
| Colonna | Scelte | Cosa fa |
|---|---|---|
| Progetto | — | Il nome del progetto (etichetta di sola lettura della riga). |
| Sistema SAP | i tuoi sistemi configurati | A quale sistema SAP punta questo progetto. |
| Variante ABAP | modern (7.40+ / S/4) o classic (<7.40 / ECC) | Plasma quali costrutti e pattern del linguaggio usa l'agente — stile moderno inline / CDS / RAP contro ABAP classico compatibile con ECC. Impostala per corrispondere al sistema di destinazione. |
| Motore | Claude, Gemini, Codex, Kimi o Grok | Quale modello IA esegue questo progetto. Vedi Motori IA e accesso. |
| Autonomo | casella | Quando è attiva, questo progetto può eseguire esecuzioni dell'agente senza supervisione. Vedi Modalità autonoma. |
Autonomo ATTIVO consente esecuzioni dell'agente senza supervisione. Il lavoro autonomo è comunque in sola lettura e propone modifiche in una coda di invio che un umano approva e applica — ma lascialo disattivo per i progetti che devono girare solo in modo interattivo. Vedi Modalità autonoma.
4. Scrivi la metodologia (scheda Metodologia)#
Apri la scheda Metodologia e imposta i tre blocchi — è qui che «segui le nostre istruzioni esatte» viene effettivamente codificato:
- Regole di base — gli standard che l'agente segue sempre su questo progetto, indipendentemente dal ruolo: convenzioni di denominazione, aspettative di clean-core, disciplina dei trasporti, abitudini di revisione. Scrivile in linguaggio naturale e clicca Salva regole di base. Regole di base precise e non ambigue sono la leva più grande su quanto fedelmente lavora l'agente.
- Ruoli — per ogni ruolo che lo sviluppatore può scegliere nella Chat, modifica la sua metodologia e attiva/disattiva Può cambiare SAP (scrittura). Non selezionato significa sola lettura: all'agente vengono fisicamente dati solo strumenti di lettura. Regola ogni ruolo per dire esattamente come il tuo team sviluppa, esamina o supporta l'ABAP. Vedi Come funzionano i ruoli.
- Base di conoscenza — aggiungi standard ed esempi elaborati come file (per esempio un canonico «come strutturiamo un report», un pattern preferito di gestione degli errori, una checklist di pre-completamento). Questi vengono letti a ogni esecuzione, quindi sono il posto migliore per esempi concreti che l'agente dovrebbe imitare.
5. Aggiungi gli sviluppatori#
Dai accesso alle persone che lavoreranno nel progetto:
- Un superadmin usa Admin → Accesso ai progetti e spunta la casella per questo progetto nella riga di ciascuno sviluppatore.
- Un amministratore del progetto usa la scheda Membri del progetto — Aggiungi uno sviluppatore, poi imposta il suo ruolo.
Il dettaglio completo è in Utenti e accessi.
Dopo la configurazione#
- Gli sviluppatori scelgono il progetto nel selettore della barra superiore, si connettono in Systems e lavorano nella Chat.
- Raffina man mano che impari: rafforza le regole di base, aggiungi esempi alla base di conoscenza e lascia che Retro faccia emergere correzioni di regole e conoscenza dalle sessioni reali.
- Tutto ciò che l'agente fa viene registrato — vedi il Registro di audit.
Dove andare dopo#
- Metodologia — le regole di base, i ruoli e la base di conoscenza per intero.
- Motori IA e accesso — scegli e autentica il motore del progetto.
- Utenti e accessi — concedi l'accesso e gestisci i membri.
- Modalità autonoma — come le esecuzioni senza supervisione propongono modifiche per l'approvazione umana.