Personalizzazione del codice Genie con istruzioni, competenze, memoria e MCP

Genie Code funziona al meglio quando comprende il modo in cui opera effettivamente il tuo team: i tuoi standard di codifica, i flussi di lavoro interni, gli strumenti condivisi e il contesto alla base delle decisioni passate.

Ecco perché abbiamo introdotto una serie di funzionalità che ti consentono di adattare Genie Code alla tua organizzazione e ai tuoi flussi di lavoro. Le istruzioni aiutano a definire le preferenze a livello di team, le skill acquisiscono flussi di lavoro ripetibili e i server MCP collegano Genie Code direttamente a sistemi come Jira, GitHub e Google Drive.

Istruzioni personalizzate

Le istruzioni personalizzate ti consentono di impostare preferenze persistenti che Genie Code applica in ogni sessione in modalità agente. Sono ideali per gli aspetti che rimangono invariati nel tuo modo di lavorare: il linguaggio di programmazione preferito, il formato di output o le linee guida generali sullo stile.

Il limite è che le istruzioni sono globali. Se aggiungi una regola di formattazione SQL, questa si attiva sia che tu stia scrivendo in SQL sia che tu stia eseguendo il debug di Python. Per le preferenze applicabili ovunque, le istruzioni sono lo strumento giusto. Per un contesto rilevante solo per un'attività specifica, serve qualcosa di più mirato.

Per le convenzioni a livello di team, Genie Code può anche rilevare automaticamente i file AGENTS.md and CLAUDE.md all'interno del tuo progetto. Una volta inseriti questi file in un repository, Genie Code li rileva automaticamente, evitando che i membri del team debbano configurare singolarmente lo stesso contesto.

Skill dell'agente

Le skill dell'agente sono un modo per insegnare a Genie Code a eseguire attività specifiche esattamente come faresti tu.

Una skill è un pacchetto basato su markdown che descrive un flusso di lavoro, un pattern o un'azione che Genie Code può utilizzare quando opera in modalità agente. Le skill possono includere indicazioni, codice riutilizzabile e script eseguibili, tutti limitati a un'attività specifica anziché applicati a livello globale.

Ogni skill include un nome e una descrizione che aiutano Genie Code a determinare quando è pertinente. Quando una richiesta corrisponde a una skill, Genie Code la carica e utilizza le indicazioni, i pattern e il codice che contiene per rispondere in modo appropriato.

Come aggiungere le skill?

Per iniziare:

1. Apri la cartella delle tue skill. In Genie Code, apri Impostazioni, vai su Skill utente e seleziona Apri cartella delle skill. In questo modo si aprirà la directory personale delle tue skill (/Users/{username}/.assistant/skills/).
2. Crea o aggiorna una skill. Aggiungi un nuovo file markdown. Ogni skill deve includere un nome e una descrizione chiari, in modo che Genie Code sappia quando applicarla. Puoi organizzare i file correlati in cartelle e, facoltativamente, includere script per flussi di lavoro più avanzati.

Skill del workspace

Oltre alle skill personali, gli amministratori del workspace possono creare skill che sono automaticamente disponibili per tutti gli utenti del workspace. Le skill del workspace si trovano in Workspace/.assistant/skills/.

Le skill del workspace seguono lo stesso formato di quelle personali, ma sono limitate al team anziché al singolo utente. Questo le rende ideali per i flussi di lavoro che devono essere condivisi e utilizzati in modo coerente in tutta l'organizzazione, ad esempio una skill che applica le convenzioni di denominazione delle pipeline ML, indirizza Genie Code al runbook interno corretto durante la gestione degli incidenti o applica i controlli standard di qualità dei dati del tuo team a ogni nuova pipeline.

Server MCP

Le skill riguardano il contesto che hai in mente o gli standard del tuo team. I server MCP riguardano invece il contesto che esiste già altrove.

All'inizio del 2025, abbiamo introdotto il supporto MCP in Databricks per rendere disponibile un contesto esterno ricco agli agenti AI in modo controllato e scalabile. L'MCP fornisce un modo standardizzato per esporre strumenti, dati e flussi di lavoro a Genie Code senza incorporare direttamente tale contesto nei prompt o nelle istruzioni.

Genie Code può ora sfruttare tutti i server MCP che sono stati aggiunti al tuo workspace e che hai l'autorizzazione a utilizzare. Gli amministratori del workspace controllano quali server sono disponibili, mentre gli utenti possono scegliere tra le fonti approvate in base alle proprie esigenze.

Per strumenti comuni come Google Drive, SharePoint e GitHub, Databricks offre anche flussi OAuth gestiti, attualmente in beta, che gestiscono l'autenticazione senza configurazione manuale dei token. Per abilitare questa opzione, attiva "Third Party Connectors for Agents" nelle tue impostazioni di anteprima. Da lì, qualsiasi utente può abilitare questi server MCP semplicemente facendo clic sul pulsante Più nella barra dei prompt di Genie Code.

L'MCP è progettato per i casi in cui esiste già un contesto importante, ma è difficile accedervi da Genie Code. Ad esempio:

• Sistemi di documentazione interna. I team spesso conservano runbook o documenti operativi in strumenti come Confluence. Invece di copiare sezioni nei prompt, tale contenuto può essere esposto una sola volta e richiamato quando pertinente.
• Strumenti e servizi interni. I team di piattaforma possono gestire API o script per la configurazione, la convalida o il deployment. L'MCP consente di rendere tali funzionalità direttamente disponibili per Genie Code, anziché doverle spiegare o incollare ripetutamente.

In questi casi, l'MCP sostituisce il copia e incolla manuale con un approccio strutturato e riutilizzabile, rendendo disponibile il contesto corretto solo quando necessario.

Come aggiungere i server MCP?

Databricks supporta diversi tipi di server MCP, tra cui server gestiti per i servizi Databricks, server esterni connessi tramite Unity Catalog e server MCP personalizzati ospitati su Databricks Apps. Puoi sfogliare i server disponibili nel marketplace MCP, accessibile direttamente dal pannello delle impostazioni di Genie Code. Gli amministratori del workspace controllano quali server sono disponibili e gli utenti possono scegliere tra i server che sono autorizzati a utilizzare.

Una volta che i server MCP sono disponibili nel tuo workspace, utilizzarli in Genie Code è semplicissimo:

1. Apri le impostazioni di Genie Code
2. Seleziona Aggiungi server
3. Scegli tra i tipi di server MCP disponibili
4. Salva la selezione
5. Se il server richiede l'autenticazione, segui le istruzioni di accesso per autorizzare la connessione. Le tue credenziali vengono memorizzate in modo sicuro e non dovrai ripetere l'autenticazione a ogni sessione.

I server MCP sono disponibili subito dopo l'aggiunta. Genie Code accede automaticamente agli strumenti di questi server quando pertinente.

Consigli e trucchi

• Lascia che Genie Code crei le skill per te. Dopo aver completato un flusso di lavoro in modalità agente, chiedi semplicemente a Genie Code di acquisirlo come skill; genererà il file markdown e lo salverà automaticamente nella cartella delle tue skill.
• Mantieni le skill focalizzate. Un solo flusso di lavoro per file di skill rende più facile per Genie Code capire quando applicarlo e semplifica la manutenzione nel tempo. Il nome e la descrizione sono gli elementi che Genie Code utilizza per decidere quando una skill è pertinente, quindi più sono specifici, meglio è.
• Le skill sono semplicemente file markdown. Ciò significa che sono facili da condividere, sottoporre a controllo di versione e sincronizzare all'interno del team. Per esempi pronti all'uso con cui iniziare, consulta il repository demo delle skill di Genie Code.
• Convenzioni del team portatili: Genie Code rileva automaticamente i file AGENTS.md e CLAUDE.md nel tuo workspace e li applica senza alcuna configurazione aggiuntiva. I team possono condividere le stesse convenzioni, istruzioni e flussi di lavoro tra diversi repository e ambienti di sviluppo, mantenendo il contesto coerente ovunque lavorino.

Prova a personalizzare Genie Code oggi stesso

Istruzioni, skill e server MCP sono tutti disponibili quando si utilizza Genie Code in modalità agente.

Per saperne di più, consulta la documentazione del prodotto per Genie Code.

(Questo post sul blog è stato tradotto utilizzando strumenti basati sull'intelligenza artificiale) Post originale