Fornisci a Bob un contesto di progetto persistente attraverso conversazioni e modalità con /init, che genera automaticamente file AGENTS.md.

Il comando /init scansiona un progetto e genera un file di riepilogo strutturato chiamato AGENTS.md che Bob utilizza come contesto persistente in ogni conversazione. Il comando /init è il modo in cui fornisci a Bob la conoscenza della struttura, delle convenzioni e della base di codice di un progetto, senza richiedere a Bob di rileggere ogni file all'inizio di ogni interazione.

I grandi modelli linguistici sono senza stato. Ogni nuova conversazione inizia senza memoria delle interazioni precedenti. Senza un contesto di progetto esplicito, Bob deve scoprire la base di codice ad ogni nuova interazione, il che è inefficiente e diventa impraticabile su larga scala.

In questo tutorial, inizializzi Bob nella directory radice di un'applicazione demo, esplori il contesto che Bob ottiene sull'applicazione e apprendi la struttura di Bob per il contesto specifico della modalità.

Prerequisiti

Per completare questo tutorial, hai bisogno di quanto segue:

Se non lo hai già, clona il codice demo di Galaxium Travels. Il comando di clonazione effettua anche il checkout del branch bob-learning-path-branch che contiene il codice che utilizzi nei tutorial.

git clone -b bob-learning-path-branch https://github.com/IBM/galaxium-travels

Bob IDE con il codice demo di Galaxium Travels aperto

Sebbene non sia obbligatorio, considera di fare il tutorial di avvio rapido per familiarizzare con l'interfaccia e le funzionalità di Bob.

Eseguire /init

Per inizializzare il contesto del progetto, naviga alla barra laterale di chat Ciao, sono Bob nell'IDE Bob. Passa alla modalità Agent nella parte inferiore della barra laterale.

Passa alla modalità Agent

Inserisci il comando /init nell'interfaccia di chat. Se hai disabilitato l'approvazione automatica, Bob chiede il tuo permesso per leggere i file e scrivere i file AGENTS.md.

 /init

Esecuzione del comando /init nell'IDE Bob

Bob legge i file rilevanti nel progetto. Bob genera quindi il file principale AGENTS.md nella directory radice di Galaxium Travels. Bob crea anche una cartella .bob che contiene un AGENTS.md per ogni modalità.

Esplorare i file AGENTS.md

I file AGENTS.md funzionano come documentazione di onboarding per Bob. AGENTS.md è un riepilogo conciso e attuabile che fornisce tutto ciò di cui Bob ha bisogno per comprendere la struttura e le convenzioni del progetto.

Puoi individuare il file principale AGENTS.md nella parte inferiore dell'esploratore file di Bob sul lato sinistro. Apri il file per leggerne il contenuto.

Il file AGENTS.md nell'esploratore file di Bob

Il file AGENTS.md contiene tipicamente i seguenti componenti:

Panoramica e scopo del progetto

Struttura delle directory e posizioni dei file chiave

Stack tecnologico e dipendenze

Pattern architetturali e convenzioni

Flussi di lavoro di sviluppo

Bob applica automaticamente il AGENTS.md alle nuove conversazioni e apprende il contesto del progetto.

File AGENTS.md specifici della modalità

Oltre al AGENTS.md principale nella directory radice di Galaxium Travels, /init genera file di contesto specifici della modalità nella cartella .bob per ogni modalità integrata:

File	Modalità
`.bob/rules-code/AGENTS-code.md`	Modalità Agent
`.bob/rules-plan/AGENTS-plan.md`	Modalità Plan
`.bob/rules-ask/AGENTS-ask.md`	Modalità Ask

Il contesto della modalità Plan enfatizza le convenzioni architetturali, mentre il contesto della modalità Code evidenzia la struttura dei file e i pattern di denominazione.

Mantenere i file AGENTS.md

Riesegui /init dopo aver apportato le seguenti modifiche al progetto:

Aggiunta di nuovi moduli o servizi

Modifica della struttura delle directory

Adozione di nuove tecnologie o framework

Onboarding di nuovi membri del team che utilizzeranno Bob

Puoi anche modificare manualmente il AGENTS.md per aggiungere contesto che la scansione automatizzata di Bob potrebbe non catturare, come regole aziendali, convenzioni di distribuzione o pratiche specifiche del team.

Prossimi passi

In questo tutorial, hai appreso quanto segue:

I grandi modelli linguistici sono senza stato. L'esecuzione del comando /init risolve questo problema generando AGENTS.md, che è un file di contesto persistente che Bob legge all'inizio di ogni conversazione.

I file AGENTS.md specifici della modalità forniscono un contesto mirato per le modalità Agent, Plan e Ask.

Riesegui /init dopo importanti modifiche al progetto per mantenere il contesto aggiornato.

Avviare un progetto con /init e AGENTS.md