Estendere Genie Code con le competenze dell'agente

Creare competenze 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.

Creare una competenza

Le competenze si trovano nella /Users/{username}/.assistant/skills/ directory. Ogni abilità deve avere una propria cartella e un file SKILL.md all'interno di tale cartella.

Per creare una nuova competenza:

1. Nella cartella dell'area di lavoro utente creare una nuova cartella di competenze. Il percorso della cartella deve essere: /Users/{username}/.assistant/skills/.

   Dopo la creazione, è possibile accedere rapidamente a questa cartella nel pannello Genie Code. Fare clic Impostazioni, quindi fare clic su Aprire la cartella skills.

2. Creare una cartella dedicata per la competenza all'interno della cartella skills. Ogni competenza deve avere una propria cartella. Ad esempio, se si sta creando una competenza per i flussi di lavoro personali, la struttura delle cartelle potrebbe essere:

   /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, si potrebbe avere una competenza del flusso di lavoro personale che fa riferimento a procedure consigliate ETL, modelli di dashboard e script per la configurazione e la distribuzione della pipeline. La cartella della competenza può includere i file seguenti:

   /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
            └── model-deploy.py     # Model deployment automation
   

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:

• 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.

Vedere anche

• Suggerimenti per migliorare le risposte al codice Genie: informazioni su come fare riferimento manualmente alle competenze nella richiesta di chat.