Creare e gestire skill

Le skill sono istruzioni personalizzate riutilizzabili che aiutano l'assistente Gemini Enterprise a eseguire attività specifiche, come la revisione di contratti legali o la scrittura con la voce del tuo brand.

Ogni skill è un pacchetto contenente un file di prompt SKILL.md. Un pacchetto di skill può anche includere script, file o contesto di background che l'assistente utilizza per completare un'attività. Per impostazione predefinita, Gemini Enterprise attiva le skill che crei.

Versioni supportate

La possibilità di creare, caricare o utilizzare le skill dipende dalla versione di Gemini Enterprise a cui hai eseguito l'abbonamento:

  • Standard, Plus e pagamento a consumo: puoi creare e caricare skill personalizzate e utilizzare skill gestite da Google e skill create dagli utenti e condivise con te.
  • Frontline: puoi sfogliare, installare e utilizzare le skill gestite da Google e quelle create dagli utenti e condivise con te. Non puoi creare o caricare skill personalizzate.

Panoramica

Gli aspetti chiave delle skill includono:

  • Standard aperto: basata sullo standard delle skill aperto, ogni skill è definita da un file SKILL.md principale e può essere estesa con file o script aggiuntivi.
  • Estensione modulare: le skill ti consentono di insegnare a un agente attività specifiche del dominio utilizzando istruzioni e contesto personalizzati.
  • Accesso dinamico:Gemini Enterprise accede automaticamente a queste istruzioni specializzate quando sono pertinenti alla tua domanda o attività.

Crea una skill

Per creare una nuova skill nell'app web Gemini Enterprise, segui questi passaggi:

  1. Accedi all'app web Gemini Enterprise.
  2. Nel menu di navigazione, fai clic su Competenze.
  3. Fai clic sull'icona Aggiungi e poi su Crea skill con Gemini.
  4. Inserisci un nome per la skill.
  5. Inserisci una descrizione. Gemini Enterprise utilizza la descrizione per determinare se la skill può essere utile per un prompt o un'attività. Puoi anche aggiungere istruzioni di attivazione alla descrizione per aiutare Gemini Enterprise.
  6. Fornisci le istruzioni per lo skill utilizzando il linguaggio naturale nella finestra di chat o nel campo Istruzioni. Per creare una skill utilizzando un file SKILL.md esistente con front matter Markdown o YAML personalizzato, consulta Carica una skill.
  7. Fai clic su Salva. Gemini Enterprise attiva la nuova skill per impostazione predefinita.

Carica una skill

Per aggiungere skill esistenti, caricale come file Markdown o ZIP. Gemini Enterprise estrae automaticamente il nome e la descrizione della skill dal file SKILL.md.

Formato file e struttura delle directory delle skill

Un pacchetto di skill è costituito da un file di prompt SKILL.md obbligatorio e da sottodirectory facoltative per script, documentazione di riferimento e asset. Puoi caricare un file SKILL.md autonomo o un file ZIP con la seguente struttura di directory:

my-skill/
├── SKILL.md              # Required: YAML frontmatter + Markdown instructions
├── scripts/              # Optional: executable helper scripts (Python, Bash)
├── references/           # Optional: supplementary context loaded as needed
└── assets/               # Optional: templates or images used in output
File o directory Obbligatorio Descrizione
SKILL.md Sì Contiene i metadati del frontmatter YAML della skill (come name e description) seguiti dalle istruzioni Markdown che guidano l'assistente Gemini Enterprise.
scripts/ No Script helper Python o Bash eseguibili per operazioni deterministiche o ripetute.
references/ No Contesto supplementare caricato on demand, come schemi, cheat sheet o documentazione di riferimento dell'API.
assets/ No File utilizzati nell'output (come modelli o immagini) che non vengono caricati direttamente nel contesto del prompt di Gemini Enterprise.

Requisiti del frontmatter YAML

Il file SKILL.md deve iniziare con un blocco frontmatter YAML valido racchiuso tra i delimitatori --- all'inizio del file, seguito dal corpo delle istruzioni Markdown (limite massimo di 500.000 caratteri; i caricamenti che superano questo limite non vanno a buon fine).

Il frontmatter YAML supporta i seguenti campi:

Campo Obbligatorio Formato e vincoli
name Sì Un identificatore univoco per la competenza (da 1 a 64 caratteri). Deve contenere solo lettere minuscole (a-z), numeri (0-9) e trattini (-). Non deve iniziare o terminare con un trattino (-) o contenere trattini consecutivi (--). Se caricato all'interno di una cartella, il valore name deve corrispondere al nome della cartella principale.
description Sì Una descrizione funzionale (da 1 a 1024 caratteri) che spiega cosa fa la skill e quando Gemini Enterprise deve richiamarla. Includi parole chiave di attivazione per aiutare Gemini Enterprise a identificare quando la skill è pertinente. Questo è un limite rigido; se la descrizione supera i 1024 caratteri, il caricamento della skill non va a buon fine e viene visualizzato l'errore: A field in your SKILL.md is too long. Shorten the name, description or the instructions.
license No La licenza di distribuzione di software o contenuti che si applica al pacchetto di competenze (fino a 1024 caratteri), ad esempio un identificatore di licenza SPDX open source (ad esempio, Apache-2.0 o MIT) o Proprietary. Questo campo specifica i termini di utilizzo del file dello skill stesso, non una licenza di abbonamento utente aziendale o app Gemini Enterprise. Se specificato, il valore non deve essere vuoto.
metadata No Una mappa chiave-valore facoltativa di tag personalizzati, autori o parametri di versione. Le chiavi devono essere stringhe scalari e i valori devono essere stringhe scalari o elenchi di stringhe scalari.

File SKILL.md di esempio

Nell'esempio seguente è riportato un file SKILL.md valido:

---
name: brand-voice-reviewer
description: Reviews marketing copy and legal contracts to ensure compliance with brand voice guidelines. Use when asked to review, edit, or draft customer-facing text.
---

# Brand Voice Reviewer

Follow these guidelines when reviewing or drafting customer-facing text:

1. Use clear, concise, and active language.
2. Avoid jargon and unverified claims.
3. Verify that terminology aligns with the company style guide.

Vincoli per i file ZIP

Quando carichi una skill come file ZIP, assicurati che l'archivio soddisfi i seguenti requisiti di convalida:

  • Un singolo file SKILL.md:ogni file ZIP deve contenere esattamente un file SKILL.md situato nella directory principale del file ZIP (SKILL.md) o all'interno di una singola cartella wrapper di primo livello (fino a 3 livelli di profondità, ad esempio my-skill/SKILL.md).
  • Dimensioni dell'archivio: dimensioni massime del file ZIP compresso di 100 MB e dimensioni massime totali non compresse di 100 MB.
  • Numero di file: massimo 100 file per file ZIP.
  • Profondità di nidificazione delle directory:profondità massima di nidificazione delle directory di 10 livelli rispetto alla directory root della skill.
  • Integrità del percorso:non sono consentiti percorsi di file duplicati e riferimenti alla directory principale (..).

Carica una skill nell'app web

Per caricare una skill, segui questi passaggi:

  1. Accedi all'app web Gemini Enterprise.
  2. Nel menu di navigazione, fai clic su Competenze.
  3. Fai clic sull'icona Aggiungi e poi su Carica skill.
  4. Trascina o sfoglia il file Markdown o file ZIP e fai clic su Importa. Gemini Enterprise attiva la skill per impostazione predefinita.

Sfoglia skill

Puoi sfogliare e installare le skill utilizzando le seguenti sezioni per filtrare l'elenco:

Sezione Descrizione
Tutti Sia le skill gestite da Google sia quelle create dagli utenti.
Google Skill integrate fornite da Google.
Condivisi con me Skill di sola lettura create da altri utenti e condivise con te.

Per sfogliare e installare una skill, segui questi passaggi:

  1. Accedi all'app web Gemini Enterprise.
  2. Nel menu di navigazione, fai clic su Competenze.
  3. Fai clic sull'icona Aggiungi e poi su Sfoglia competenze.
  4. Trova la skill che vuoi utilizzare e fai clic su + Installa.

Aggiorna una skill

Per aggiornare una competenza esistente, segui questi passaggi:

  1. Accedi all'app web Gemini Enterprise.
  2. Nel menu di navigazione, fai clic su Competenze.
  3. Fai clic sul nome della skill che vuoi aggiornare.
  4. Fai clic sull'icona accanto alla skill e poi su Modifica.
  5. Apporta gli aggiornamenti necessari alle istruzioni, al nome o alla descrizione.
  6. Fai clic su Salva.

Per tornare alla pagina Skill, fai clic su Skill.

Condividi una skill

Se l'amministratore di Gemini Enterprise attiva la condivisione delle skill, puoi condividere le skill che crei con altri utenti.

Per condividere una skill, segui questi passaggi:

  1. Accedi all'app web Gemini Enterprise.
  2. Nel menu di navigazione, fai clic su Competenze.
  3. Trova la skill che hai creato e che vuoi condividere.
  4. Fai clic sull'icona accanto alla skill e poi su Condividi.
  5. Nella finestra di dialogo Condividi skill, inserisci gli indirizzi email separati da virgole degli utenti con cui vuoi condividere la skill.
  6. Fai clic su Fine.

Usa una skill

Puoi utilizzare le skill direttamente nelle tue conversazioni in chat nell'app web Gemini Enterprise.

Testa una skill dalla pagina Skill

Puoi testare una skill direttamente dalla pagina Skill avviando una nuova sessione di chat con quella skill:

  1. Accedi all'app web Gemini Enterprise.
  2. Nel menu di navigazione, fai clic su Competenze.
  3. Fai clic sull'icona accanto alla skill e poi su Nuova chat. Gemini Enterprise apre una nuova chat che fa riferimento alla skill selezionata.

Richiama una skill in una conversazione

Puoi richiamare le skill in modo dinamico durante una conversazione per personalizzare le risposte dell'assistente.

Quando interagisci con l'assistente Gemini Enterprise, puoi utilizzare le skill nei seguenti modi:

  • Menzioni manuali: puoi richiamare esplicitamente una skill utilizzando la funzionalità di menzione @ o / nella casella della chat (ad esempio, @Brand Voice o /Brand Voice). Digitando / si apre un menu che mostra solo le skill disponibili, mentre digitando @ si apre il menu delle menzioni generali.
  • Richieste dirette: se hai bisogno che Gemini Enterprise utilizzi una skill specifica, puoi richiederla direttamente nel prompt. Ad esempio, Use the brand voice skill to review this.
  • Selezione automatica:Gemini Enterprise utilizza automaticamente una skill quando è pertinente alla tua attività in base alla descrizione e alle istruzioni di attivazione della skill.

Disattiva una skill

Per impedire a Gemini Enterprise di utilizzare una skill specifica, disattivala. Quando disattivi una skill, Gemini Enterprise non la richiama nelle conversazioni.

Per disattivare una skill:

  1. Accedi all'app web Gemini Enterprise.
  2. Nel menu di navigazione, fai clic su Competenze.
  3. Nella pagina Skill, trova la skill che vuoi disattivare.
  4. Fai clic sul pulsante di attivazione/disattivazione accanto alla skill per impostarlo su Off.

Disinstalla una skill

Per rimuovere una skill installata dalla pagina Skill, segui questi passaggi:

  1. Accedi all'app web Gemini Enterprise.
  2. Nel menu di navigazione, fai clic su Competenze.
  3. Fai clic sull'icona accanto alla skill e poi su Disinstalla.

Stati delle skill

Oltre ad attivare o disattivare le skill, l'amministratore può modificare lo stato di una skill, il che influisce sulla sua disponibilità:

  • Sospesa:l'amministratore disattiva temporaneamente la skill. Rimane visibile nella pagina Skill con lo stato Sospesa, ma gli altri utenti non possono richiamarla nelle conversazioni finché l'amministratore non la riattiva. I proprietari delle skill possono aggiornare e testare la skill.
  • Disattivata: l'amministratore nasconde temporaneamente la skill agli altri utenti, rimuovendola dalla loro pagina Skill. La skill rimane visibile al proprietario, che può aggiornarla e testarla finché l'amministratore non la riattiva.
  • Eliminata: l'amministratore rimuove definitivamente la skill dall'app web Gemini Enterprise, quindi non puoi più utilizzarla.

Limitazioni

Questa sezione elenca le limitazioni per le skill in Gemini Enterprise:

  • Le skill non sono disponibili per l'utilizzo con gli agenti.
  • Le skill supportano solo l'esecuzione di Python e Bash.
  • L'editor dell'app web ti consente di creare skill inserendo istruzioni nei campi del modulo o chattando con l'assistente, che genera automaticamente un singolo fileSKILL.md. Devi caricare skill più complesse che richiedono script o file aggiuntivi come file ZIP.
  • La creazione di skill in linguaggio naturale non utilizza il contesto della conversazione o i connettori come input per creare una skill.
  • Le skill funzionano meglio con Canvas quando una skill ha un solo file SKILL.md.
  • Un file SKILL.md ha limiti di lunghezza rigidi di 64 caratteri per name, 1024 caratteri per description e 500.000 caratteri per il corpo delle istruzioni Markdown. I file ZIP caricati non possono superare i 100 MB (compressi o non compressi), i 100 file o i 10 livelli di nidificazione delle directory.

Passaggi successivi