> ## Documentation Index
> Fetch the complete documentation index at: https://docs.libratech.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# Creare un Assistant personalizzato
> L'editor completo dell'Assistant: istruzioni del prompt, spunti di conversazione, risorse, conoscenza e condivisione.
Un Assistant si crea in un unico editor. Sulla sinistra, un pannello richiudibile **Configurazione Assistant** raccoglie tutto ciò che aiuta a ritrovare l'Assistant in un secondo momento: descrizione, area di pratica, tag, lingue. L'area principale è suddivisa in tre schede: **Configurazione e istruzioni**, **Risorse** e **Conoscenza**.
Solo due elementi sono obbligatori: un **nome** e le **istruzioni del prompt**. Tutto il resto è facoltativo e vengono applicati valori predefiniti ragionevoli.
Se nel Suo studio il caricamento dei documenti è disattivato, la scheda **Conoscenza** non viene mostrata affatto e l'editor presenta due schede anziché tre.
**Migliora con AI** affina istruzioni già scritte: resta disattivato finché il campo è vuoto. Scrivere prima una versione approssimativa, poi lasciare che Libra la perfezioni.
## Aprire l'editor
**Modelli** si trova nella sezione globale della barra laterale. La libreria si apre sulla scheda **Assistants**.
L'editor si apre a schermo intero su un nuovo Assistant senza titolo.
Il campo del titolo si trova in cima all'editor e riporta *Assistant senza titolo* finché non viene compilato. Mantenerlo breve e descrittivo: *"Revisore di contratti di lavoro (diritto tedesco)"*, *"Redattore di memo per clienti, rivolto ai soci"*.
## Il pannello Configurazione Assistant
Nessuno di questi campi modifica il modo in cui l'Assistant risponde. Determinano come Lei e i Suoi colleghi lo ritroverete in una libreria cresciuta fino a trenta Assistants.
| Campo | A cosa serve |
| ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Descrizione** | Facoltativa. Compare sulla scheda dell'Assistant nella libreria: la scriva quindi pensando al collega che non ha mai utilizzato questo Assistant. |
| **Area di pratica** | Facoltativa. Una o più voci dall'elenco fisso. Il filtro **Area di pratica** della libreria la utilizza. |
| **Tag** | Facoltativi. Selezionare tra i tag già in uso nel Suo studio oppure digitarne uno nuovo per crearlo. |
Vedere [Aree di pratica e tag](/it/features/templates/practice-areas-and-tags) per capire in cosa differiscono i due filtri.
### Versioni linguistiche
Un Assistant può contenere più di una versione linguistica. Il pannello di configurazione dispone di un campo **Lingua** che indica quella in corso di modifica; aprendolo si ottiene l'elenco delle versioni già presenti nell'Assistant, oltre a **Gestisci lingue** in fondo. Questa voce trasforma il menu in un elenco consultabile di tutte le lingue supportate da Libra: selezionare quelle desiderate e fare clic su **Applica selezioni**.
Nome, descrizione, istruzioni del prompt e spunti di conversazione sono tutti gestiti **per lingua**. Cambiando la lingua attiva, la scheda Configurazione e istruzioni mostra il contenuto di quella versione. Ogni lingua aggiunta necessita di un proprio nome e di proprie istruzioni del prompt prima che l'Assistant possa essere salvato; premendo **Salva** con una versione incompleta, un badge **Compila i campi obbligatori** segnala la lingua incompleta nel campo **Lingua** e nel relativo menu.
Ogni versione linguistica va scritta a mano. Aggiungendo una lingua e passando a essa, i suoi campi risultano vuoti: riportare il testo da una versione già scritta spetta a Lei.
## Configurazione e istruzioni
### Istruzioni del prompt
Il prompt di sistema, e l'unico campo che conta davvero. Una struttura in quattro parti funziona bene:
*"Lei è un avvocato esperto in diritto del lavoro presso uno studio legale commerciale tedesco. È specializzato in controversie di lavoro transfrontaliere."*
*"Il Suo compito è esaminare i contratti di lavoro e individuare le clausole che potrebbero essere inapplicabili ai sensi del diritto del lavoro tedesco. Produca un elenco strutturato dei rilievi."*
*"Per ogni rilievo, indicare: riferimento alla clausola, il problema riscontrato, il livello di rischio (Basso / Medio / Alto) e una raccomandazione di una frase."*
*"Non raccomandare mai la firma di un contratto con rilievi ad Alto rischio irrisolti. Concentrarsi esclusivamente sul diritto tedesco; se il contratto riguarda più giurisdizioni, segnalarlo senza analizzare le altre giurisdizioni."*
Sopra il campo si trovano due pulsanti con icona. **Migliora con AI** riscrive le istruzioni attualmente presenti nel campo: non è in grado di redigere da zero ed è disattivato finché non c'è testo su cui lavorare. **Registra voce** consente di dettare anziché digitare.
Esiste una lunghezza massima del prompt: Libra segnala quando è stata superata e blocca il salvataggio finché il prompt non viene accorciato.
È possibile trascinare un file `.txt` o `.md` direttamente sul campo del prompt, oppure incollarne un link, e il relativo testo sostituisce il prompt. Se l'Assistant non ha ancora un nome e il file si apre con un titolo Markdown, quel titolo diventa il nome dell'Assistant.
### Spunti di conversazione
Prompt di esempio facoltativi che compaiono come pulsanti cliccabili quando qualcuno apre una chat con l'Assistant. Fare clic su **Aggiungi** per ciascuno; ogni riga dispone dei propri pulsanti **Migliora con AI** e di rimozione. Gli spunti sono il modo più rapido per mostrare a un collega a cosa serve realmente l'Assistant.
## Risorse
### Modello
Il modello di base che risponde al prompt, per impostazione predefinita **Libra AI**. Lasciarlo invariato, a meno che non vi sia una ragione specifica per vincolare l'Assistant a un modello particolare.
Questo *non* coincide con i livelli **Standard** / **Deep Thinking** / **Fast**. Questi ultimi si scelgono per ogni chat nel compositore e non possono essere preimpostati su un Assistant — vedere [Modalità Chat](/it/features/chat/modes).
### Fonti di ricerca
La preselezione delle fonti di ricerca è ciò che trasforma un Assistant generico in uno *specifico per giurisdizione*. Quando qualcuno seleziona l'Assistant nella chat, Libra attiva automaticamente la Ricerca con esattamente quelle fonti: nessuno deve ricordare quali database richiede la domanda.
Un *"Ricercatore di diritto del lavoro svizzero"* con Fedlex ed Entscheidsuche preimpostati; un *"Redattore di memo fiscali tedeschi"* con Wolters Kluwer Online e Verlag Dr. Otto Schmidt preimpostati. L'utente digita la domanda, l'Assistant porta il database giusto.
**Fonti di ricerca** è il primo blocco della scheda.
Il menu a tendina **Giurisdizioni** in cima al blocco filtra ciò che viene proposto. Selezionare uno o più paesi e la griglia sottostante si popola con le fonti disponibili. Finché non viene scelta una giurisdizione con fonti disponibili, il blocco riporta *"Nessuna fonte di ricerca collegata"*: è uno stato, non un pulsante.
Ogni fonte è una scheda con un interruttore sulla destra. **Verlag Dr. Otto Schmidt** presenta un ulteriore chip **Seleziona moduli**, poiché l'accesso ai moduli è concesso in licenza per team.
La selezione viaggia insieme all'Assistant. Chiunque lo esegua ottiene la Ricerca attivata con quelle fonti attive.
Le fonti visualizzate dipendono dalle giurisdizioni e dagli abbonamenti del Suo studio, quindi due colleghi possono vedere elenchi diversi. Vedere [Modalità di ricerca](/it/features/chat/research-mode) per il quadro completo.
La preselezione è un *valore predefinito*, non un vincolo: chi esegue l'Assistant può comunque disattivare la Ricerca o scegliere un diverso insieme di fonti per un singolo messaggio.
## Conoscenza
I documenti di conoscenza sono il materiale di riferimento a cui l'Assistant attinge. Vanno intesi come il pacchetto di onboarding che si fornirebbe a un collaboratore junior.
| Cosa includere | Esempi |
| ---------------------------------- | --------------------------------------------------------------------------------------------- |
| **Modelli ed esempi** | Il modello NDA standard del Suo studio, un memo di esempio nel formato corretto. |
| **Linee guida interne** | La guida allo stile redazionale interno, la policy di revisione dello studio. |
| **Materiali di riferimento** | Le leggi rilevanti, i commentari più citati sull'argomento. |
| **Contesto specifico del cliente** | Quando l'Assistant è dedicato a un cliente specifico, gli accordi precedenti di quel cliente. |
La scheda è un browser di documenti, non un selettore da aprire. Elenca i **File progetto** del progetto in cui si sta lavorando, con un contatore in alto che indica quanti documenti l'Assistant contiene già.
Utilizzare **Cerca documenti** oppure espandere le cartelle nell'albero. Per inserire un elemento non ancora presente nel progetto, fare clic su **Carica** e scegliere **Carica documento** o **Carica cartella**: il file finisce contemporaneamente nei File progetto del progetto e nell'elenco.
Selezionare le righe desiderate e fare clic su **Aggiungi all'assistant**. **Cancella selezione** azzera la scelta. È possibile aggiungere solo i documenti completamente elaborati e un documento già presente nell'elenco viene rifiutato come duplicato.
La conoscenza dell'Assistant viene allegata a ogni chat che lo utilizza e incide sullo stesso limite di documenti per chat dei file allegati manualmente. Quando una risposta attinge a uno di questi documenti, esso compare nel pannello **Fonti** come qualsiasi altro documento — vedere [Citazioni e fonti](/it/features/chat/citations).
## Salvare, eseguire, condividere
In un Assistant nuovo il pulsante principale riporta **Salva**. Una volta creato, il pulsante principale diventa **Esegui** — che porta direttamente in una chat con l'Assistant collegato — e **Salva** si sposta accanto a esso. Il salvataggio è bloccato finché ogni lingua configurata non dispone sia di un nome sia delle istruzioni del prompt.
**Duplica**, **Condividi**, **Elimina** e l'interruttore dei preferiti compaiono nella barra degli strumenti solo dopo il salvataggio dell'Assistant, e solo per gli Assistants sui quali si dispone dei relativi diritti. Se Lei è l'unico membro del Suo team, **Condividi** scompare oppure si trasforma in un invito all'upgrade, a seconda del piano sottoscritto.
Nella barra degli strumenti dell'editor.
**Solo le persone invitate** lo limita alle persone indicate. **Tutti nel team** lo apre all'intero studio.
Digitare un nome, un'e-mail o un gruppo nel campo **Condividi con**, selezionare l'autorizzazione dal menu a tendina accanto, quindi fare clic su **Aggiungi**. Compariranno sotto **Chi ha accesso**.
**Sola visualizzazione** per i colleghi che si limitano a eseguire l'Assistant, **Modifica** per chi lo gestisce, **Accesso completo** per i co-proprietari che amministrano anche la condivisione. Nel menu a tendina queste voci compaiono come *Può visualizzare*, *Può modificare* e *Accesso completo*.
Se l'Assistant è utilizzato da Workflows condivisi con il Suo team, restringerne la condivisione revoca l'accesso di tali Workflows. Libra indica i Workflows interessati e chiede conferma prima del salvataggio.
Vedere [Preferiti e condivisione](/it/features/templates/starring-and-sharing) per il modello di condivisione completo.
## Testare prima di fidarsi
Non convalidare un Assistant su un'unica prova.
Scegliere tre pratiche o scenari reali per i quali si utilizzerebbe l'Assistant, non ipotesi di scuola.
| Domanda | Cosa verificare |
| ---------------------------- | ------------------------------------------------------------------------------------------------------ |
| Comprende il compito? | L'Assistant sta effettivamente facendo quanto richiesto o interpreta il prompt in modo approssimativo? |
| Il formato è corretto? | L'output corrisponde al formato specificato? |
| Ha utilizzato la conoscenza? | Se sono stati aggiunti documenti di riferimento, vengono citati? |
| È rimasto nell'ambito? | Ha rispettato i vincoli o si è spinto verso argomenti collaterali? |
Affinare la formulazione, aggiungere il vincolo mancante, precisare il formato. Sono da mettere in conto diverse iterazioni prima che un Assistant risulti solido.
## Gestire gli Assistants esistenti
| Azione | Come |
| ------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Modifica** | Aprire l'Assistant dalla libreria dei Modelli. Quelli sui quali si dispone dei diritti di modifica si aprono direttamente nell'editor; quelli condivisi con Lei come **Sola visualizzazione** si aprono in una vista di dettaglio in sola lettura. |
| **Duplica** | Dalla barra degli strumenti dell'editor oppure dal menu **…** sulla scheda. La copia assume il nome dell'originale con l'aggiunta di *(Copia)* e appartiene a Lei: è il modo per creare una variante dell'Assistant di un collega. |
| **Elimina** | Dalla barra degli strumenti dell'editor oppure dal menu **…** sulla scheda, quindi confermare. L'eliminazione non può essere annullata. Libra avvisa preventivamente se l'Assistant è condiviso ed elenca gli eventuali Workflows che lo perderanno. |
## Suggerimenti per istruzioni efficaci
*"Revisionare il contratto"* è troppo vago. *"Revisionare il contratto caricato per individuare le clausole di risoluzione, di limitazione della responsabilità e di cessione della proprietà intellettuale, segnalando quelle che si discostano dal nostro standard"* è qualcosa su cui l'Assistant può agire concretamente.
*"Produrre un elenco numerato con tre sezioni: Rischi / Raccomandazioni / Questioni aperte."* Il formato non è un'impostazione a sé stante: se non compare nelle istruzioni, si ottiene ciò che il modello produce per impostazione predefinita.
Per i compiti che richiedono una categorizzazione, includere esempi nelle istruzioni. *"Trattare 'shall' e 'must' come vincolanti; trattare 'should' e 'may' come discrezionali."*
*"Non fornire mai consulenza in materia fiscale. Non citare mai informazioni specifiche del cliente tratte da pratiche passate."* I vincoli espliciti prevengono le derive.
Indicare all'Assistant come comportarsi quando i documenti di riferimento non coprono la domanda: segnalare la lacuna oppure ripiegare sulle proprie fonti di ricerca. In caso contrario improvviserà.
## Prossimi passi
La panoramica concettuale.
Collegare gli Assistants in sequenza per procedure articolate in più fasi.
