Condividi tramite

Estendere Genie Code con le competenze dell'agente

Genie Code include competenze predefinite e preconfigurate per i flussi di lavoro comuni di Azure Databricks, come la scrittura di codice nei notebook di Azure Databricks, l'esplorazione dei dati nel Catalogo Unity, la creazione di dashboard, la costruzione di pipeline e l'uso di MLflow. È anche possibile creare competenze personalizzate per estendere Genie Code in modalità agente con funzionalità specializzate per le attività specifiche del dominio. Questa pagina illustra come creare e ottimizzare le competenze.

Che cosa sono le competenze?

Creare competenze per estendere Genie Code con funzionalità specializzate. Le competenze seguono lo standard aperto delle competenze dell'agente. Conoscenze specifiche del dominio e flussi di lavoro che il Genie Code può caricare quando rilevante per eseguire attività specifiche. Le competenze possono includere indicazioni, procedure consigliate, codice riutilizzabile e script eseguibili.

Le competenze devono essere personalizzate per le attività specifiche del dominio. Con le competenze, è possibile fornire un contesto maggiore (ad esempio script, esempi e altre risorse) per un'attività rispetto alle istruzioni. A differenza delle istruzioni personalizzate, applicate a livello globale, le competenze vengono caricate automaticamente e solo nel contesto pertinente. In modalità agente, Genie Code carica automaticamente le competenze quando pertinente, in base alla richiesta e alla descrizione della competenza. È anche possibile richiamare manualmente le competenze @ menzionandole. In questo modo si mantiene una finestra di contesto efficiente e si riduce la necessità di fornire lo stesso contesto tra più chat.

Esistono due tipi di competenze:

  • Competenze dell'area di lavoro: disponibile per tutti gli utenti dell'area di lavoro. Gli amministratori dell'area di lavoro possono creare competenze dell'area di lavoro e concedere ad altri utenti l'accesso alla cartella skills per aggiungere altro. Usare le competenze dell'area di lavoro per i flussi di lavoro che sono ampiamente utili all'interno del team, ad esempio flussi di lavoro di Machine Learning o processi specifici del dominio.
  • Competenze utente: disponibile solo per l'utente. Usare le competenze utente per i flussi di lavoro personali che non sono rilevanti per altri membri dell'area di lavoro.

Annotazioni

Le competenze sono supportate solo nella modalità agente del codice Genie.

Creare una competenza

Le competenze si trovano in una .assistant/skills/ directory. Ogni abilità deve avere una propria cartella e un file SKILL.md all'interno di tale cartella. La posizione dipende dal tipo di competenza:

  • Competenze dell'area di lavoro: Workspace/.assistant/skills/
  • Competenze utente: /Users/{username}/.assistant/skills/

Per creare una nuova competenza:

  1. Creare una nuova cartella di competenze nel percorso appropriato per il tipo di competenza.

    Dopo la creazione, è possibile accedere rapidamente alla cartella skills nel pannello Genie Code. Fare clic sull'icona a forma di ingranaggio. Impostazioni, quindi fare clic su Freccia nell'icona. Aprire la cartella skills.

  2. Creare una cartella dedicata per la competenza all'interno della cartella skills. Ogni competenza deve avere una propria cartella. Per esempio:

    Workspace/.assistant/skills/
└── ml-workflows/
    └── SKILL.md

/Users/{username}/.assistant/skills/
└── personal-workflows/
    └── SKILL.md

  3. All'interno della cartella dell'abilità, crea un file SKILL.md. Questo file è obbligatorio e definisce la competenza. Le competenze seguono le specifiche delle competenze dell'agente.

  4. Aggiungi il frontmatter necessario per la tua funzionalità:

    ---
name: skill-name
description: A description of what this skill does and when to use it.
---

  5. Aggiungere le istruzioni della skill in formato Markdown dopo il frontmatter. È consigliabile includere le sezioni seguenti:

    • Istruzioni dettagliate: Chiare indicazioni procedurali
    • Esempi: input di esempio e output previsti
    • Casi limite: varianti ed eccezioni comuni

  6. (Facoltativo) Per competenze più complesse, è possibile fornire e fare riferimento a risorse aggiuntive:

    • Script contenenti codice eseguibile che l'agente può eseguire.
    • File contenenti documentazione aggiuntiva a cui fare riferimento, ad esempio procedure consigliate e modelli.

    Quando si fa riferimento ad altri file, usare percorsi relativi dalla radice della skill.

    Ad esempio, una competenza del flusso di lavoro di Machine Learning dell'area di lavoro e una competenza del flusso di lavoro personale possono avere la struttura seguente:

    Workspace/.assistant/skills/
├── ml-workflows/
   ├── SKILL.md                # Workflow overview and best practices
   ├── training-patterns.md    # Standard ML training patterns
   └── scripts/
         └── model-deploy.py   # Model deployment automation

/Users/{username}/.assistant/skills/
├── personal-workflows/
   ├── SKILL.md                # Workflow overview and best practices
   ├── etl-patterns.md         # Personal ETL best practices
   ├── dashboard-templates.md   # Reusable dashboard patterns
   └── scripts/
         └── pipeline-setup.sh   # Environment setup scripts

Genie Code raccoglie automaticamente le tue competenze la prossima volta che la usi in modalità agente. È anche @ possibile menzionare le competenze per assicurarsi che Genie Code li usi.

Procedure consigliate

Seguire queste linee guida per scrivere abilità efficaci:

  • Scegliere il tipo di competenza appropriato. Usare le competenze dell'area di lavoro per i flussi di lavoro che traggono vantaggio da molti utenti, ad esempio pipeline di Machine Learning condivise o processi specifici del dominio. Usare le competenze utente per i flussi di lavoro personali che non sono rilevanti per altri utenti.
  • Mantenere incentrate le competenze. Le competenze funzionano meglio quando si concentrano su una singola attività o flusso di lavoro. L'ambito ristretto semplifica il riconoscimento di Genie Code quando viene applicata una competenza.
  • Usare nomi e descrizioni chiari. Un nome conciso e descrittivo e la guida di riepilogo Genie Code corrispondono alla competenza corretta alla richiesta corretta.
  • Essere espliciti e basati su esempio. Descrivere i flussi di lavoro in modo dettagliato e includere esempi concreti o modelli che il codice Genie può riutilizzare.
  • Evitare il contesto non necessario. Includere solo le informazioni necessarie per l'attività. Dettagli aggiuntivi possono rendere le competenze più difficili da applicare in modo affidabile.
  • Iterare nel tempo. Considera le competenze come flussi di lavoro viventi. Gli aggiornamenti di piccole dimensioni basati sull'utilizzo reale possono migliorare significativamente i risultati.
  • Separare le linee guida dall'automazione. Usare markdown per spiegare le procedure consigliate e le finalità e gli script per le azioni ripetibili. Mantenere questi problemi distinti rende le competenze più facili da gestire e riutilizzare.
  • Gestisci le tue competenze. Effettua il backup della cartella delle competenze con le cartelle Git di Databricks per tenere traccia delle modifiche, collaborare con i colleghi e a eseguire un rollback quando necessario.

Vedere anche

  • Last updated on