# Operatore DocBits
## Panoramica
Il **DocBits Operator** è un assistente di automazione alimentato da intelligenza artificiale progettato per semplificare compiti ripetitivi nei tuoi flussi di lavoro. Gli utenti creano *prompts* - istruzioni passo dopo passo potenziate con variabili - che guidano l'IA a navigare, inserire dati e fare clic attraverso le interfacce automaticamente. Ciò riduce lo sforzo manuale e velocizza le operazioni di routine.
## Abilitazione del DocBits Operator
Per abilitare il DocBits Operator, seguire questi passaggi:
1. **Naviga nelle Impostazioni**:
* Dal Dashboard, vai su **Impostazioni**.
* Seleziona **Elaborazione Documenti** e quindi scegli **Modulo**.
2. **Abilita la Funzionalità**:
* Scorri verso il basso per individuare l'opzione **DocBits Operator**.
* Attiva lo slider per abilitare il **DocBits Operator**.
## Accesso all'Interfaccia
* Una volta abilitata la funzionalità, apri il **DocBits Operator** dal menu di navigazione principale.
### **1. Inserimento del Prompt**
In fondo allo schermo, c'è un campo di input denominato *"Inserisci qui il tuo prompt..."*. Qui gli utenti scrivono le istruzioni affinché l'operatore le segua.
Accanto al campo di input ci sono diversi pulsanti di controllo:
* **Variabili del Prompt** – Apre un popup dove è possibile inserire coppie chiave-valore utilizzate nel prompt. Le variabili sono scritte tra parentesi graffe, come `{numero_fattura}` o `{url}`. Questi valori si applicano solo al prompt corrente nel campo di input.
* **Salva Prompt** – Salva il prompt corrente. Scegli di salvarlo come:
* **Prompt dell'Organizzazione** – Modificabile all'interno della tua organizzazione; include sia il prompt che i valori delle variabili definite.
* **Prompt Globale** – Condiviso tra tutti i tenant; include solo il prompt e i segnaposto delle variabili (non vengono salvati valori).
* **Cancella Chat** – Cancella la conversazione attuale con l'operatore, ma lascia il prompt nel campo di input invariato. Utile quando si riutilizza o si perfeziona un prompt.
Per una guida dettagliata su come scrivere prompt efficaci, inclusa la sintassi, le variabili e gli esempi, consultare la [**Guida alla Scrittura del Prompt**](https://docs-it.docbits.com/advanced-functions-and-tools/docbits-operator/prompt-writing-guide).
### **2. Navigazione della Barra Laterale**
Usa l'icona in alto a sinistra per aprire o chiudere la barra laterale. La barra laterale mostra i prompt salvati, organizzati in due categorie:
* **Prompt dell'Organizzazione**: Modificabili e riutilizzabili all'interno della tua organizzazione.
* **Prompt Globali**: Condivisi tra tutti i tenant. Questi non possono memorizzare variabili e non possono essere modificati o eliminati.
* Un prompt globale è comunque modificabile ed eliminabile dall'**organizzazione che lo ha creato**, dove compare sotto i Prompt dell'Organizzazione.
* **Funzionalità di Ricerca**: una barra di ricerca in alto alla barra laterale consente agli utenti di trovare rapidamente i prompt salvati per nome o parola chiave.
* **Riferimento Icona**: Ogni prompt salvato ha un insieme di icone di azione
* **Freccia** – Avvia il prompt
* **Penna** – Modifica il prompt (disponibile solo per i prompt della tua organizzazione)
* **Cestino** – Elimina il prompt (disponibile solo per i prompt della tua organizzazione)
### 3. Salva Prompt
Cliccando il pulsante **Salva Prompt** si apre un popup dove è possibile salvare il prompt corrente per un uso futuro.
#### **Campi del Popup Salva Prompt**
* **Nome del Prompt:** Inserisci un nome per identificare il prompt.
* **Salva Prompt Pubblicamente (Checkbox):** Quando selezionato, il prompt verrà salvato come **Prompt Globale**. I Prompt Globali sono condivisi tra tutti i tenant e non possono memorizzare **valori** variabili (solo **nomi** variabili).
* **Modifica Variabili:** Apre il [**Popup Variabili del Prompt**](https://docs-it.docbits.com/advanced-functions-and-tools/docbits-operator/prompt-writing-guide) per rivedere o regolare le definizioni delle variabili prima di salvare.
**Azioni**
* **Annulla:** Chiude il popup senza salvare.
* **Salva:** Salva il prompt utilizzando il nome specificato e l'impostazione di visibilità.
### 4. Controlli di Esecuzione del Prompt
Quando un prompt è in esecuzione, gli utenti hanno diverse opzioni di controllo per gestire o intervenire nel processo di esecuzione:
* **Metti in Pausa il Prompt:** Sospende temporaneamente l'esecuzione corrente. Utile se si desidera osservare lo stato attuale o preparare il sistema per i passaggi successivi. 
* **Riprendi il Prompt:** Continua l'esecuzione dal punto in cui è stata messa in pausa. 
* **Annulla il Prompt:** Interrompe completamente l'esecuzione e resetta la sessione. Questo è utile se il prompt deve essere interrotto o riavviato a causa di un comportamento errato o modifiche nell'input.\
* **Prendi il Controllo:** Consente all'utente di intervenire manualmente interagendo direttamente con il sistema. Questo è utile se l'operatore si blocca o interpreta erroneamente un passaggio. Prendere il controllo **mette automaticamente in pausa** il prompt e passa alla modalità manuale fino a quando si sceglie di riprendere o annullare.
### 5. Visualizzazione Dettagli Operatore
Una volta avviato un prompt, diventa disponibile un pulsante aggiuntivo che consente agli utenti di passare a una **visualizzazione dettagliata dell'esecuzione**.\
* **Apri Visualizzazione Dettagli:** Questo pulsante ti porta a una visualizzazione dedicata che mostra, passo dopo passo, cosa sta facendo l'operatore in tempo reale.
Nella visualizzazione dettagli, gli utenti possono:
* Monitorare ogni azione eseguita (ad esempio, clic, input, attese).
* Vedere quale passaggio è attualmente attivo.
* Identificare dove si verificano problemi se il prompt incontra problemi.
* Utilizzare le stesse azioni di **Pausa**, **Riprendi**, **Annulla** e **Prendi il Controllo**.
