Skill

Una skill contiene istruzioni che Annota Brain segue quando una richiesta corrisponde alla sua descrizione, come i passaggi di una procedura, il formato di una risposta o le regole del tuo studio. Le skill usano il formato aperto Agent Skills, quindi puoi scriverle nell’app o importarle.

Come Brain usa le skill

• Automaticamente. Brain vede il nome e la descrizione di ogni skill a tua disposizione. Quando una domanda corrisponde a una descrizione, Brain legge quella skill e la segue.
• Su richiesta. Puoi scegliere fino a 5 skill per una domanda. Vedi Usa una skill in una domanda.

Hai a disposizione le tue skill e quelle condivise con te. La risposta indica quali skill ha seguito Brain, per esempio Ha seguito la skill liquidazione-iva. Brain non esegue codice: legge solo file Markdown e di testo.

Crea una skill

1. In Brain apri Skill e seleziona Nuova skill.
2. Inserisci un Nome. Viene scritto in minuscolo con trattini mentre digiti, per esempio liquidazione-iva.
3. Inserisci una Descrizione: cosa fa la skill e quando Brain deve usarla. Brain si basa su questa per capire quando la skill è pertinente.
4. Scrivi le Istruzioni in Markdown.
5. Seleziona Crea skill. Si apre la pagina della skill.

Il nome può contenere lettere minuscole, numeri e trattini singoli, fino a 64 caratteri. La descrizione è obbligatoria e può avere fino a 1.024 caratteri. Ogni nome può essere usato una sola volta nell’organizzazione.

Importa skill

1. In Skill seleziona Importa.
2. Scegli un Archivio ZIP nel formato Agent Skills, con una cartella per ogni skill che contiene il suo SKILL.md.
3. Seleziona Importa.

Se hai già una skill con lo stesso nome, l’importazione la salva come nuova versione. Gli script e i file che non sono Markdown o testo semplice vengono esclusi, e l’app li elenca in Alcuni file non sono stati importati.

Aggiorna una skill

Per modificare una skill ne carichi una nuova versione.

1. Apri la skill e seleziona Carica nuova versione.
2. Scegli un archivio ZIP con la cartella della skill e il suo SKILL.md, oppure con SKILL.md nella radice.
3. Seleziona Importa. Il contenuto diventa la versione successiva.

Nella pagina della skill, Dettagli mostra chi l’ha creata, la Versione, la Versione condivisa e le date. In File puoi scegliere una versione, leggere ogni file come Anteprima o Sorgente e copiarlo.

Usa una skill in una domanda

1. Nella casella della domanda digita / all’inizio della domanda.
2. Scegli una skill con le frecce su e giù e premi Invio, oppure selezionala.
3. Completa la domanda e inviala.

Puoi anche selezionare Aggiungi (il pulsante +) e scegliere le skill in Skill. Le skill scelte valgono solo per quella domanda.

Per impedire a Brain di usare una skill che qualcuno ha condiviso con te, disattiva Usa nelle mie risposte nella skill o nell’elenco Skill. La modifica vale solo per le tue risposte.

Condividi una skill

Una skill è privata finché non la condividi.

1. Apri la skill e seleziona Condividi.
2. Aggiungi membri o gruppi in Membri e gruppi, oppure imposta Accesso dell’organizzazione per condividerla con tutti.
3. In Versione condivisa scegli quale versione vedono gli altri.
4. Seleziona Salva modifiche.

Chi riceve la condivisione può vedere la skill, e Brain usa la sua versione condivisa nelle risposte di queste persone. Quando la tua ultima versione è più recente di quella condivisa, l’elenco lo indica, per esempio Versione 3, condivisa la versione 2. In base alla policy di condivisione dell’organizzazione, solo proprietari e amministratori possono condividere con tutta l’organizzazione. Vedi Condivisione e accesso.

Elimina una skill

Apri la skill e, in Zona pericolosa, seleziona Elimina accanto a Elimina skill, poi conferma con Elimina skill. La skill e tutte le sue versioni vengono eliminate e Brain smette di usarla. Le risposte che l’hanno usata ne conservano il nome. Solo il proprietario oppure un proprietario o amministratore dell’organizzazione può eliminare una skill.

Limiti

Limite	Valore
Skill di tua proprietà	100
Skill condivise per organizzazione	50
File per skill	32
Dimensione per file	64 KB
Dimensione totale per skill	256 KB
Archivio di importazione	4 MB
Versioni conservate per skill	50 (salvandone un’altra si rimuove la più vecchia)
Skill scelte per una domanda	5

Consiglio

Scrivi una descrizione chiara e specifica. Brain sceglie le skill in base alla descrizione, quindi “Prepara la liquidazione IVA trimestrale dalle fatture” funziona meglio di “IVA”.

Passi successivi

• Fai domande
• Condivisione e accesso
• Fonti e citazioni