Metodologia

La scheda Metodologia è dove un amministratore definisce come l'agente lavora su un progetto — gli standard che segue sempre, la metodologia per ogni ruolo e i file di riferimento che legge a ogni esecuzione. È così che fai in modo che Makion segua l'esatto modo di lavorare del tuo team, con le tue parole, invece dei valori predefiniti generici dell'ABAP.

Tutto in questa scheda è modificabile solo da un amministratore del progetto o superadmin. Tutti gli altri vedono la scheda in forma di sola lettura con la nota «Sola lettura — le modifica un amministratore.» così possono vedere gli standard a cui l'agente è vincolato senza poterli cambiare.

La metodologia è per progetto. Se due team lavorano su sistemi SAP diversi con standard diversi, assegna loro progetti separati — vedi Configurare i progetti — e regola la metodologia di ciascun progetto in modo indipendente.

Come si combinano i livelli#

Makion guida l'agente da tre livelli contemporaneamente. A ogni esecuzione vengono combinati nel contesto da cui lavora l'agente:

1. Regole di base — sempre applicate, per ogni attività del progetto.
2. La metodologia del ruolo scelto — il system prompt del ruolo che lo sviluppatore ha selezionato nella Chat (per esempio un ruolo di sviluppo vs. un ruolo di revisione in sola lettura).
3. File della base di conoscenza — standard ed esempi che vengono materializzati nel contesto dell'agente a ogni esecuzione.

Quindi una singola richiesta è plasmata da regole di base + il ruolo che hai scelto + la base di conoscenza, insieme. Le regole di base fissano la verità di fondo per l'intero progetto; il ruolo la restringe al tipo di attività; la base di conoscenza fornisce i pattern e gli esempi concreti.

I tre blocchi#

Regole di base#

Le regole di base sono il metodo e gli standard che l'agente segue sempre per questo progetto, indipendentemente dal ruolo scelto. Una riga di stato ti dice da dove provengono le regole correnti:

• «Personalizzate per questo progetto.» — il progetto ha le proprie regole di base.
• «In uso i valori predefiniti ABAP integrati — modifica per personalizzare.» — il progetto è ancora sui valori predefiniti ABAP integrati di Makion; modificali per renderli tuoi.

Scrivi le regole di base in linguaggio naturale: convenzioni di denominazione, aspettative di clean-core, disciplina dei trasporti, abitudini di revisione — tutto ciò che l'agente deve rispettare in ogni attività.

Ruoli#

Il blocco Ruoli definisce la metodologia per ogni ruolo che lo sviluppatore può scegliere nella Chat. Un ruolo è al tempo stesso un confine di permessi e un modo di lavorare: i ruoli di sola lettura non possono cambiare SAP, e questo limite è imposto negli strumenti dati all'agente, non solo descritto a parole. Per il quadro completo di come i ruoli delimitano l'agente, vedi Come funzionano i ruoli e Ruoli Developer.

I ruoli compaiono come schede — una per ruolo. Un ruolo personalizzato mostra un tag «custom» così puoi capire a colpo d'occhio quali ruoli hai adattato e quali sono ancora sui valori predefiniti.

Per il ruolo selezionato puoi modificare:

Regolare i ruoli è la parte a più alto rendimento della scheda Metodologia: è così che un amministratore codifica «ecco esattamente come noi sviluppiamo, esaminiamo e supportiamo l'ABAP» in ogni conversazione. Parti da Configurare i progetti quando allestisci la metodologia di un nuovo progetto.

Base di conoscenza#

La Base di conoscenza contiene i file che l'agente legge quando lavora — i tuoi standard, pattern ed esempi elaborati. Questi file sono materializzati nel contesto dell'agente a ogni esecuzione, quindi tutto ciò che metti qui è materiale di riferimento su cui l'agente può contare direttamente.

Usa le cartelle nel percorso (per esempio knowledge/patterns/… o knowledge/examples/…) per mantenere la base organizzata man mano che cresce. Buoni candidati: un esempio canonico di «come strutturiamo un report», un pattern preferito di gestione degli errori, un promemoria di denominazione, una checklist che l'agente dovrebbe seguire prima di finire.

Dove andare dopo#

• Come funzionano i ruoli — come un ruolo delimita ciò che l'agente può e non può fare.
• Ruoli Developer — i ruoli integrati e a cosa serve ciascuno.
• Configurare i progetti — allestire un progetto e la sua metodologia.
• Specifiche — specifiche di sviluppo versionate da cui lavora l'agente.