Estendere l'Assistente con le competenze dell'agente

Creare competenze per estendere Databricks Assistant 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 l'Assistente con funzionalità specializzate. Le competenze seguono lo standard aperto delle competenze dell'agente. Conoscenza e flussi di lavoro specifici del dominio di competenze che l'Assistente può caricare quando pertinente 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, Assistente carica automaticamente le competenze quando pertinente, in base alla richiesta e alla descrizione della competenza. In questo modo si mantiene una finestra di contesto efficiente e si riduce la necessità di fornire lo stesso contesto tra più chat.

Annotazioni

Le competenze sono supportate solo nella modalità agente di Databricks Assistant.

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

Databricks Assistant seleziona automaticamente le tue competenze al successivo uso in modalità agente.

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 da parte dell'Assistente quando viene applicata una competenza.
• Usare nomi e descrizioni chiari. Un nome conciso e descrittivo e un riepilogo aiutano l'Assistente ad abbinare la competenza corretta alla richiesta giusta.
• Essere espliciti e basati su esempio. Descrivere i flussi di lavoro in modo dettagliato e includere esempi concreti o modelli che l'Assistente 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.