# Benvenuto in Opser Un unico sistema per la tua azienda: le app che usa il team, gli agenti che svolgono il lavoro e il contesto che condividono. Source: https://docs.opser.com/it/ ## App, agenti e contesto condiviso Opser riunisce in un unico spazio di lavoro il software della tua azienda e gli agenti che svolgono il lavoro. Il team usa le app per gestire dati e flussi di lavoro. Gli agenti operano in queste app, usano i servizi collegati e creano i file o il software di cui hai bisogno. Il contesto aziendale li aiuta a comprendere il significato del lavoro. Questi tre elementi si completano a vicenda: | Elemento | Cosa offre | | --- | --- | | [App](https://docs.opser.com/it/apps/overview/) | Interfacce, dati e regole aziendali che persone e agenti possono usare insieme | | [Agenti](https://docs.opser.com/it/agents/overview/) | Colleghi IA per te o per tutto il team che usano strumenti, eseguono codice e portano a termine i compiti | | [Contesto](https://docs.opser.com/it/agents/context/) | Conoscenze aziendali, istruzioni di ruolo, preferenze e memoria che guidano il lavoro | ## Assegna un compito al tuo agente Chiedi un risultato concreto: confrontare alcune offerte, preparare un report, analizzare dei dati o creare un flusso di lavoro per il team. Fornisci i file pertinenti o indica l'app di origine. L'agente può scegliere gli strumenti, fare una domanda, eseguire codice di supporto e restituire un risultato che puoi controllare. Ogni agente dispone di un [filesystem persistente](https://docs.opser.com/it/agents/files/) e di un’unica chat continua che non si azzera mai, condivisa da tutti quelli che possono usarlo. File sorgente, script e risultati salvati restano disponibili per il lavoro successivo, e l’agente può ripercorrere la chat quando nomini qualcosa di prima. Inizia dal [tuo primo compito](https://docs.opser.com/it/start/quickstart/), poi scopri [cosa può fare Opser](https://docs.opser.com/it/capabilities/overview/). ## Adatta il sistema alla tua azienda Usa le app disponibili nel tuo spazio di lavoro oppure descrivi un'app che vuoi far creare all'agente. Le app possono offrire strumenti e competenze agli agenti, operazioni ad altre app ed eventi che collegano i flussi di lavoro. Connessioni e regole di accesso sono esplicite: condividere il contesto non rende tutti i dati visibili a chiunque. Scopri [come collaborano le app](https://docs.opser.com/it/apps/connected/) e come [creare e verificare un'app](https://docs.opser.com/it/capabilities/internal-apps/). ## Configura lo spazio di lavoro [Apri uno spazio di lavoro o unisciti al tuo team](https://docs.opser.com/it/start/access/), aggiungi il contesto aziendale e assegna ai [colleghi](https://docs.opser.com/it/workspace/users/) i giusti [permessi di accesso](https://docs.opser.com/it/workspace/permissions/). Poi imposta le tue [preferenze](https://docs.opser.com/it/workspace/preferences/) e scopri come funzionano [utilizzo e crediti](https://docs.opser.com/it/billing/usage/). Puoi leggere la documentazione senza accedere a un account. Ogni guida offre anche i comandi **Copia pagina** e **Markdown** per usare il testo completo con un agente. --- # Il tuo primo compito Dai al tuo agente un compito reale, segui il suo lavoro e mantieni un risultato che puoi usare. Source: https://docs.opser.com/it/start/quickstart/ ## Inizia con il tuo agente [Apri l'area di lavoro](https://docs.opser.com/it/start/access/) e scegli **Agente** nella barra laterale. È l'agente predefinito creato con il tuo account. Non fa mai più di quanto potresti fare tu, conserva i propri file persistenti e segue le istruzioni che gli dai. Puoi iniziare con un file e un'attività prima di collegare un servizio esterno o creare un'app. Se l'area di lavoro è nuova, puoi prima dire all'agente cosa fa la tua attività. Può aiutare a catturare il contesto aziendale e il tuo ruolo. Puoi anche andare direttamente al lavoro e perfezionare quel contesto in seguito. ## Dare un risultato specifico Descrivi la fonte, il risultato e qualsiasi confine che conta. Per una prima attività, utilizzare un file il cui contenuto si conosce in modo da poter giudicare il risultato. > Utilizzare il foglio di calcolo allegato per preparare un riepilogo settimanale delle operazioni. Raggruppa il lavoro per proprietario, segnala le scadenze mancanti e crea un rapporto di una pagina. Salvare il report e lo script utilizzato per calcolare i totali. Non modificare il file sorgente. Se le informazioni risiedono in un'app o in un account collegato, identificarle. L'agente ha bisogno di accedere a quella fonte; la descrizione di un sistema non lo collega. ## Segui il lavoro La chat mostra ciò che l'agente scrive, le sue domande e i file che crea; mentre lavora, una riga accanto al suo avatar dice cosa sta facendo. L'agente può leggere l'allegato, utilizzare un documento o uno strumento di foglio di calcolo e [scrivere ed eseguire codice](https://docs.opser.com/it/capabilities/code/) quando il compito lo richiede. Può mantenere la fonte, lo script e il risultato nel suo [file di area di lavoro](https://docs.opser.com/it/agents/files/). Per vedere ogni azione e il suo risultato, attiva **Mostra i passaggi dell’agente** in **Impostazioni → Generali**. Se l'agente fa una domanda, dagli i dettagli mancanti. Puoi anche inviare una correzione mentre lavora: la legge dopo il passaggio in corso. Se un'azione ha bisogno di approvazione, rivedere l'obiettivo e la modifica proposta prima di accettare. [Approvi](https://docs.opser.com/it/agents/approvals/) e [permessi di accesso](https://docs.opser.com/it/workspace/permissions/) servono a scopi diversi. ## Controllare e affinare il risultato Aprire il file generato o il record risultante. Controlla i valori, l'origine e se l'output risponde alla tua richiesta. Rispondi nella chat per perfezionarlo: > Metti prima i tre elementi più vecchi, mantieni il rapporto sotto una pagina e spiega tutte le righe escluse dai totali. Un file salvato nell'area di lavoro dell'agente può essere riutilizzato in seguito. Se il risultato deve essere un record aziendale condiviso, chiedere all'agente di archiviarlo nell'app o nella posizione di archiviazione appropriata e confermare la condivisione. Un allegato di chat e un record di squadra sono cose diverse. ## Semplifica il prossimo compito Salvare le informazioni aziendali durevoli in [Context](https://docs.opser.com/it/agents/context/), e utilizzare un [skill](https://docs.opser.com/it/agents/skills/) per un processo che si ripete. Assegna la prossima attività nella stessa chat. Non si azzera mai: l'agente mantiene il suo spazio di lavoro e le sue impostazioni, e può ripercorrere il lavoro precedente quando lo nomini. Una volta che un'attività funziona in modo affidabile, chiedere a [calendario](https://docs.opser.com/it/agents/automations/). Se il lavoro ha bisogno di un'interfaccia dedicata, descrivere il flusso di lavoro e [Crea un'app](https://docs.opser.com/it/capabilities/internal-apps/). Puoi continuare a usare la chat e le app insieme. --- # Apri il tuo spazio di lavoro Crea uno spazio di lavoro o unisciti al tuo team, accedi e trova il tuo agente. Source: https://docs.opser.com/it/start/access/ ## Apri lo spazio di lavoro del tuo team Ogni spazio di lavoro Opser ha il proprio indirizzo. Per trovare il tuo, apri [Accedi sul sito Opser](https://opser.com/login), verifica la tua email con il codice ricevuto e scegli uno spazio di lavoro. Poi accedi dalla pagina di accesso di quello spazio di lavoro. La verifica sul sito mostra solo i collegamenti ai tuoi spazi di lavoro; non effettua l'accesso. Usa il collegamento fornito quando è stata configurata la tua organizzazione, oppure chiedilo all'amministratore. Questa documentazione pubblica è separata dal tuo spazio di lavoro privato e non effettua l'accesso. Se ti unisci a un team, chiedi ad un amministratore di [aggiungi il tuo account](https://docs.opser.com/it/workspace/users/) e fornire il collegamento dello spazio di lavoro. Un nuovo spazio di lavoro è un ambiente separato, quindi non crearne uno quando intendi unirti al team esistente. ## Accedi e verifica la tua email **Accedi · Dati fittizi** Maya accede al workspace fittizio Northstar con maya@northstar.example e una password. Questi campi sono illustrativi. Accedi con il tuo account e-mail e password. Quando richiesto, inserire il codice di verifica inviato a quell'indirizzo email. Il flusso di accesso mostra la fase di verifica; mantenere il codice privato e utilizzarlo lì. Se il codice scade, avviare un nuovo accesso e utilizzare il nuovo codice. Se il messaggio non arriva, controllare l'indirizzo e-mail e la cartella spam. Chiedi aiuto all'amministratore se l'e-mail di verifica non può essere consegnata. Sei stato invitato in uno spazio di lavoro? Apri il link nell'email di invito, inserisci il tuo nome e scegli una password. Accedi subito. ## Avviare una nuova area di lavoro Utilizzare il [Pagina di iscrizione dell'opser](https://opser.com/signup) per iniziare il setup. Rivedere l'area di lavoro e pianificare i dettagli mostrati lì. Per aiuto nella scelta di una configurazione, [contatto Opser](https://opser.com/contact). Una volta che sei dentro, racconta al tuo agente della tua attività o [Dare un primo compito](https://docs.opser.com/it/start/quickstart/). Aggiungere informazioni aziendali stabili in [Contesto](https://docs.opser.com/it/agents/context/) Quindi il lavoro futuro ha un utile punto di partenza. ## Recupera l'accesso Se hai dimenticato la password, scegli **Password dimenticata** nella pagina di accesso dell'area di lavoro. Inserisci l'email del tuo account, apri il link di reset dall'email e scegli una nuova password. Un collegamento di reset è per un uso; richiederne uno nuovo se non valido o scaduto. Utilizzare l'indirizzo di area di lavoro corretto per il recupero. Se non riesci ancora ad accedere, chiedi all'amministratore di controllare il tuo account e includere l'errore visibile in una richiesta di supporto. Non inviare password, codici di verifica o reimpostare i collegamenti a un agente o una conversazione di supporto. --- # Cos’è un agente? Un collega di intelligenza artificiale con le proprie istruzioni, strumenti, memoria e spazio di lavoro persistente. Source: https://docs.opser.com/it/agents/overview/ ## Un agente ha un posto dove lavorare Un agente Opser è un collega di intelligenza artificiale che può intraprendere azioni per completare un'attività. Combina un modello di linguaggio con istruzioni, strumenti, memoria e un filesystem persistente. Può indagare le informazioni, scrivere ed eseguire codice, lavorare con i record aziendali, creare documenti e creare app quando tali funzionalità sono abilitate. **Una conversazione con l’agente · Dati fittizi** L’intestazione della chat mostra l’avatar dell’agente — un personaggio azzurro dall’aria amichevole — e il suo nome. L’agente esamina i dati disponibili e salva un piano per il portale clienti in portal-plan.md nel suo workspace persistente. Il modello gestisce il ragionamento e il linguaggio. Il runtime circostante Opser fornisce lo spazio di lavoro e le azioni che può intraprendere. Cambiare i modelli non trasforma una conversazione diversa nella stessa cosa di un agente diverso. ## Cosa conserva un agente tra i compiti | Fondazione | Come viene utilizzato | | --- | --- | | Identità e istruzioni | Il suo nome, il comportamento, la conoscenza del ruolo e la guida permanente | | Contesto aziendale e personale | Informazioni sulla tua organizzazione e sulle persone che serve | | Memoria | Fatti che l'agente può salvare e recuperare per il lavoro futuro | | File persistenti | File di origine, script, note e risultati conservati nell'area di lavoro dell'agente | | Strumenti | Azioni per la lettura, il calcolo, l'aggiornamento, la costruzione e la comunicazione | | Competenze | Istruzioni per lo svolgimento di un tipo di lavoro con tali strumenti | | Connessioni e accesso | Gli account esterni, le app e i record che sono autorizzati a utilizzare | Ogni agente ha una sola chat continua, condivisa da tutti quelli che possono usarlo, e non si azzera mai. Quando diventa lunga, l'agente tiene un riepilogo dei messaggi precedenti e cerca nella chat i dettagli esatti quando gli servono; i file salvati e il contesto configurato restano invariati. ## Da una richiesta a un risultato Un agente può suddividere un'attività in passaggi, ispezionare gli input, scegliere strumenti, chiedere un dettaglio mancante, eseguire uno script e rivedere l'output. Alcune azioni richiedono l'approvazione. La chat mostra ciò che l'agente scrive e produce, con una breve frase che dice cosa sta facendo mentre lavora; attiva i suoi passaggi quando vuoi ispezionare ogni azione. Vedi [cosa vedi mentre l'agente lavora](https://docs.opser.com/it/agents/conversations/#what-you-see-while-the-agent-works). Ad esempio, un agente può leggere diversi file di origine, calcolare un confronto, salvare uno script riutilizzabile e produrre un report. Se il risultato appartiene a un'app installata, può utilizzare gli strumenti supportati per creare o aggiornare il record. Leggi [Strumenti integrati](https://docs.opser.com/it/agents/tools/) e [Codice e script](https://docs.opser.com/it/capabilities/code/). ## I tuoi agenti Inizi con un agente predefinito e puoi creare altri agenti per diversi tipi di lavoro, ad esempio un product manager, un ricercatore o un redattore. Ogni agente ha un proprio spazio di lavoro, una configurazione e delle connessioni, e un proprietario, che ne controlla le impostazioni. Su un agente specialista, anche le persone con accesso possono insegnargli cosa sapere e come comportarsi (vedi [Contesto e memoria](https://docs.opser.com/it/agents/context/)). Ogni [piano](https://docs.opser.com/it/billing/plans/) ti permette di creare tutti gli agenti che ti servono. Un agente non ottiene l'accesso ai file privati di un'altra persona o a un servizio non connesso solo perché li menzioni. Chiedigli di identificare la fonte mancante o l'autorizzazione quando non può completare un'attività. ## Dare accesso alle persone Qualsiasi agente può essere dato ad altre persone, compreso l'agente predefinito con cui inizi. Il suo proprietario o un amministratore apre **Accesso** nelle impostazioni dell'agente e sceglie **Aggiungi persone**, oppure lo chiede all'agente nella sua chat, che chiede l'approvazione prima di dare o togliere l'accesso. Accesso elenca tutti quelli che possono usare l'agente, a partire dal proprietario. Un agente può servire un team attorno a un processo come il coordinamento delle richieste o la preparazione di rapporti operativi. Tutti quelli che hanno accesso usano l'agente insieme: una sola chat che tutti vedono e in cui tutti scrivono, dove ogni messaggio mostra chi l'ha scritto, oltre alle automazioni dell'agente e ai loro risultati, ai suoi file, alla sua memoria e agli account a cui è collegato. Le connessioni appartengono all'agente, non alla persona che le ha create. Ognuno ha il proprio stato di lettura. Quando qualcuno oltre al proprietario può usare un agente, i volti delle persone con accesso compaiono in alto a destra nella chat, subito prima del pulsante di ricerca, sia nella pagina della chat sia nella chat laterale. Selezionali per vedere chi ha accesso; il proprietario o un amministratore vede lì anche **Gestisci accesso**, che apre **Accesso**. Quando qualcuno riceve accesso, una riga nella chat lo dice nel punto in cui è successo: quella persona può vedere tutta la chat, anche i messaggi precedenti. Un agente non fa mai più di quanto potrebbe il suo proprietario, né più di quanto la persona che gli parla può fare in Opser. Dare accesso non è una scorciatoia per aggirare i permessi sui record. Prima di aggiungere qualcuno, controlla cosa contengono già la chat, i file e la memoria dell'agente e a quali account è collegato: quella persona potrà vederli e usarli. Apri **Impostazioni → Agenti** per gestire gli agenti a tua disposizione. La creazione di agenti richiede l'autorizzazione. La condivisione è inclusa in ogni piano, anche in Free. ## Delega del lavoro Per un compito più lungo, l'agente principale può delegare una parte limitata del lavoro a un subagente e riportare il suo rapporto nella conversazione. Un subagente riceve un task brief e strumenti selezionati; non è un altro agente permanente che è necessario configurare. La delegazione non espande l’autorità. I subagenti non possono porvi domande o completare le azioni approvate da soli. La conversazione principale gestisce queste decisioni e riunisce i risultati. ## Riconoscere i tuoi agenti Ogni agente ha un'identità salvata: un nome e un avatar composto da una forma e un colore, con un volto espressivo. Il tuo agente predefinito nasce come “Agent” con un avatar assegnato in modo casuale; quando crei un altro agente, puoi assegnargli un'identità specifica per il suo ruolo. Le impostazioni **Generali** permettono di rinominarlo e scegliere un altro aspetto. Chiunque possa usare un agente ne vede la stessa identità. **I tuoi agenti · Dati fittizi** Tre agenti, ognuno con il proprio avatar: l’agente Opser, usato solo dal suo proprietario, come personaggio azzurro arrotondato; un agente Assistenza usato da quattro persone, a forma di fiore albicocca; e un agente Report usato da due persone, a forma di stella color menta. La barra laterale dello spazio di lavoro elenca gli agenti a tua disposizione sopra le app, ciascuno con avatar, nome e attività non letta. Scegline uno per aprire la sua chat; una chat vuota ti accoglie con l'avatar di quell'agente e l'intestazione della chat mostra l'avatar accanto al nome. L'animazione dell'avatar rispetta la tua preferenza di movimento ridotto. ## Configurare e utilizzare l'agente L'intestazione della chat ha un pulsante di ricerca e un ingranaggio. L'ingranaggio apre le impostazioni dell'agente in un pannello accanto alla chat, senza lasciarla. Mostra l'agente, poi le sue sezioni, ognuna con la sua icona: **Generali**, **Plugin**, **Approvazioni**, **Automazioni**, **File** e **Accesso**. Una sezione aperta mostra una freccia indietro, la sua icona e il suo nome, poi una riga che dice a cosa serve; la freccia risale di un livello. Trascina il bordo del pannello per ridimensionarlo e chiudilo con **×**; su un telefono si apre come un foglio. L'agente può modificare da solo quasi tutte queste impostazioni quando glielo chiedi in chat. I controlli disponibili dipendono dal tuo accesso. Continua con [la tua chat con un agente](https://docs.opser.com/it/agents/conversations/), [contesto e memoria](https://docs.opser.com/it/agents/context/), oppure [file persistenti](https://docs.opser.com/it/agents/files/). --- # La tua chat con un agente Continua a lavorare in un'unica chat con ogni agente, segui cosa sta facendo, ritrova messaggi e file precedenti e rendi le tue richieste più facili da eseguire. Source: https://docs.opser.com/it/agents/conversations/ ## Una chat con ogni agente Ogni agente ha una sola chat continua. Apri l'agente dalla barra laterale e scrivi: non c'è un elenco di chat da gestire. Nelle altre pagine, l'agente in alto a destra apre la sua chat accanto alla pagina. I messaggi, le risposte dell'agente e i risultati delle sue automazioni restano in quell'unica chat, così puoi riprendere da dove avevi lasciato. Quando altre persone hanno accesso all'agente, usano la stessa chat: tutti la vedono e ci scrivono, e ogni messaggio mostra chi l'ha scritto. Ognuno ha il proprio stato di lettura, quindi un messaggio che hai già letto può essere ancora nuovo per un collega. Vedi [Dare accesso alle persone](https://docs.opser.com/it/agents/overview/#give-people-access). La chat non si azzera mai. Quando diventa lunga, l'agente la compatta: tiene un riepilogo dei messaggi precedenti (persone, decisioni, preferenze, lavoro svolto, questioni aperte) e gli ultimi parola per parola, e una scheda **Chat compattata** segna il punto in cui è successo; scegli **Mostra riepilogo** per leggere cosa ha tenuto. Non si cancella nulla. Puoi scorrere indietro e cercare tutto, e può farlo anche l'agente: chiedigli di qualcosa di settimane fa, una decisione o un file, e lo cerca nella chat. ## Cosa vedi mentre l'agente lavora La chat si legge come una conversazione con un collega: i tuoi messaggi e quelli dell'agente compaiono come fumetti. Mentre l'agente lavora, una riga in fondo alla sua risposta mostra il suo avatar in movimento e una breve frase che dice cosa sta facendo, come il passaggio in corso o **Al lavoro…**, con il tempo trascorso quando il lavoro si allunga. Mentre un'approvazione ti aspetta, la riga dice **In attesa della tua approvazione**. Gli strumenti che l'agente usa, il suo ragionamento e gli altri passaggi dietro ogni risposta restano nascosti. Ciò che richiede il tuo intervento, o ciò che l'agente ha prodotto, resta visibile: una richiesta di approvazione in attesa sopra il campo di scrittura, le domande dell'agente, le schede per collegare un account, i file che ha creato, un avviso quando finiscono i crediti o un piano ChatGPT collegato raggiunge il suo limite, il browser dal vivo mentre l'agente lo usa e la scheda **Chat compattata**. Una risposta terminata senza nulla da mostrare dice **Finito senza una risposta**, e una risposta fermata dice **Interrotto**. Per vedere i passaggi, attiva **Mostra i passaggi dell’agente** in **Impostazioni → Generali**, oppure chiedi all'agente di attivarlo per te. La chat mostra allora anche gli strumenti dietro ogni risposta, il ragionamento dell'agente, il suo piano e i suoi sub-agenti, con i suoi messaggi sempre nei fumetti. L'impostazione è solo tua: non cambia ciò che vede un collega in una chat condivisa. Una risposta che descrive un'azione non è la prova che l'azione sia finita; controlla il record risultante, oppure attiva i passaggi per leggere il risultato dello strumento. ## Scrivere mentre lavora Non devi aspettare una risposta. Scrivi mentre l'agente lavora: il tuo messaggio compare in fondo alla chat, con la dicitura **Verrà letto dopo il passaggio in corso**. L'agente non si ferma: legge il tuo messaggio quando finisce il passaggio in corso e prosegue tenendone conto, e ciò che dice dopo compare sotto il tuo messaggio. Più messaggi inviati durante lo stesso passaggio gli arrivano insieme. Mentre l'agente lavora, il pulsante accanto al campo di scrittura è quello per fermarlo; su un computer, premi Invio per inviare. In una chat condivisa, un messaggio che un collega invia mentre l'agente lavora alla richiesta di qualcun altro aspetta che quel lavoro finisca, poi riceve una risposta tutta sua. ## Scrivi istruzioni utili Includere quattro cose quando sono importanti: **Una domanda del tuo agente · Dati fittizi** Accanto al suo avatar, l’agente chiede chi userà il portale. È selezionato Clienti; le altre opzioni sono Partner e Team. 1. **Risultato:** quello che vuoi alla fine. 2. **Fonte:** quale app, record, file o connessione utilizzare. 3. **Constraints:** scadenze, pubblico, formato e modifiche da evitare. 4. **Punto di revisione:** ciò che si desidera approvare prima che l'agente continui. > Utilizzare le offerte del fornitore allegato per creare un confronto per prezzo unitario, ordine minimo e tempo di consegna. Mantenere le valute separate. Mostra il confronto prima di creare qualsiasi ordine di acquisto. Rispondi direttamente alle domande di chiarimento. Se l'agente sceglie il record sbagliato, identifica quello corretto usando il suo nome e un altro dettaglio distintivo. ## L'agente impara mentre lavori Racconta all'agente il suo lavoro mentre lavori: il suo ruolo, per chi scrive, come scrivere, le regole da seguire. Salva ciò che deve durare nella propria descrizione, personalità e conoscenze, che puoi vedere e modificare nelle sue impostazioni, e te lo dice in una breve riga. Quando chiedi qualcosa che si ripete, come un riepilogo ogni mercoledì, imposta un'automazione da approvare. Quando descrivi un modo lungo e passo per passo di svolgere un lavoro, propone una [competenza](https://docs.opser.com/it/agents/skills/) da approvare invece di aggiungere i passaggi alle sue conoscenze. Le richieste occasionali restano occasionali. Su un agente specialista usato da altre persone, chiunque abbia accesso può cambiarne personalità, conoscenze, regole, competenze e automazioni, salvo che il proprietario lo abbia disattivato; solo il proprietario o un amministratore cambia il resto. ## Trovare il lavoro precedente Usa il pulsante di ricerca nell'intestazione della chat o premi ⌘F (Ctrl+F su Windows e Linux). Prima di scrivere, la ricerca elenca i messaggi inviati, dal più recente, così puoi tornare a ognuno di essi. Scrivi per trovare parole nei messaggi, nelle risposte dell'agente e nei nomi dei file in tutta la chat; altri risultati si caricano mentre scorri. Scegli un risultato per far scorrere la chat fino a lì. Su uno schermo largo, una linea di brevi tacche accanto alla chat rappresenta i messaggi inviati intorno a dove ti trovi, per quanto indietro. Passa sopra una tacca per leggere il messaggio e fai clic per andarci. Apri l'ingranaggio nell'intestazione e scegli **File** per vedere tutti i file della chat: quelli che hai caricato e quelli creati dall'agente. Mantieni i fatti durevoli in [Contesto](https://docs.opser.com/it/agents/context/) o in un'app di conoscenza condivisa, a seconda dei casi; non fare affidamento su una lunga chat come unica traccia di una decisione aziendale. ## File e interruzioni Allega alla richiesta i file pertinenti. L'agente conserva i suoi file di lavoro nel proprio [spazio di lavoro](https://docs.opser.com/it/agents/files/). Usa il pulsante per fermare l'agente quando l'attività deve cambiare. Fermarlo non annulla le azioni già completate, e i messaggi che l'agente non ha ancora letto ricevono risposta subito dopo. Per una piccola modifica spesso non serve fermarlo: inviala, e l'agente la riprende dopo il passaggio in corso. Per errori imprevisti, controllare le approvazioni, l'accesso e le connessioni prima di riprovare a scrivere. Vedere [troubleshooting](https://docs.opser.com/it/help/troubleshooting/) per una lista di controllo che evita le modifiche duplicate. ## Parla invece di scrivere Quando il campo di testo è vuoto, scegli il pulsante con l’onda sonora per parlare con il tuo agente di CRM, trattative, attività o altre app collegate. Le tue parole e la risposta compaiono nella conversazione come ogni altro messaggio. La voce resta connessa mentre navighi. Prima della prima chiamata, controlla la tariffa: l’audio usa crediti del workspace anche con un abbonamento ChatGPT collegato. Vedi [Conversazioni vocali](https://docs.opser.com/it/agents/voice/) per controlli, anteprime, addebiti e accesso al microfono. --- # Conversazioni vocali Parla con il tuo agente Opser, scegli una voce e comprendi i crediti vocali. Source: https://docs.opser.com/it/agents/voice/ ## Parla con il tuo agente Nella chat vuota, scegli il pulsante con l’onda sonora per avviare una conversazione vocale. Quando scrivi o alleghi un file, quel pulsante diventa Invia. Il microfono separato detta invece una bozza di testo modificabile. Consenti l’accesso al microfono. Al primo utilizzo, controlla la tariffa e scegli **Avvia usando crediti**. Puoi parlare di CRM, trattative, attività e app accessibili all’agente selezionato. I risultati compaiono nella stessa chat, e un’approvazione in attesa aspetta sopra il campo di scrittura. L’agente pone le domande di chiarimento a voce. Quando un’azione richiede approvazione, la descrive e ti chiede di dire **approva** o **rifiuta**; una risposta ambigua o condizionata non esegue l’azione. Le tue parole e la risposta vocale compaiono progressivamente nella chat. La scheda compatta sopra il campo di testo mostra l’avatar del tuo agente, che reagisce al microfono mentre parli e si anima mentre l’agente parla, e il controllo per disattivare il microfono. Rispetta la preferenza di movimento ridotto. Il pulsante vocale diventa una **X** per terminare la conversazione. La tariffa compare prima della prima chiamata, lasciando i controlli concentrati sulla conversazione. In ogni risposta vocale, i risultati dettagliati dell’agente precedono la trascrizione parlata, insieme all’attività degli strumenti quando **Mostra i passaggi dell’agente** è attivo. File, approvazioni, errori e risultati che arrivano dopo la fine della chiamata restano disponibili. La trascrizione rimane nella chat al termine del conteggio. ## Gestisci la conversazione Usa il microfono per disattivare l’audio in ingresso e **Termina chiamata** per chiudere. Disattivare il microfono non interrompe il consumo di crediti. Interrompere la voce non annulla un’azione già in corso: usa Stop nella chat per fermare il lavoro dell’agente. Terminare la chiamata lascia il lavoro autorizzato nella chat. La voce resta connessa mentre navighi in Opser. Su desktop, una conversazione attiva ti segue nella barra laterale dell’agente; su mobile, controlli compatti consentono di silenziare o terminare la chiamata mentre usi un’app. Le conversazioni inattive non si aprono automaticamente. Una chiamata non ha una durata fissa: si chiude da sola dopo 10 minuti senza che nessuno parli. Si chiude anche se chiudi la scheda, esci dall’account, perdi la connessione o esaurisci i crediti. Per riconnetterti avvia una nuova chiamata; le azioni non vengono ripetute automaticamente. ## Scorciatoie da tastiera Con la chat attiva, usa **Ctrl+D** per avviare o fermare la dettatura (Control anche su Mac) e **Ctrl+Shift+Spazio** per avviare o terminare la voce dal vivo (**Cmd+Shift+Spazio** su Mac). Le scorciatoie compaiono nei suggerimenti dei pulsanti e seguono gli stessi controlli: la voce parte con il campo vuoto, l’avviso iniziale sui crediti resta visibile e i controlli disabilitati restano tali. Con due chat aperte, attiva quella desiderata. Mentre detti, premi **Invio** per inviare ciò che hai detto; **Ctrl+D** o la matita lo mettono nel campo del messaggio per modificarlo prima. La dettatura conosce già i tuoi colleghi, agenti, app e la tua azienda; per insegnarle altre parole o correggerne una che sbaglia sempre, vedi [Insegna le tue parole alla dettatura](https://docs.opser.com/it/workspace/preferences/#teach-dictation-your-words). ## Scegli la voce GPT Live parla con il nome e la personalità dell’agente Opser selezionato. Il lavoro con gli strumenti in modalità vocale usa GPT-5.6 Luna con ragionamento basso, mantenendo disponibili gli strumenti del workspace e quelli dinamici delle app. I moduli con domande e le schede di connessione restano nella chat testuale perché richiedono interazione sullo schermo. La chat testuale conserva il modello e il ragionamento configurati. Se l’agente usa un abbonamento Codex collegato, queste attività usano Luna tramite quell’abbonamento; altrimenti usano l’API OpenAI a consumo. L’audio dal vivo viene sempre addebitato separatamente in crediti. Nelle impostazioni **Generali** dell’agente scegli una voce in **Voce dell’agente**. Ogni agente conserva la propria voce e la chiamata usa la voce dell’agente selezionato. Ascolta l’anteprima accanto a ogni voce senza consumare crediti del workspace. Le modifiche valgono dalla prossima chiamata. Il suo proprietario o un amministratore può anche chiedere all’agente di cambiarla. ## Comprendi i crediti L’avviso iniziale mostra la tariffa attuale del workspace per la voce in diretta. La voce in diretta è addebitata al secondo, con un minimo di 15 secondi alla connessione. Silenzi, microfono disattivato e attese contano mentre la sessione è aperta. Opser riserva un breve intervallo in anticipo e restituisce i crediti inutilizzati al termine del conteggio. Se la connessione si interrompe prima dei dati finali, conserva l’utilizzo confermato ricevuto e contrassegna il totale finale come non confermato per una verifica della fatturazione. Modello e strumenti dell’agente sono addebitati separatamente alle tariffe abituali. Voce e dettatura consumano crediti del workspace anche con un abbonamento ChatGPT collegato. La dettatura è addebitata in base alla durata della registrazione, con una tariffa propria. In **Impostazioni → Utilizzo** trovi voce e dettatura insieme agli altri modelli e il registro di riserve e rimborsi. Vedi [Crediti e utilizzo](https://docs.opser.com/it/billing/usage/). ## Audio e accesso OpenAI elabora l’audio. Opser conserva trascrizioni testuali, non registrazioni audio. Restano valide le autorizzazioni e le approvazioni dell’agente selezionato. L’approvazione vocale accetta solo una risposta esplicita **approva** o **rifiuta**; un’approvazione in attesa compare sopra il campo di scrittura, e quelle decise restano nella chat quando **Mostra i passaggi dell’agente** è attivo. Se la connessione non riesce, controlla il permesso del microfono e i crediti. Serve un browser compatibile con WebRTC; nei browser integrati su mobile la disponibilità dipende dal supporto del microfono. --- # Contesto e memoria Dai al tuo agente lo sfondo di cui ha bisogno senza ripetere l'intera storia aziendale. Source: https://docs.opser.com/it/agents/context/ ## Aggiungi il contesto necessario Apri **Impostazioni → Contesto**. Il contesto personale aiuta il tuo agente a comprendere il tuo ruolo, le tue preferenze e responsabilità. Il contesto organizzativo descrive l'azienda ed è gestito dagli amministratori. Un buon contesto è stabile e utile in tutte le attività: cosa fa la tua azienda, chi servi, la terminologia che usi e come preferisci lavorare. Continua a modificare i record come gli ordini e lo stato delle attività nelle loro app. > Coordinare gli acquisti. Presentare i confronti dei fornitori in una tabella, mantenere invariate le valute quotate e richiamare i tempi di consegna mancanti prima di raccomandare un fornitore. ## Informazioni personali e organizzative Il tuo contesto è disponibile nella parte personale della pagina. Le sezioni dell'organizzazione possono essere nascoste se non sei un amministratore. Controlla quale sezione stai modificando prima di salvare: una preferenza personale e un'istruzione a livello aziendale hanno un pubblico diverso. ## Conoscenze di ruolo, personalità e file Le impostazioni **Generali** dell'agente separano il modo in cui si comporta da ciò che deve sapere sul suo ruolo. Usa la personalità per il tono e il comportamento, e le conoscenze per i fatti del settore o le istruzioni permanenti. Le informazioni valide per tutta l'azienda vanno nel contesto dell'organizzazione; i requisiti di una singola attività vanno nella tua richiesta. L'agente compila anche queste impostazioni mentre gli racconti il suo lavoro in chat, e te lo dice in una breve riga; controlla e modifica ciò che ha salvato in **Generali**. Anche i [file salvati nello spazio di lavoro](https://docs.opser.com/it/agents/files/) e la memoria sono cose diverse. Un file contiene materiale di origine concreto o un artefatto. La memoria contiene fatti recuperabili. La chat è una terza traccia: l'agente lavora da un riepilogo dei messaggi precedenti più gli ultimi, e recupera parole esatte, date o file più vecchi quando li nomini. Indica all'agente la fonte pertinente quando i dettagli esatti contano. ## Fuso orario dello spazio di lavoro Gli agenti usano il fuso orario dello spazio di lavoro selezionato durante la configurazione iniziale o nelle impostazioni dell'organizzazione per interpretare «oggi», «domani» e gli orari senza un fuso esplicito. Ogni nuova richiesta riceve un riferimento temporale aggiornato e il fuso orario salvato, anche nella tua chat in corso. Se necessario, specifica un altro fuso orario nella richiesta. Il lavoro già in corso mantiene il riferimento temporale originale, comprese le attività delegate e quelle riprese dopo un'approvazione. Le nuove pianificazioni ricorrenti salvano il fuso orario risolto; cambiare il fuso orario dello spazio di lavoro non sposta le pianificazioni esistenti. ## Regole dell'agente Le regole sono brevi istruzioni che un agente segue in ogni messaggio, come i termini di pagamento di un cliente o qualcosa che non deve mai fare. Quando correggi l'agente in una chat o gli dici come va sempre fatta una cosa, salva una regola e te lo dice in una breve riga. Le trovi in **Regole** nelle impostazioni dell'agente, dove puoi aggiungerle, riformularle o rimuoverle. Un numero accanto a **Regole** indica i suggerimenti in attesa della tua approvazione. Su un agente specialista usato da altre persone, chiunque abbia accesso può decidere come lavora: personalità, conoscenze, regole, competenze e automazioni, dalla chat o dalle impostazioni. Tutto il resto dell'agente (accesso, approvazioni, modello, nome e aspetto) resta al proprietario e agli amministratori, e i membri non vedono affatto quelle impostazioni; il proprietario le vede contrassegnate con **Solo proprietario**. Il proprietario può disattivare le modifiche dei membri in **Accesso**; da quel momento la correzione di un membro viene salvata come suggerimento, che vale quando il proprietario o un amministratore lo approva. Sul primo agente di una persona, che agisce con la sua autorità, solo il proprietario o un amministratore cambia qualcosa. L'agente salva solo ciò che le persone gli dicono direttamente, mai istruzioni trovate in un'email, un documento o una pagina web. ## Memoria dell'agente Gli agenti possono salvare e recuperare fatti utili attraverso la loro capacità di memoria. Chiedi all'agente cosa ricorda di un argomento, dillo quando un fatto è obsoleto e chiedigli di correggere o dimenticare quel fatto. La memoria è uno sfondo utile, ma le politiche importanti e le decisioni aziendali dovrebbero anche avere una casa autorevole, come un documento condiviso in una casa [app installata](https://docs.opser.com/it/apps/overview/). Indicare l'agente a quella fonte quando gli viene chiesto di applicare la politica. ## Mantenere il contesto utile Rivedere come le responsabilità cambiano. Rimuovere le istruzioni contraddittorie, le descrizioni dei processi obsolete e i dettagli di cui l'agente non ha più bisogno. Per i vincoli di attività una tantum, mettili invece nella conversazione. Se l'agente usa l'ipotesi sbagliata, identifica il fatto errato e la fonte corretta. Dopo un cambiamento importante, scrivi nella chat cosa è cambiato e quali dettagli precedenti non valgono più: la chat conserva la sua cronologia, quindi l'agente deve sapere cosa mettere da parte. Aggiorna il contesto o le impostazioni dell'agente ovunque sia salvata la versione vecchia. --- # Strumenti integrati Le azioni che un agente può intraprendere, dalla lettura dei file all'esecuzione del codice e al lavoro tra le app. Source: https://docs.opser.com/it/agents/tools/ ## Gli strumenti trasformano una richiesta in un'azione Uno strumento dà all'agente un'operazione che può effettivamente eseguire. Ha un nome, input strutturati e un risultato. Leggere un foglio di calcolo, eseguire uno script, creare un record e ispezionare un calendario collegato sono azioni dello strumento. La conversazione ti consente di seguire questo lavoro. Si può chiedere in un linguaggio comune. Non è necessario ricordare i nomi degli strumenti. Sono elencati di seguito in modo da poter comprendere le fondamenta della piattaforma e riconoscerle nei dettagli dell'attività. ## File, codice e ricerca | Strumento | Ciò che consente | | --- | --- | | `file` | Leggere e scrivere i file dell'area di lavoro, ispezionare le immagini e restituire un file nella conversazione | | `shell` | Eseguire comandi e script nell'ambiente di lavoro dell'agente | | `storage` | Memorizzare i file oltre una copia funzionante, recuperarli e creare collegamenti di condivisione supportati | | `web` | Cercare e recuperare informazioni web pubbliche | | `browser` | Ispezionare e interagire con le pagine web attraverso il servizio browser supportato | Il filesystem rende possibile il lavoro in più fasi: uno strumento può creare un file letto da un altro strumento. Uno script può elaborare un file di origine e salvare un risultato per il lavoro successivo. Vedere [file persistenti](https://docs.opser.com/it/agents/files/) e [esecuzione di codice](https://docs.opser.com/it/capabilities/code/). ## Documenti e output generati | Strumento | Ciò che consente | | --- | --- | | `pdf` | Leggere, compilare, unire e dividere i PDF e creare un PDF stampando un documento scritto in HTML | | `spreadsheet` | Ispezionare fogli di calcolo e file CSV: elencare i fogli, descriverli e leggerne le righe | | `presentation` | Ispezionare, visualizzare in anteprima ed esportare le presentazioni | | `media` | Generare immagini, video e audio supportati | L'agente crea cartelle di lavoro, presentazioni e report scrivendo brevi programmi nel suo ambiente isolato, che gli offrono formattazione, formule e grafici reali, poi usa questi strumenti per controllare, visualizzare in anteprima e convertire il risultato. Questi strumenti possono funzionare con gli stessi file dell'area di lavoro. Le operazioni disponibili e i fornitori determinano quali formati e opzioni di generazione possono essere utilizzati. Il lavoro di modello e alcune operazioni consumano crediti; "built in" non significa che ogni attività sia gratuita. ## Controllo del lavoro aziendale e della piattaforma | Strumento | Ciò che consente | | --- | --- | | `data` | Gestisci set di dati aziendali di proprietà degli utenti, ispeziona la loro struttura ed esegui query di reporting supportate | | `internal_app` | Creare, testare, rivedere e installare un'app dell'area di lavoro quando il costruttore è abilitato | | `external_app` | Creare e pubblicare un sito Web o un'app web separata con funzionalità di dati esplicite | | `platform` | Controllare o modificare le impostazioni di profilo, contesto, agente, accesso e area di lavoro supportate | | `notify` | Invia una notifica supportata a una persona | L'amministrazione della piattaforma utilizza i permessi del chiamante. Dare all'agente un'istruzione in lingua naturale non lo rende un amministratore. Le app forniscono i propri strumenti per i record che possiedono — ad esempio, l'app Dashboard consente all'agente di ispezionare e organizzare i widget della dashboard; utilizzare tali interfacce piuttosto che trattare ogni tabella di app come un set di dati generale. ## Memoria, guida e coordinamento | Strumento | Ciò che consente | | --- | --- | | `memory` | Salvare, trovare e rimuovere fatti ricordati | | `skills` | Scopri e carica le istruzioni riutilizzabili e gestisci le competenze personalizzate o installate supportate | | `plan` | Tracciare i passaggi dell'attività nella conversazione | | `ask_user_question` | Chiedi una decisione o dettagli mancanti | | `subagent` | Delegare un compito limitato e riportare la sua relazione | | `cron` | Creare, ispezionare, eseguire o rimuovere il lavoro programmato | | `activity` | Scoprire cosa hanno fatto persone e agenti nell'area di lavoro | | `connector` | Scopri e invoca le operazioni supportate sui servizi connessi e avvia un collegamento di account da completare | Gli strumenti possono essere aggiunti al set disponibile di una conversazione quando necessario. Il passaggio di attivazione `toolbox` carica uno strumento differito o un toolkit dell'app; non esegue l'azione aziendale o concede nuovo accesso. ## Cosa è disponibile per il tuo agente Opser fornisce la piattaforma di fondazione strumento. Il set effettivo dipende dalle restrizioni dell'agente, dalla configurazione dell'area di lavoro, dalle app installate, dagli account collegati e dal contesto dell'attività. Alcuni strumenti sono destinati a una conversazione o automazione. La creazione di app e i servizi supportati dal provider possono non essere disponibili in un ambiente anche se la piattaforma li supporta. A [abilità](https://docs.opser.com/it/agents/skills/) Indica all'agente come utilizzare una capacità. Non installa software mancante o autorizza un account. Quando il lavoro è bloccato, chiedere all'agente di identificare lo strumento non disponibile, l'autorizzazione, la connessione o il servizio, quindi risolvere tale dipendenza. --- # Competenze integrate Le istruzioni che aiutano gli agenti a utilizzare Opser bene, oltre alle competenze che aggiungi per i tuoi flussi di lavoro. Source: https://docs.opser.com/it/agents/skills/ ## Istruzioni per fare bene il lavoro Un'abilità è un insieme riutilizzabile di istruzioni per una sorta di compito. Spiega quando usarlo, quali informazioni raccogliere, il processo da seguire e come controllare il risultato. Uno strumento esegue un'azione; un'abilità aiuta l'agente a scegliere e utilizzare tali azioni. Opser fornisce all'agente le descrizioni delle competenze disponibili in modo da poter scegliere una guida pertinente, quindi caricare le istruzioni complete se necessario. Puoi anche chiedergli di usare una particolare abilità. Questo mantiene un'attività focalizzata senza richiedere che ogni istruzione venga ripetuta in ogni messaggio. ## Le competenze di base integrate Queste abilità descrivono come utilizzare la piattaforma principale. Sono separati dal catalogo opzionale e dalle proprie procedure aziendali. **Competenze · Dati fittizi** Tre fondamenti integrati: Gestione dei dati, Creazione di app interne e Creazione di app esterne. Insegnano processi, senza concedere permessi. | Fondazione | Cosa insegna all'agente | | --- | --- | | Gestione dei dati | Ispezionare e strutturare i dati aziendali gestiti dagli utenti, i record di importazione e rispettare i confini dei dati | | Segnalazione dei dati | Trasformare le domande aziendali in query e report utili | | Costruttore di app interne | Progettare, costruire, testare e rivedere un'app all'interno dell'area di lavoro | | Costruttore di app esterne | Crea un'esperienza web separata con i passaggi di accesso e distribuzione dei dati dichiarati | | Schedulazione | Impostare il lavoro ricorrente o una tantum e verificarne la tempistica e l'esecuzione | | Memoria | Salvare fatti utili, recuperare lo sfondo pertinente e rimuovere le informazioni obsolete | | Integrazioni | Scopri i servizi connessi e scegli le operazioni e gli account supportati | Le istruzioni non rimuovono i prerequisiti di una capacità. Ad esempio, l'abilità di creazione di app può spiegare il flusso di lavoro anche quando la creazione non è stata abilitata in quell'ambiente. ## Aggiungi il modo di lavorare della tua azienda Crea un'abilità personalizzata per un processo che ti aspetti di ripetere. Dare un nome chiaro e descrivere il trigger, input richiesti, passaggi, output e controlli. Provalo con un esempio rappresentativo prima di renderlo parte del lavoro di routine. > Per una revisione settimanale delle operazioni, utilizzare l'intervallo di date fornito, riassumere il lavoro aperto per proprietario, identificare gli elementi in stallo e terminare con un elenco di azioni. Mantenere le valute separate e collegare ogni scoperta alla sua fonte. L'agente può anche scriverne una per te. Quando qualcuno che può modificarlo descrive in chat un modo lungo e passo per passo di svolgere un lavoro, l'agente propone una competenza tramite una scheda di approvazione, invece di aggiungere i passaggi alle sue conoscenze, che restano brevi. Scegli l'ambito giusto. Le competenze possono essere disponibili per un agente, condivise attraverso la libreria aziendale o richieste nell'area di lavoro quando configurate da un utente autorizzato. Le modifiche alle istruzioni condivise influiscono più della conversazione corrente. ## Competenze delle app e installazioni facoltative Le app installate possono fornire indicazioni per i propri record e flussi di lavoro. La piattaforma può rendere disponibili tali competenze insieme agli strumenti dell'app, soggetti ad accesso. Nelle impostazioni dell'agente, apri **Plugin** e scegli la scheda **Competenze**. La scheda elenca le competenze dell'agente, e **Nuova competenza** sotto la sua descrizione ne crea una tua. Non c'è un catalogo da sfogliare: chiedi all'agente una competenza opzionale, e può trovarla nel catalogo e installarla dopo la tua approvazione. Le voci del catalogo si evolvono, quindi chiedi all'agente cosa è disponibile piuttosto che trattare un elenco nei documenti come un inventario di prodotti fisso. Ispezionare le istruzioni e scegliere deliberatamente il campo di applicazione dell'agente o dell'area di lavoro. ## Mantenere i confini chiari Un'abilità non consente l'accesso, la connessione di un account o l'installazione di un'app descrivendola. I suoi strumenti richiedono ancora le giuste autorizzazioni, la configurazione e qualsiasi approvazione applicabile. Se un'abilità fa riferimento a un'operazione non disponibile, risolvere tale dipendenza invece di assumere le istruzioni rese disponibili. Utilizzare [contesto](https://docs.opser.com/it/agents/context/) per fatti stabili, un'abilità per una procedura ripetibile e la conversazione per l'attività in questione. Vedere [Strumenti integrati](https://docs.opser.com/it/agents/tools/) per il livello di esecuzione. --- # Approvazioni e controllo Esamina le azioni proposte e scegli dove l'agente dovrebbe mettere in pausa la tua decisione. Source: https://docs.opser.com/it/agents/approvals/ ## Esamina una richiesta di approvazione Alcune azioni si fermano e ti aspettano prima di correre. La scheda di approvazione sopra il campo di scrittura dice cosa vuole fare l'agente e di cosa si tratta; aprila per un'anteprima dei dettagli. Leggi l'obiettivo e i valori - destinatari, importi, date e qualsiasi cosa con un effetto esterno o irreversibile - prima di decidere. **Rivedi un’azione · Dati fittizi** L’account Gmail di Maya propone un’email ad alex@northstar.example per rivedere il portale. Puoi consentire, negare, richiedere una modifica o autorizzare azioni future per quell’account. La carta ti dà quattro scelte: | Scelta | Cosa fa | | --- | --- | | **Consenti** | Eseguire questa azione una volta, come mostrato. | | **Deny** | Salta questa azione. Dite all'agente cosa cambiare; può proporre un'azione corretta. | | **Richiedi modifica** | Rimandare l'azione con un cambiamento invece di un rifiuto piatto. Per un'e-mail in uscita è possibile modificare l'oggetto e il corpo in linea prima che venga inviato. | | **Consenti sempre questo** (nel menu accanto a **Consenti**) | Eseguilo ora e smettila di chiedere questo tipo di azione. Per un connettore, **Consenti sempre {account}** limiti che l'autorizzazione in piedi a un account collegato, in modo da approvare un invio da una cassetta postale mai auto-invia da un altro. | Un'azione negata o modificata non annulla il lavoro già terminato. Se una richiesta successiva viene respinta, un'azione completata in precedenza rimane eseguita: controlla il record interessato piuttosto che presumere che un rifiuto abbia ripristinato tutto. Mentre una richiesta è in attesa, la chat resta in pausa e la riga di lavoro dell'agente dice **In attesa della tua approvazione**. La scheda in sospeso compare appena sopra il campo di scrittura, anche quando è un'esecuzione di un'automazione dell'agente ad aspettarla. Consentila o negala per far continuare l'agente. Quando decidi, la scheda scompare; con **Mostra i passaggi dell’agente** attivo in **Impostazioni → Generali**, la decisione resta nella chat tra i passaggi dell'agente. Una richiesta lasciata senza risposta scade dopo 24 ore. ## Decidi cosa deve essere approvato Ogni azione ha una categoria di rischio, e tale categoria stabilisce se viene eseguita da sola o chiede prima: **Approvazioni · Dati fittizi** Questo esempio consente di leggere i file e chiede conferma prima di inviare email o eliminare file. Le impostazioni predefinite variano per strumento. | Categoria di rischio | Tipico default | Esempi | | --- | --- | --- | | **Solo lettura** | Corre senza chiedere | Ricerca dei record, lettura di un file, elenco degli eventi del calendario | | **Mutando** | Varianti per strumento | Creare o aggiornare un record | | **Distruttivo** | Chiede prima | Eliminazione dei record, rimozione dei campi | | **Esterno** | Chiede prima | Invio di e-mail, invio a un servizio connesso | | **Admin** | Chiede prima | Modifica delle impostazioni, degli utenti o delle autorizzazioni | Apri le impostazioni **Approvazioni** dell'agente per vedere il catalogo degli strumenti e delle loro singole azioni. Per ognuna puoi impostare **Consenti sempre** o **Chiedi sempre**, ripristinare il valore predefinito di un'azione o applicare una scelta a un intero gruppo di rischio. Le azioni sensibili hanno un valore predefinito voluto: per esempio, creare o installare un'abilità chiede prima, perché un'abilità salvata diventa un'istruzione permanente per il lavoro successivo. Il suo proprietario o un amministratore può anche chiederlo all'agente nella sua chat; ogni modifica attende l'approvazione. Una buona configurazione consente di eseguire liberamente le letture di routine e mantiene un punto di revisione sulle modifiche che lasciano l'area di lavoro o non possono essere annullate. Il giusto equilibrio dipende da quanta responsabilità hai dato a quell'agente. ## Eseguire senza pause utilizzando la modalità automatica La chat di ogni agente ha un menu delle autorizzazioni accanto alla scelta del modello. **Chiedi sempre** segue le regole di approvazione descritte sopra, quindi le azioni che richiedono un'approvazione ti aspettano. **Modalità automatica** esegue in quella chat le azioni soggette ad approvazione senza fermarsi a chiedere, utile una volta che ti fidi di una routine e vuoi che arrivi fino in fondo. Torna a **Chiedi sempre** per rivedere di nuovo ogni richiesta. La chat mantiene la scelta finché qualcuno con accesso non la cambia, e la prima volta che apri la chat di un altro agente parte con la modalità che hai scelto per ultima. La modalità automatica rispetta comunque le autorizzazioni dell'agente e non concede mai un accesso che non ha già. Le nuove [automazioni](https://docs.opser.com/it/agents/automations/) create dalla configurazione o dall’agente si eseguono automaticamente per impostazione predefinita. La creazione autorizza in anticipo le azioni di app e integrazioni descritte nell’attività. Usano i permessi e gli account esistenti; la modalità automatica della tua chat non modifica l’autorizzazione salvata di un’automazione precedente. ## I permessi continuano ad applicarsi L'approvazione è il consenso a una particolare azione. Il permesso decide se l'agente può eseguire questo tipo di azione. L'approvazione di una richiesta non può consentire l'accesso a un'app, una cassetta postale o un record limitati. Un agente non fa mai più di quanto potrebbe il suo proprietario, né più di quanto la persona che gli parla può fare in Opser. Quando più persone usano un agente, conta anche l'accesso di chi ha inviato la richiesta. Vedere [autorizzazioni e gruppi di accesso](https://docs.opser.com/it/workspace/permissions/). ## Quando il lavoro appare bloccato Controlla nella chat dell'agente se c'è una richiesta in attesa sopra il campo di scrittura. In **Automazioni**, un'esecuzione in attesa nell'elenco **Cronologia** mostra **Richiede approvazione**. Se non c'è nulla in sospeso, chiedi all'agente cosa l'ha fermato, oppure attiva **Mostra i passaggi dell’agente** in **Impostazioni → Generali** e cerca un errore nel risultato più recente di uno strumento. Un account disconnesso, un'autorizzazione negata o un [saldo crediti esaurito](https://docs.opser.com/it/billing/usage/) richiedono ciascuno una soluzione diversa. Non inviare nuovamente la stessa scrittura mentre una richiesta precedente è ancora in sospeso. Dopo un'interruzione di connessione, controllare il record di destinazione prima di riprovare in modo da non creare la stessa cosa due volte. --- # Modelli e account Scegli le ragioni del tuo agente e gestisci una connessione di account modello supportata. Source: https://docs.opser.com/it/agents/models/ ## Apri le impostazioni generali dell’agente Seleziona il tuo agente, quindi apri **Generali**. L’elenco raggruppa i modelli disponibili per aiutarti a valutare capacità e costo. La disponibilità può cambiare in base alla configurazione dello spazio di lavoro e agli account collegati. **Scegli un modello · Dati fittizi** Avanzato è selezionato tra i profili Base, Avanzato ed Esperto. Personalizzato apre i modelli disponibili e i livelli di ragionamento supportati. ## Scegli un modello per il compito I modelli provengono da diversi fornitori, tra cui le famiglie Claude, GPT e Gemini e altre opzioni supportate. Sono organizzati in tre fasce di costo: | Fascia | Indicata per | | --- | --- | | **Premium** | Ragionamento impegnativo: analisi complesse, creazione di app e attività articolate in cui la qualità è prioritaria. | | **Standard** | Lavoro quotidiano che richiede un buon ragionamento, con un costo inferiore per attività. | | **Budget** | Attività frequenti o di routine, come brevi riepiloghi e ricerche rapide. | Accanto al nome, ogni modello mostra anche un livello di capacità: **Basic**, **Advanced** o **Frontier**. È distinto dalla fascia di costo: un modello può offrire buone capacità a un prezzo contenuto. Scegli il modello nel selettore oppure apri **Personalizzato** per impostare un modello specifico e il livello di ragionamento. Le opzioni OpenAI normali usano crediti Opser. ## Imposta il livello di ragionamento Il livello di ragionamento determina quanto il modello riflette prima di rispondere: **Disattivato**, **Minimo**, **Basso**, **Medio**, **Alto** e, nei modelli compatibili, **Xhigh**. Un livello maggiore può migliorare le analisi difficili, ma richiede più tempo e crediti. Un livello minore è più rapido ed economico per compiti semplici. Non tutti i modelli supportano ogni livello: cambiando modello, il livello può essere adattato a quello disponibile più vicino. ## Assegna un ruolo all’agente Le impostazioni generali includono anche **personalità** e **conoscenze**. La personalità descrive come l’agente deve comportarsi e comunicare. Le conoscenze forniscono informazioni di settore e istruzioni permanenti per il suo ruolo. Sono separate dal contesto condiviso dell’organizzazione e dalla conversazione attuale. Prima di modificare le impostazioni, scegli l’agente corretto. Ogni agente ha una sola configurazione, valida per tutti quelli che possono usarlo; modificare un agente non cambia gli altri. Su un agente usato da altre persone, solo il proprietario o un amministratore modifica queste impostazioni. Vedi [Contesto e memoria](https://docs.opser.com/it/agents/context/). ## Collega un account ChatGPT Apri **Impostazioni → Profilo** e usa **Account collegati** per avviare **Collega ChatGPT** e permettere ai tuoi agenti di usare i modelli del tuo abbonamento ChatGPT. Avvia il collegamento, segui le istruzioni di accesso e torna in Opser per verificarne lo stato. Gli agenti di tua proprietà possono accedere al collegamento del tuo account; un collegamento fatto in passato su un agente specifico resta elencato e gestibile lì. Non incollare mai le credenziali in una conversazione. Dopo il collegamento, il selettore dei modelli aggiunge una seconda opzione **Advanced** e una seconda opzione **Expert**, ciascuna con un’etichetta **Abbonamento** colorata. La finestra Personalizzato mantiene i modelli GPT normali in **OpenAI · Crediti Opser** e aggiunge una sezione separata **OpenAI · Abbonamento ChatGPT**. Solo le opzioni con l’etichetta Abbonamento usano il tuo piano ChatGPT; le opzioni Advanced, Expert e OpenAI senza etichetta continuano a usare crediti Opser. ## Comprendi come vengono addebitati i costi Un abbonamento collegato e i crediti Opser seguono modalità di fatturazione diverse. Il lavoro del modello usa crediti Opser, tranne quando utilizza un account collegato, soggetto al piano e ai limiti del relativo fornitore. Collegare un account non rende gratuiti tutti gli strumenti, le integrazioni o i contenuti generati. Controlla [Utilizzo](https://docs.opser.com/it/billing/usage/) per capire il consumo di ciascuna attività. ## Modifica o scollega Salva il modello e il livello di ragionamento nelle impostazioni generali. Usa i controlli di **Account collegati** nel Profilo per scollegare l’account quando non vuoi più che i tuoi agenti lo utilizzino. Se un modello non è più disponibile, scegline un altro e verifica il collegamento dell’account prima di riprovare. --- # File persistenti e spazio di lavoro Come un agente mantiene i file di origine, gli script e i risultati da un'attività all'altra. Source: https://docs.opser.com/it/agents/files/ ## Un filesystem che dura oltre una chat Ogni agente ha un proprio spazio di lavoro persistente. Può mantenere gli input caricati, gli script, le note di lavoro e i file generati lì, quindi usarli di nuovo in un lavoro successivo con lo stesso agente, comprese le sue automazioni. I riavvii di runtime ordinari utilizzano la stessa area di lavoro piuttosto che iniziare con una directory vuota. La tua chat con l'agente non si azzera mai e compattarla non rimuove i file. L'agente può trovare i file di prima nella chat, quelli che hai inviato e quelli che ha creato, quindi puoi chiedere “il report del mese scorso”. Non legge tutti i file salvati a ogni richiesta: dagli il nome del file o descrivi il materiale quando vuoi continuare un lavoro precedente. ## Input, script e risultati L'agente può leggere e scrivere file ed eseguire codice contro di loro. Usa comunemente le posizioni dell'area di lavoro come `uploads/` per gli input, `artifacts/` per i risultati e `.tmp/` per i lavori di scratch. I nomi di file esatti provengono dall'attività e dai suoi strumenti. > Usa il foglio di calcolo sorgente e lo script di confronto che abbiamo salvato la scorsa settimana. Eseguire gli stessi controlli su questo nuovo file e salvare il rapporto di questa settimana separatamente. Chiedigli di mantenere uno script riutilizzabile quando un'attività comporta trasformazioni o controlli ripetibili. Uno script salvato fornisce un punto di partenza concreto; [Codice e script](https://docs.opser.com/it/capabilities/code/) spiega l'ambiente di esecuzione. ## Allegare e ispezionare i file Allegare un file al messaggio e spiegare quale foglio, pagine, colonne o record contano. Per vedere tutti i file della chat, quelli che hai caricato e quelli creati dall'agente, apri l'ingranaggio nell'intestazione della chat e scegli **File**. I risultati compaiono anche come file nella conversazione. Apri l'output effettivo e controlla i suoi valori, formule e layout. Se uno strumento non riesce, un messaggio che promette un file non è sufficiente: chiedere il risultato salvato e verificarlo si apre. ## File di lavoro e archiviazione aziendale | Posizione | Usalo per | | --- | --- | | Area di lavoro dell'agente | Materiale di origine, script, lavoro intermedio e artefatti per quell'agente | | Spazio di lavoro | File e allegati memorizzati a cui fanno riferimento i record aziendali | | Un'app installata | Documenti o record che richiedono l'organizzazione, la condivisione e il flusso di lavoro dell'app | Mantenere un file in un'area di lavoro agente non lo pubblica né lo rende un record app condiviso. Chiedi all'agente di memorizzare il file finale nella destinazione prevista. La capacità di archiviazione può spostare un file dall'area di lavoro in storage e recuperarlo per il lavoro successivo. Quando un destinatario ha bisogno di un link al di fuori Opser, rendere esplicito tale intento. La condivisione supportata include link in scadenza e collegamenti pubblici che possono essere revocati. Un collegamento pubblico è una decisione di condivisione separata; non confonderlo con un normale allegato in-app. ## Ambito e ciclo di vita Lo spazio di lavoro appartiene all'agente. Passare a un altro agente significa utilizzare un filesystem diverso. Un agente usato da più persone mantiene un unico spazio di lavoro per tutte, quindi scegli l'agente con il pubblico del team previsto. La persistenza non è una politica di backup. I file che elimini non sono più disponibili, il lavoro con i graffi non dovrebbe essere l'unica copia di un risultato importante e l'eliminazione di un agente può rimuovere la sua area di lavoro. Memorizzare importanti deliverable nella sede aziendale appropriata prima di rimuovere un agente. [Assegni di stoccaggio](https://docs.opser.com/it/billing/plans/) Si applica anche ai lavori in corso. --- # Automazioni e pianificazioni Trasformare un flusso di lavoro utile in lavoro che viene eseguito al momento giusto o in risposta a un evento. Source: https://docs.opser.com/it/agents/automations/ ## Inizia con un compito di lavoro Il modo più semplice per crearne una è chiederlo all’agente nella sua chat. Di’ cosa deve succedere e quando: l’agente tiene conto del tuo spazio di lavoro, chiede ciò che non è chiaro e crea l’automazione. Definisci attività, dati di origine, destinatari e fuso orario prima che la crei. Su un agente usato anche da altri, chiunque abbia accesso vede, crea e modifica le sue automazioni, salvo che il proprietario lo abbia disattivato; allora solo il proprietario o un amministratore, e i risultati compaiono comunque nella chat dell'agente. > Ogni lunedì alle 9 nel mio fuso orario, riassumi le attività scadute per responsabile e inviami un breve aggiornamento. Non modificare lo stato delle attività. Puoi anche chiedere prima l’attività una volta nella chat. Controlla l’orario salvato per evitare ambiguità come «domani mattina». ## Orari e trigger di eventi Per crearne una tu stesso, apri l’ingranaggio nell’intestazione della chat, scegli **Automazioni** e poi **Nuova automazione**, sotto la descrizione della sezione. Dai un titolo, scrivi l’attività in **Cosa deve fare questa automazione?** e scegli **Aggiungi attivazione**: **Automazioni · Dati fittizi** Un riepilogo viene eseguito il lunedì alle 09:00 Europe/Rome. Una seconda automazione risponde a un evento dell’app per le richieste clienti. Entrambe sono attive. - **A orari fissi:** si ripete ogni ora, ogni giorno, ogni settimana o ogni mese all’ora che scegli, nel tuo fuso orario. - **Una volta:** si esegue una sola volta, alla data e all’ora che scegli. - **Quando succede qualcosa:** si avvia con un evento di un’app. Scegli un’app Opser installata o un account collegato, poi uno dei suoi eventi. Gli eventi delle app Opser non richiedono un account collegato. L’agente riceve i dettagli dell’evento durante l’esecuzione. Scegli **Crea** per salvarla; chiudi il modulo per annullare. Se nulla può avviare un’automazione, **App** indica **Nessuna app installata**; se un’app non offre eventi, indica **Nessun evento disponibile**. Le opzioni dipendono dallo spazio di lavoro e dagli accessi dell’agente. L’agente può scoprire gli stessi eventi, e quelli dei suoi account collegati, come una nuova email in Gmail, quando chiedi un’automazione in chat. ## Rivedere i lavori in corso Le nuove automazioni, che le crei tu o l’agente, si eseguono automaticamente per impostazione predefinita. Creandone una, autorizzi in anticipo le azioni descritte nell’attività, tra cui inviare email e aggiornare i dati delle app. Non ci sono elenchi separati di accesso alle app da selezionare né richieste di approvazione per ogni azione durante queste esecuzioni. Specifica con precisione azioni e destinatari. L’esecuzione automatica richiede comunque permessi validi, account collegati e crediti disponibili. Non concede nuovi accessi. Le automazioni precedenti mantengono le loro restrizioni di esecuzione originali. Una pianificazione senza un’autorizzazione valida si sospende con **Richiede autorizzazione** invece di fallire ripetutamente o perdere l’attività salvata. Ogni esecuzione lavora per conto suo e i suoi risultati compaiono nella chat dell’agente, che li riceve con il messaggio successivo nella chat. Ogni esecuzione compare nella scheda **Cronologia**, accanto alle automazioni. Controlla lì la prima: **Visualizza** apre la chat sull’ultimo messaggio di quell’esecuzione, e un’esecuzione che aspetta te mostra **Esamina**, con l’approvazione sopra il campo di scrittura. Verifica il risultato prima di farci affidamento. Se manca un accesso, correggilo invece di riprovare ripetutamente l’attività. Se l’invio email del riepilogo settimanale è abilitato nello spazio di lavoro, un’esecuzione riuscita della revisione settimanale predefinita può inviare un rapporto al proprietario dell’agente predefinito. La consegna dipende dalle informazioni disponibili, dalle preferenze email e dai limiti di frequenza. Un’esecuzione non riuscita non invia il rapporto. Consulta il risultato nella chat e gestisci le email facoltative in **Impostazioni → Notifiche**. Se un’esecuzione pianificata non riesce, chiedi all’agente di esaminare la diagnostica senza rieseguirla. L’agente può mostrare errori registrati, tentativi e operazioni degli strumenti che sei autorizzato a vedere nella chat. Un’azione tentata non conferma che una modifica sia stata salvata: controlla i dati interessati prima di riprovare. I dettagli registrati possono essere incompleti, soprattutto per esecuzioni precedenti o interruzioni del processo dell’agente. ## Mettere in pausa, modificare o rimuovere Usa i controlli per sospendere, modificare o rimuovere le automazioni che non servono più. Puoi anche chiedere all’agente in chat di aggiustare un’automazione esistente: aggiorna pianificazione, attività, fuso orario o evento di origine sul posto, così l’automazione conserva identità e cronologia delle esecuzioni invece di essere eliminata e ricreata. Se l’automazione è cambiata nel frattempo o un’esecuzione è in corso, la modifica viene rifiutata invece di essere applicata alla cieca. Se modifichi un’automazione creata da qualcun altro, diventa tua: da quel momento viene eseguita con il tuo accesso. Ogni automazione mostra il proprio trigger con un’icona e un’etichetta distinte, così pianificazioni, eventi delle app ed eventi delle integrazioni si distinguono a colpo d’occhio. Controlla le automazioni esistenti prima di crearne una sostitutiva per evitare esecuzioni duplicate. In caso di errore o interruzione della connessione, verifica cronologia e dati interessati prima di riprovare: un’azione potrebbe essere già stata completata. ## Autorizzare una pianificazione sospesa Se un’automazione pianificata mostra **Richiede autorizzazione**, chi può modificarne le automazioni può scegliere **Autorizza**. Controlla l’attività salvata e conferma con **Autorizza e riprendi**. Da quel momento l’automazione viene eseguita con il tuo accesso. Lascia disattivato **Esegui automaticamente le azioni descritte in questa attività** per mantenere le restrizioni sugli strumenti già in vigore, oppure attivalo esplicitamente per autorizzare in anticipo le azioni descritte nell’attività. Questo non concede accessi aggiuntivi ad app o account collegati. L’autorizzazione conserva identità, attività, pianificazione e cronologia dell’automazione. Non esegue l’attività né recupera le occorrenze saltate: una data futura resta invariata, e una pianificazione ricorrente la cui data è passata riprende alla prossima occorrenza futura. Una pianificazione singola nel passato richiede prima una nuova data. Controllare e autorizzare la pianificazione non avvia un’esecuzione dell’agente né consuma crediti dei modelli. --- # Collega i tuoi strumenti Dare a un agente l'accesso ai conti esterni di cui ha bisogno per un'attività. Source: https://docs.opser.com/it/agents/integrations/ ## Connetti un account Apri le impostazioni dell'agente con l'ingranaggio nell'intestazione della chat e scegli **Plugin**; si apre sulla scheda **Integrazioni**. Seleziona **Nuova integrazione**, sotto la descrizione della scheda, e scegli un servizio disponibile. Segui il flusso di connessione e approva gli ambiti richiesti con il provider esterno. Torna a Opser e verifica che la connessione sia attiva. **Integrazioni · Dati fittizi** Gmail e Google Calendar sono collegati a maya@northstar.example per questo agente di esempio. I servizi disponibili dipendono dal workspace. Puoi anche chiedere all'agente di collegare un'integrazione supportata. Completa il passaggio di accesso da solo quando l'agente ti dà un collegamento di connessione. Non inviare mai password, cookie di sessione o chiavi segrete API come messaggi di chat. ## Scegli l'account e l'agente giusto Controlla quale agente stai configurando e quale account esterno autorizzi. Una connessione appartiene all'agente, non a te: chiunque abbia accesso all'agente può farlo lavorare in quell'account. L'accesso alla cassetta postale di un'app installata è un ambito separato. Collega solo account che tutti quelli con accesso all'agente possono usare. Su un agente specialista, chiunque abbia accesso può collegare i propri account; ognuno può scollegare gli account che ha collegato, e il proprietario o un amministratore qualsiasi. Se un'app installata utilizza anche quel servizio, controlla le impostazioni di connessione e accesso separate dell'app. ## Utilizzare la connessione Nomina il servizio e il risultato nella tua richiesta. L'agente può scoprire le operazioni supportate e utilizzare i permessi concessi dal provider. Alcuni scritti possono richiedere l'approvazione. > Trova le riunioni dei clienti della prossima settimana nel calendario collegato e prepara un briefing dagli account CRM correlati. Non inviare messaggi. I servizi e le operazioni disponibili dipendono da ciò che il tuo ambiente supporta. Un nome di servizio familiare non è una promessa che ogni caratteristica di quel servizio è esposto in Opser. ## Riconnettere o scollegare L'autorizzazione scaduta, gli ambiti revocati e le modifiche al provider possono interrompere una connessione. Controllare lo stato, ricollegarsi se necessario e riprovare una piccola lettura prima di ripetere una scrittura. Disconnetti un account che non usi più da **Plugin**, oppure chiedilo all'agente nella sua chat; prima ti chiede l'approvazione. Le automazioni avviate da quell'account vengono rimosse con esso, quindi controlla le pianificazioni o i flussi di lavoro che ne dipendevano. ## Integrazioni app Alcune app utilizzano connessioni gestite dall'amministratore per le proprie operazioni. Questi possono avere controlli di configurazione e accesso separati dalle connessioni dell'account dell'agente. --- # Cosa può fare Opser Una guida pratica al lavoro che i tuoi agenti possono svolgere e alle esigenze di ogni capacità. Source: https://docs.opser.com/it/capabilities/overview/ ## Scegli un risultato Opser agenti combinano strumenti di piattaforma, strumenti di app installati e servizi connessi. Inizia con ciò che vuoi ottenere; l'agente può scegliere gli strumenti appropriati quando sono disponibili. | Lavoro | Inizia da qui | | --- | --- | | Elaborare i file con codice riutilizzabile | [Codice e script](https://docs.opser.com/it/capabilities/code/) | | Trovare e aggiornare i record strutturati | [Dati e rapporti](https://docs.opser.com/it/capabilities/data/) | | Analizzare PDF e preparare documenti | [Documenti e PDF](https://docs.opser.com/it/capabilities/documents/) | | Pulire, calcolare ed esportare i dati tabulari | [Spreadsheets](https://docs.opser.com/it/capabilities/spreadsheets/) | | Preparare un diapositive deck | [Presentazione](https://docs.opser.com/it/capabilities/presentations/) | | Generare immagini, video o audio supportati | [generazione multimediale](https://docs.opser.com/it/capabilities/media/) | | Indagare sulle fonti pubbliche | [Ricerca sul Web](https://docs.opser.com/it/capabilities/research/) | | Creare uno strumento di spazio di lavoro | [Costruzione interna dell'app](https://docs.opser.com/it/capabilities/internal-apps/) | | Creare un sito web o un portale separato | [costruzione di app esterne](https://docs.opser.com/it/capabilities/external-apps/) | | Assembla una panoramica del tuo lavoro | [Tavole](https://docs.opser.com/it/capabilities/dashboards/) | | Esegui lavori ricorrenti o basati su eventi | [schedule e automazioni](https://docs.opser.com/it/agents/automations/) | | Lavorare su conti esterni | [Integrazioni](https://docs.opser.com/it/agents/integrations/) | Vedere [Strumenti integrati](https://docs.opser.com/it/agents/tools/) per la fondazione della piattaforma dietro questi flussi di lavoro. ## Più di una singola operazione Un'attività può comportare diversi passaggi: leggere i record, porre una domanda, analizzare i file, delegare un lavoro limitato e preparare un risultato. La conversazione unisce questi passi. L'agente può utilizzare il proprio spazio di lavoro per elaborare i file ed eseguire il codice di supporto quando l'ambiente lo consente. **Un piano in corso · Dati fittizi** L’analisi dei dati è completata, il portale è in costruzione e la verifica dell’accesso e i test sono in attesa. Alcuni strumenti diventano disponibili solo quando sono pertinenti all'attività. Le app installate contribuiscono con le proprie azioni; l'interfaccia dell'app e i suoi strumenti agente funzionano con gli stessi record sottostanti. ## Cosa controlla la disponibilità Una funzionalità ha bisogno della configurazione dell'area di lavoro appropriata, delle autorizzazioni e talvolta di un account connesso. Alcune operazioni consumano crediti oltre all'uso del modello. Riesame [Utilizzo e crediti](https://docs.opser.com/it/billing/usage/) e [Regole di approvazione](https://docs.opser.com/it/agents/approvals/) prima di automatizzare un flusso di lavoro costoso o consequenziale. Quando qualcosa non è disponibile, chiedi all'agente quale dipendenza manca. Un modello diverso da solo non installerà un'app, autorizzerà una cassetta postale o concederà l'autorizzazione. --- # Codice e script Lascia che il tuo agente scriva ed esegua il codice per elaborare i file, controllare i risultati e completare le attività personalizzate. Source: https://docs.opser.com/it/capabilities/code/ ## Chiedi il risultato, lascia che l'agente scriva il codice Opser gli agenti possono scrivere ed eseguire script come parte del lavoro svolto. Questo è utile quando un'attività richiede calcoli ripetibili, una trasformazione personalizzata, la convalida su molti file o un passaggio che non si adatta a una singola azione dell'app. > Confrontare queste due esportazioni, normalizzare le date e produrre un elenco di file aggiunto, rimosso e modificato record. Salva lo script di confronto in modo da poterlo eseguire di nuovo il mese prossimo. Non è necessario scrivere il copione da soli. Spiegare gli input, le regole, l'output desiderato e ciò che deve rimanere invariato. ## Come funziona l'esecuzione L'agente utilizza la sua capacità di file per ispezionare o scrivere il sorgente e la sua capacità di shell per eseguire comandi. I comandi vengono eseguiti nell'ambiente di lavoro dell'agente, con l'area di lavoro come directory iniziale. I risultati e gli errori tornano alla conversazione. I comandi disponibili, i runtime linguistici e le librerie dipendono da quell'ambiente. L'agente dovrebbe controllare ciò che è installato prima di scegliere un approccio. Uno script che è stato scritto non è uno script che è stato eseguito correttamente; ispezionare il risultato dell'esecuzione e il file di output. ## Script e input persistenti Il [filesystem dell'agente persiste](https://docs.opser.com/it/agents/files/) da un'attività all'altra. Salva script e input significativi con nomi chiari in modo che le attività successive possano trovarli. Chiedi all'agente di spiegare gli input e gli output dello script, specialmente se qualcun altro lo riutilizzerà. Per un confronto ricorrente, mantenere invariata la sorgente originale e salvare l'output di ogni esecuzione separatamente. Controllare un piccolo campione, i totali e i valori mancanti prima di fare affidamento sul risultato completo. Una pianificazione può riutilizzare un approccio di lavoro quando sono disponibili i file e l'accesso necessari. ## Lavora con i dati aziendali Utilizza gli strumenti dell'app per i record di proprietà di un'app e la capacità dei dati per i set di dati gestiti dall'utente supportati. Il codice in esecuzione non consente l'accesso alle tabelle private di un'altra app, ai file di un collega o a un servizio che non è stato collegato. L'agente può combinare queste funzionalità: recuperare i dati autorizzati, elaborarli nel suo spazio di lavoro e scrivere il risultato attraverso l'interfaccia supportata. Chiedigli di mostrare la destinazione e le modifiche proposte prima di un aggiornamento consequenziale. ## Controllo e limiti L'esecuzione della shell è limitata all'ambiente dell'agente e lo strumento può essere disabilitato dalle restrizioni sugli strumenti di un agente. I comandi non ereditano la configurazione segreta del processo della piattaforma. Modifiche come cancellazione, sovrascrittura, pubblicazione o scrittura esterna possono richiedere l'approvazione ai sensi delle regole dell'azione. Il codice può ancora commettere errori. Dare all'agente un punto di revisione per il lavoro importante e verificare l'output. I comandi in esecuzione prolungata o non disponibili possono fallire; chiedere l'errore effettivo e i passaggi completati prima di riprovare. Anche uno script salvato è diverso da un'app distribuita. Se i compagni di squadra hanno bisogno di un'interfaccia duratura e di un flusso di lavoro condiviso, utilizzare [builder interno dell'app](https://docs.opser.com/it/capabilities/internal-apps/). --- # Dati e report Trasformare i record aziendali e i file di origine in risposte utili, con un percorso chiaro per tornare alle prove. Source: https://docs.opser.com/it/capabilities/data/ ## Lavorare con informazioni strutturate Chiedi all'agente di trovare, confrontare, riassumere o aggiornare i dati nelle app a cui puoi accedere. Identifica l'app e i filtri utili come l'intervallo di date, il proprietario, il cliente o lo stato. > Nelle vendite, riassumi gli ordini confermati dovuti il mese prossimo per cliente e valuta. Includi i link agli ordini e gli ordini di bandiera senza una data di consegna. Per i dati al di fuori di un'app installata, la capacità dei dati della piattaforma può funzionare con entità e record strutturati. Quando hai bisogno di un'interfaccia utente riutilizzabile attorno a tali informazioni, considera un [app interna](https://docs.opser.com/it/capabilities/internal-apps/). ## Dati delle app e dataset gestiti dall’utente Le app possiedono i loro tavoli e le regole di business. Utilizzare i loro strumenti supportati o le operazioni esposte per tali record. Lo strumento dati della piattaforma gestisce separatamente i set di dati aziendali di proprietà degli utenti: entità, campi, relazioni, record e le loro impostazioni di accesso. L'agente può ispezionare un set di dati esistente, definire una struttura, importare record e interrogarlo per l'analisi. Il reporting supportato SQL è di sola lettura e rientra nei dati aziendali consentiti. Non è un'interfaccia di query senza restrizioni in tabelle di app o piattaforme private. ## Creare un report Specificare il pubblico, l'intervallo di date, il raggruppamento e il formato di output. Chiedi i riferimenti alla fonte o i collegamenti di registrazione in modo da poter controllare il risultato. Mantieni le valute e le unità esplicite. 1. Confermare quali record sono inclusi ed esclusi. 2. Controllare le regole di raggruppamento e calcolo. 3. Ispezionare un campione dei record sottostanti. 4. Scegli un output utile: un riepilogo delle conversazioni, un foglio di calcolo, una presentazione o una dashboard. I dati mancanti dovrebbero essere visibili nel risultato. Chiedi all'agente di segnalare l'incertezza invece di colmare le lacune con le ipotesi. ## Apportare modifiche con attenzione Analisi esplorativa separata dagli aggiornamenti di massa. Chiedere un'anteprima che identifichi i record interessati, quindi rivederla prima di autorizzare la modifica. Le autorizzazioni e le regole di approvazione specifiche dello strumento si applicano ancora. > Mostrami i contatti con nomi di aziende mancanti. Suggerisci le corrispondenze utilizzando i loro domini di posta elettronica, ma attendi la mia recensione prima di salvare le modifiche. ## Report ripetibili Utilizzare a [abilità](https://docs.opser.com/it/agents/skills/) mantenere un formato di report coerente, e [calendario](https://docs.opser.com/it/agents/automations/) per eseguirlo regolarmente. Per una visualizzazione dell'area di lavoro continuamente utile, vedere [Dashboard](https://docs.opser.com/it/capabilities/dashboards/). ## Scoprire tabelle e colonne senza risultati troncati L'azione `data.describe_schema` dell'agente restituisce l'elenco delle tabelle in pagine di 25 elementi (massimo 50). Usa `search` per filtrare i nomi, poi segui `next_input` finché è null. Specifica `entityId` per esaminare i nomi esatti delle colonne di una tabella; anche questi campi sono paginati. Così eviti di ipotizzare nomi come `sort_order` quando la colonna reale è `position`. La ricerca mantiene i controlli di accesso alle app e ai dati della persona e dell'agente. L'azione `list_data` di Dashboard usa lo stesso flusso con `limit`, `offset`, `search` e `next_input`. I conteggi esatti richiedono `include_record_count: true` (`includeRecordCount` nello strumento data); la ricerca ordinaria non li calcola. Questi controlli riguardano gli strumenti, non modificano Impostazioni → Dati. ## Limiti dei report SQL `raw_sql` accetta una sola query SELECT o WITH di sola lettura, con etichette letterali, UNION/UNION ALL, DISTINCT, aggregazioni e conversioni approvate. I risultati sono limitati a 500 righe e la query ha una scadenza di 15 secondi. Sono ammesse solo le tabelle aziendali leggibili dalla persona e dall'agente richiedente. I report non modificano record delle app né concedono accesso a tabelle private o della piattaforma. Le proiezioni di testo includono `strpos`, `position`, `regexp_matches`, `regexp_replace`, `lower`, `substring` e `split_part`. L'ispezione JSON include `jsonb_object_keys`, `json_object_keys`, estrazione JSON e lunghezza degli array JSON. Usa le funzioni di espansione delle chiavi in SELECT; le funzioni in FROM e le chiamate qualificate con uno schema restano non supportate. Gli errori sulle funzioni non supportate elencano quelle consentite. Funzioni arbitrarie e conversioni non sicure restano vietate. Per cercare menzioni esatte di una persona, preferisci regex parametrizzate con confini di parola alle ricerche generiche per sottostringa: per esempio `regexp_matches(note, ?, 'i')` con `params: ["\\mPier\\M"]`. Esamina prima lo schema, seleziona solo le colonne necessarie e usa un limite basso. Una sottostringa come `mark` può comparire anche in `marketing`; il supporto SQL non stabilisce automaticamente se una menzione identifica la persona desiderata. --- # Documenti e PDF Leggere i documenti di origine, estrarre informazioni utili e preparare i documenti su cui le persone possono agire. Source: https://docs.opser.com/it/capabilities/documents/ ## Analizzare un PDF Allegare un PDF e spiegare le domande a cui rispondere. Chiedi i riferimenti alla pagina in cui la fonte li supporta, specialmente quando rivedi termini, quantità o specifiche. > Confronta queste due offerte di fornitori. Estrai i prezzi unitari, gli ordini minimi, i termini di consegna e le date di validità. Citare la pagina per ogni valore e contrassegnare tutto ciò che non si può leggere in modo affidabile. I PDF di testo, le pagine scansionate e i layout complessi possono produrre una qualità di estrazione diversa. Rivedere i valori critici rispetto al documento originale. ## Creare un documento Descrivere il pubblico, lo scopo, la struttura e il formato. Il documento e le funzionalità PDF possono aiutare a preparare materiale, report e output strutturati rivolti al cliente dalle informazioni dell'area di lavoro. Un breve utile include il destinatario, i fatti da includere, il tono, i requisiti di branding e le sezioni da omettere. Se si dispone di un modello, allegarlo e identificare quali parti dovrebbero rimanere coerenti. ## Usa una competenza per il flusso di lavoro Il catalogo delle competenze include l'analisi PDF, l'estrazione dell'offerta dei fornitori, i documenti relativi ai clienti, il runbook, il rapporto sullo stato, la valutazione del rischio, la documentazione dei processi, la revisione dei fornitori e il monitoraggio della conformità. Chiedi all'agente di usare l'abilità pertinente per un processo più coerente; se non è ancora installata, l'agente la trova nel catalogo e chiede prima di installarla. Per la conoscenza condivisa o documenti collaborativi, utilizzare l'app installata appropriata. Confermare dove il risultato è memorizzato e chi può accedervi; vedere [Come funzionano le app](https://docs.opser.com/it/apps/overview/). ## Revisione prima della condivisione Apri l'output e controlla nomi, date, numeri, layout, collegamenti e informazioni mancanti. I documenti generati dovrebbero riflettere accuratamente i record di origine. Una bozza di tracker di conformità o valutazione del rischio è un aiuto di lavoro; il tuo team rimane responsabile della revisione delle sue conclusioni. --- # Fogli di calcolo Pulire i dati di origine, calcolare i risultati e produrre fogli di calcolo che è possibile ispezionare e riutilizzare. Source: https://docs.opser.com/it/capabilities/spreadsheets/ ## Dare all'agente la fonte e le regole Allega il foglio di calcolo o identifica i dati dell'app da utilizzare. Nominare i fogli pertinenti, il significato di ogni colonna e l'output desiderato. > Pulire questa esportazione del cliente. Normalizza lo spazio bianco, identifica gli indirizzi e-mail duplicati e crea un foglio separato che elenca le fusioni proposte. Conservare le righe originali. Per i calcoli, indicare le unità, le valute, l'interpretazione della data e le regole di arrotondamento. Chiedi all'agente di spiegare formule e ipotesi importanti. ## Analizzare e creare La capacità del foglio di calcolo supporta il lavoro con i file tabulari e la produzione di artefatti del foglio di calcolo. Usalo per confronti, riconciliazioni, tabelle di pianificazione ed esportazioni. L'agente può utilizzare il codice di supporto per elaborare set di dati più grandi o più coinvolti nel suo spazio di lavoro. Un file di foglio di calcolo generato è un artefatto che puoi scaricare o archiviare. Se l'area di lavoro dispone di un'app per documenti collaborativi, indicare all'agente se si desidera un record modificabile in quell'app o un file scaricabile. ## Controlla la cartella di lavoro Apri il file finito e ispeziona i nomi dei fogli, le intestazioni, i totali, le formule e i formati. Metti alla prova alcune righe conosciute. Rivedere la data e le convenzioni decimali quando i dati provengono da locali diversi. Le cartelle di lavoro di origine complesse possono contenere funzionalità che non sopravvivono ad ogni trasformazione. Conserva una copia originale e chiama esplicitamente le formule, la formattazione o le funzionalità della cartella di lavoro che devono essere conservate. ## Passare dall'analisi all'azione Una volta che il risultato è stato approvato, chiedi all'agente di aggiornare i record delle app pertinenti o salvare l'output nella posizione giusta. Un'analisi del foglio di calcolo non aggiorna di per sé il sistema di registrazione. --- # Presentazioni Trasforma uno schema e le prove in una presentazione con un pubblico chiaro e scopo. Source: https://docs.opser.com/it/capabilities/presentations/ ## Inizia con la storia Dite all'agente a chi serve la presentazione, quale decisione dovrebbe sostenere e per quanto tempo dovete presentare. Fornire materiale di origine e requisiti di marca o modello. > Crea una revisione mensile delle operazioni a sei slide per il nostro team di leadership. Utilizzare il rapporto allegato. Coprire i risultati, gli obiettivi mancati, le cause e le priorità del mese prossimo. Mantenere tutti i numeri tracciabili alla fonte. Chiedere un contorno prima quando l'argomento è complesso. È più facile cambiare la storia prima di produrre tutte le slide. ## Crea e perfeziona la presentazione La capacità di presentazione e l'abilità di creazione della presentazione aiutano a strutturare e generare un mazzo. Rivedere l'artefatto di output, quindi richiedere revisioni specifiche: semplificare una diapositiva affollata, chiarire un grafico o spostare i dettagli nel materiale di supporto. ## Controlla il risultato finale Aprire la presentazione nell'applicazione che si intende utilizzare. Controlla l'overflow del testo, il ritaglio delle immagini, le etichette dei grafici, i font e l'accuratezza delle figure. Verificare che ogni diapositiva comunichi un punto utile e che la sequenza supporti la conclusione prevista. Per le nuove immagini, vedi [Generazione di media](https://docs.opser.com/it/capabilities/media/). Per l'analisi della fonte, vedere [Dati e reporting](https://docs.opser.com/it/capabilities/data/). --- # Immagini, video e audio Creare risorse multimediali supportate da un brief e perfezionarle per l'uso previsto. Source: https://docs.opser.com/it/capabilities/media/ ## Descrivi il contenuto da creare Dare all'agente lo scopo, il soggetto, lo stile, le dimensioni o il rapporto di aspetto e la destinazione prevista. Allegare un riferimento quando si desidera mantenere un aspetto particolare o modificare una risorsa esistente. > Crea una semplice illustrazione del paesaggio per una guida interna all'onboarding. Utilizzare colori verdi e neutri, lasciare spazio per un'intestazione a sinistra e non includere testo nell'immagine. La funzionalità multimediale supporta le operazioni di immagine, video e audio in base ai modelli e ai fornitori configurati nel tuo ambiente. I formati, le durate e le opzioni di modifica disponibili dipendono dall'operazione selezionata. ## Rivedere l'operazione proposta La generazione dei media può consumare crediti. Sii chiaro sul numero di varianti e il livello di iterazione che desideri. Per una richiesta costosa, chiedere all'agente di spiegare l'operazione pianificata prima di procedere. ## Affinamento ed esportazione Aprire l'artefatto generato e verificare se si adatta alla sua destinazione. Per le immagini, ispezionare piccoli dettagli e qualsiasi testo reso. Per il video, controlla l'intera sequenza. Per l'audio, ascoltare l'intera uscita e controllare la pronuncia e il timing. Chiedere una revisione specifica piuttosto che ricominciare con un brief non correlato. Utilizzare materiale che si è autorizzati a fornire e pubblicare. ## Memorizza il risultato Salvare le risorse approvate nella posizione dell'area di lavoro appropriata, utilizzando [spazio di lavoro di archiviazione](https://docs.opser.com/it/workspace/data/) o un'app installata, oppure utilizzarla in un documento, presentazione o app. I media generati rimangono soggetti al tuo spazio di lavoro [indennità di stoccaggio e di utilizzo](https://docs.opser.com/it/billing/plans/). --- # Ricerca sul web Indagare le informazioni pubbliche e mantenere i risultati collegati alle loro fonti. Source: https://docs.opser.com/it/capabilities/research/ ## Fai una domanda mirata Dare all'agente una domanda, portata e requisito di freschezza. Identifica le fonti che ritieni autorevoli e chiedi link a supporto delle conclusioni. > Confronta le politiche di restituzione pubblicate da questi tre fornitori. Utilizzare i loro siti Web ufficiali, link a ciascuna politica e contrassegnare eventuali termini che non è possibile verificare. Opser può recuperare pagine pubbliche, ricerca e raschiare contenuti supportati. Un browser gestito può ispezionare le pagine pubbliche rese quando metodi più semplici non possono leggerle. ## La ricerca del browser ha uno scopo specifico La capacità di ricerca del browser è di sola lettura. Indaga sulle pagine pubbliche e può esporre un'anteprima dal vivo quando disponibile. Non accede agli account, invia moduli, invia messaggi, effettua ordini o effettua acquisti. Utilizzare un [integration](https://docs.opser.com/it/agents/integrations/) supportato per le operazioni dell'account autorizzato. L'interazione del browser utilizzata durante il test di un'app creata da un agente è una capacità di creazione di app separata. ## Valutare la risposta Verificare che le fonti citate supportino le affermazioni e che le date siano appropriate. Chiedi all'agente di distinguere i fatti dall'inferenza e di segnalare prove contrastanti. Una pagina può essere bloccata, rimossa, specifica per regione o incompleta. ## Costi e limiti La ricerca, lo scraping e la ricerca gestita del browser possono avere diversi costi di utilizzo. L'agente dovrebbe utilizzare un metodo appropriato per l'attività; l'apertura di una pagina complessa in un browser gestito può consumare più di un semplice recupero. Ispezionare [Uso](https://docs.opser.com/it/billing/usage/) per il lavoro svolto. --- # Il tuo browser Lascia che un agente lavori sui siti a cui accedi, nel tuo Chrome o nel browser cloud di Opser. Source: https://docs.opser.com/it/capabilities/your-browser/ ## Lascia lavorare un agente nel tuo browser Molti siti che usi non hanno un'app o un'integrazione Opser: il portale di un fornitore, il sito di prenotazione di un corriere, un vecchio sistema a cui il team accede. Con l'estensione di Opser per Chrome collegata al tuo workspace, un agente può lavorare su quei siti nel tuo Chrome, con il tuo accesso. > Apri il portale fornitori Northwind, trova l'ordine PO-20817 e dimmi la data di consegna. L'agente apre una sua scheda, legge la pagina, fa clic, scrive e sceglie le opzioni come faresti tu. Per farlo lavorare in una scheda che hai già aperta, digli quale. Va avanti finché il lavoro è finito e ti chiede qualcosa solo quando devi intervenire tu: un accesso, un codice di verifica, un CAPTCHA o una scelta che spetta a te. ## Chatta accanto alla pagina Fai clic sull'icona di Opser nella barra degli strumenti di Chrome per aprire i tuoi agenti nel pannello laterale di Chrome. Scegli un agente dal menu e chiedigli della pagina in cui sei: trova le tue schede aperte e lavora in quella che intendi. I record a cui un agente rimanda si aprono in una scheda normale. L'estensione serve solo ai tuoi agenti: non registra le riunioni e non legge le pagine di sua iniziativa. ## Cosa vedi mentre lavora La scheda in cui lavora un agente si illumina di blu e dice quale agente la sta usando. Le schede che apre stanno insieme in un gruppo di schede Opser blu. Chrome mostra anche la sua barra che indica che l'estensione sta eseguendo il debug del browser. Nella chat ogni passaggio appare mentre avviene, per esempio l'apertura di una pagina o un clic. Un agente non comanda mai il tuo workspace Opser nel tuo browser: per quello usa i suoi strumenti Opser. Chiude solo le schede che ha aperto. ## Fermalo quando vuoi Premi Ferma sulla scheda illuminata, o Annulla sulla barra di Chrome, e l'agente lascia subito il tuo browser e interrompe quell'attività. La tua prossima richiesta può usare di nuovo il tuo browser. Nel pannello laterale, Opser in Chrome (in fondo al menu) ha l'interruttore che disattiva gli agenti e li riattiva per questo browser e mostra chi sta lavorando. Quando li hai disattivati, un agente ti chiede prima di continuare. ## Il browser cloud Un agente può usare anche il browser cloud di Opser, che funziona quando il tuo computer è spento. Conserva gli accessi che fai lì per la volta successiva. Quando un sito ha bisogno di te, la chat ti mostra un pulsante per prendere il controllo del browser cloud: accedi o supera la verifica, di' all'agente che hai finito e lui riprende. Solo tu puoi aprirlo. ## Automazioni Un'automazione programmata può usare il browser della persona che l'ha creata, finché fa ancora parte dell'agente, oppure il browser cloud. Se il suo browser non è collegato, l'esecuzione lo segnala invece di riprovare all'infinito. I passaggi che cambiano qualcosa, come un clic, un testo scritto o il ritorno a un modulo inviato, contano come fatti, così un'esecuzione ripetuta non li rifà. ## Costi e limiti Lavorare nel tuo browser costa solo il consueto uso del modello dell'agente. Il browser cloud addebita anche il tempo in cui resta attivo; controlla l'[Utilizzo](https://docs.opser.com/it/billing/usage/). Leggi il modulo prima di lasciare che un agente invii qualcosa che spedisce, acquista, prenota, paga o elimina: per ora un agente non chiede l'approvazione prima di agire in un browser. --- # Analisi del traffico web Monitora le app Opser e altri siti, comprendi le metriche del traffico e verifica privacy e accesso. Source: https://docs.opser.com/it/capabilities/analytics/ ## Misurare il traffico del sito Analytics mostra visitatori, visualizzazioni di pagina, sorgenti di traffico, campagne, paesi, dispositivi ed eventi personalizzati dei tuoi siti. Apri **Analytics** dalle app dello spazio di lavoro per scegliere un sito ed esplorare la sua dashboard. Se l'app non è presente, installala dall'App Store o chiedi a un amministratore. Il monitoraggio deve essere disponibile nella regione dello spazio di lavoro. Analytics inizia a raccogliere dati quando attivi il monitoraggio; aggiungere un sito non recupera il traffico precedente. ## Attivare il monitoraggio di un'app Opser Apri un'[app esterna](https://docs.opser.com/it/capabilities/external-apps/) pubblicata, seleziona la sezione **Analytics** e attiva il monitoraggio. Opser aggiunge automaticamente il codice di monitoraggio: non occorre modificare il codice o ripubblicare. Puoi trovare le app Opser dello spazio di lavoro e i relativi interruttori anche in **Aggiungi sito** in Analytics. Apri la dashboard del sito in Analytics per vedere il traffico. Disattiva il monitoraggio dalla pagina dell'app esterna quando vuoi interrompere la raccolta. I domini monitorati seguono quelli dell'app. ## Collegare un sito ospitato altrove In Analytics, scegli **Aggiungi sito**, inserisci un nome e i domini da monitorare e crea il sito. Apri la configurazione o le impostazioni del sito per copiare lo snippet di monitoraggio. Incolla lo snippet esatto nell'head di ogni pagina o nel layout condiviso, poi pubblica le modifiche. Lo snippet contiene l'identificatore del sito e l'indirizzo corretto del servizio di raccolta. In alternativa, scegli **Copia prompt** sotto **Lascia che il tuo agente IA lo configuri** e consegnalo a un agente che può modificare il codice del sito. Il prompt include lo snippet e le istruzioni di installazione. Chiedi all'agente di mostrare le modifiche e verificare il sito pubblicato. Visita il sito pubblico con un normale browser. La dashboard attende la prima visita registrata; le visite da localhost e dai browser automatizzati vengono ignorate. Non installare un secondo snippet su un'app Opser con il monitoraggio già attivo. ## Comprendere le metriche Scegli un periodo e confrontalo con il precedente della stessa durata. Le date seguono il fuso orario dello spazio di lavoro, impostato in **Impostazioni → Organizzazione**. Fai clic su una pagina, sorgente, campagna, paese o dispositivo per filtrare la dashboard. | Metrica | Significato | | --- | --- | | Visitatori | Conteggi anonimi giornalieri per dispositivo e browser. Una persona che torna domani viene contata nuovamente; non è un conteggio di persone uniche. | | Visite | Gruppi di attività che terminano dopo 30 minuti senza eventi. | | Visualizzazioni di pagina | Caricamenti registrati e cambi di navigazione supportati nelle applicazioni a pagina singola. | | Pagine per visita | Media delle visualizzazioni di pagina per visita. | | Frequenza di rimbalzo | Percentuale di visite con una sola visualizzazione di pagina e nessun altro evento. | | Durata della visita | Tempo medio tra il primo e l'ultimo evento registrato di una visita. Una visita con un solo evento ha durata zero. | | Visitatori in tempo reale | Visitatori registrati negli ultimi cinque minuti. | I dati dettagliati coprono gli ultimi 13 mesi. Gli agenti possono leggere anche i riepiloghi mensili precedenti. Le query estese possono utilizzare dati campionati; considera come stime le metriche indicate come approssimative. ## Privacy e accesso Il codice di monitoraggio non usa cookie o memoria del browser per identificare i visitatori. Gli indirizzi IP servono a determinare il paese e generare un codice anonimo giornaliero, poi vengono scartati. Il codice cambia ogni giorno ed è specifico per ciascun sito. Le statistiche restano nella regione dello spazio di lavoro. I bot noti sono esclusi. Non inserire dati personali nei nomi e nelle proprietà degli eventi personalizzati. Consulta **Analytics → Impostazioni** per la spiegazione sulla privacy e la soglia di visualizzazioni di pagina inclusa. Il permesso `analytics.view` consente di leggere siti e statistiche; `analytics.manage` consente di gestire i siti monitorati. I controlli delle app esterne richiedono `external-apps.manage`. Anche l'agente deve avere accesso all'app Analytics. Un amministratore gestisce i permessi in [Impostazioni → Permessi](https://docs.opser.com/it/workspace/permissions/). ## Chiedere all'agente informazioni sul traffico > Confronta il traffico del nostro sito negli ultimi 30 giorni con il periodo precedente. Mostra le pagine e le sorgenti principali e indica se qualche metrica è approssimativa. Specifica il sito se ne monitori diversi. Gli strumenti Analytics leggono le statistiche; non modificano le impostazioni di monitoraggio. Gli eventi personalizzati compaiono dopo che il codice del sito li invia: descrivi l'azione da misurare quando chiedi a un agente di implementarne uno. ## Se non compare traffico Verifica che il monitoraggio sia attivo, il sito pubblicato e il dominio visitato presente nell'elenco. Per un altro servizio di hosting, verifica che lo snippet compaia una sola volta nelle pagine pubblicate e che il browser possa caricarlo. Un codice bloccato, un test locale o una visita automatizzata non dimostrano che il monitoraggio funzioni. Se Analytics segnala che il servizio non è disponibile, chiedi all'amministratore di verificare la disponibilità regionale. Se la raccolta è sospesa per la soglia di visualizzazioni, consulta **Analytics → Impostazioni** e [Piani e crediti](https://docs.opser.com/it/billing/usage/): l'uso non pagato può sospendere la raccolta dopo un periodo di tolleranza. Le visite mancanti durante una sospensione non vengono recuperate. --- # Dashboard e viste aggiornate Trasforma i dati a cui puoi accedere in una dashboard utile senza creare un'altra app. Source: https://docs.opser.com/it/capabilities/dashboards/ ## Adatta una dashboard alle tue esigenze Chiedi al tuo agente di organizzare la dashboard dell'app **Dashboard** attorno alle informazioni che controlli regolarmente. Può ispezionare il layout corrente, aggiungere o aggiornare i widget supportati e regolare la loro configurazione. Non è necessario creare un'app solo per mostrare una metrica, un elenco o una tabella. Per ritrovarla all'apertura di Opser, sceglila come [pagina iniziale](https://docs.opser.com/it/workspace/preferences/). **La tua dashboard Home · Dati fittizi** I widget di esempio mostrano 12 richieste aperte e 3 da rivedere. REQ-104 di Acme Studio è in corso; REQ-105 di Juniper Labs è in attesa. > Aggiungere una visualizzazione compatta delle richieste aperte a cui posso accedere, raggruppate per stato. Metti il totale sopra una tabella delle richieste più antiche. Mantenere i miei widget esistenti. Indicare la fonte e la domanda a cui il punto di vista dovrebbe rispondere. L'agente dovrebbe controllare quali dati sono disponibili prima di scegliere un widget. Gli strumenti dell'agente per la dashboard arrivano con l'app Dashboard, quindi sono disponibili solo quando l'app è installata e puoi aprirla. Le versioni precedenti dell'app non li includono: quando l'app Dashboard mostra **Aggiornamento disponibile**, chi gestisce le app può installare la nuova versione con **Aggiorna app**. Vedi [Gestire le app](https://docs.opser.com/it/apps/managing/). ## Da dove arrivano i dati Un widget può mostrare qualsiasi dato aziendale che puoi leggere: i tuoi set di dati e le tabelle delle app che puoi aprire. L'app Dashboard li legge come fa lo strumento dati dell'agente, in sola lettura, quindi una dashboard non mostra mai un'app che non puoi aprire e non modifica mai un record. Quando un'app offre un'operazione di lettura per la composizione, l'agente la preferisce: l'operazione mantiene la logica dell'app e continua a funzionare quando l'app cambia le sue tabelle. Altrimenti il widget interroga direttamente le tabelle, e l'agente esegue la query prima di salvare il widget. Vedere [Come funzionano le app](https://docs.opser.com/it/apps/connected/). ## Metriche, tabelle e visualizzazioni personalizzate L'agente può creare metriche di sola lettura, grafici, tabelle, elenchi e visualizzazioni personalizzate supportate. Dategli il raggruppamento, l'intervallo di date, le unità e il comportamento a stato vuoto che vi aspettate. Una visualizzazione utile mostra chiaramente il suo significato: distinguere un conteggio da un valore di valuta, mantenere visibile l'intervallo di date e verificare il risultato rispetto alla sorgente. Le visualizzazioni personalizzate utilizzano componenti di visualizzazione supportati piuttosto che un'applicazione Web senza restrizioni. ## Affinare e ripristinare il layout Chiedere una modifica mirata al layout corrente. La dashboard mantiene la cronologia delle revisioni in modo che un layout precedente possa essere ripristinato come una nuova revisione. Il ripristino di un layout non ripristina i dati aziendali sottostanti. Controllare la dashboard popolata dopo una modifica, inclusi schermi stretti e risultati vuoti. Il comportamento di aggiornamento dipende dalla configurazione del widget; una vista non è necessariamente aggiornata nell'istante esatto in cui cambia un record di origine. --- # Crea app per il tuo spazio di lavoro Trasforma un flusso di lavoro aziendale in un'app all'interno dell'area di lavoro Opser. Source: https://docs.opser.com/it/capabilities/internal-apps/ ## Descrivere il flusso di lavoro Un'app interna offre a persone e agenti un luogo condiviso per fare una sorta di lavoro all'interno Opser. Descrivere gli utenti, i record, i passaggi, le visualizzazioni e le regole di accesso. Includi le azioni che vuoi che l'agente esegua attraverso gli strumenti. > Costruisci un flusso di lavoro per il checkout delle apparecchiature. Traccia le attività, i mutuatari, le date di scadenza e i rendimenti. Il personale può richiedere un checkout; i coordinatori lo approvano. Includi una vista in ritardo, ricerca per tag di asset e strumenti di agente per trovare e restituire le attrezzature. L'agente dovrebbe ispezionare le app installate prima di decidere di crearne una nuova o modificare un'app esistente. A [cruscotto](https://docs.opser.com/it/capabilities/dashboards/) Può essere sufficiente per una panoramica. La creazione di app deve essere abilitata nel tuo ambiente; se il costruttore segnala che non è disponibile, chiedi all'amministratore di tale funzionalità. ## Rivedere una bozza con dati separati L'agente crea o apre una bozza e lavora sui suoi file di origine. La bozza ha un'anteprima dal vivo e una cronologia delle versioni. Il suo sandbox di database contiene lo schema aziendale senza record di produzione; utilizzare esempi sintetici per esercitare il flusso di lavoro. Le modifiche ricostruiscono l'anteprima della bozza. Rivedere le schermate reali, la navigazione, i moduli, i campi obbligatori, gli stati vuoti, la gestione degli errori e il layout mobile. Un'anteprima è separata dalla versione installata utilizzata dal team. ## Costruire le interfacce agente e app insieme Chiedi strumenti e competenze utili accanto agli schermi. L'azione umana e l'azione degli agenti dovrebbero applicare le stesse regole di convalida e di business. Se l'app si connette a un'altra app, specificarne [contratti, eventi e notifiche](https://docs.opser.com/it/apps/connected/). Prova con i permessi previsti. Controllare un flusso di lavoro normale, una richiesta non valida e un tentativo di accedere a un record che l'utente non dovrebbe vedere. Uno schermo lucido da solo non verifica il comportamento dell'app. ## Testare e installare la versione revisionata Il costruttore esegue test e controlli di prontezza sulla sorgente e sulle funzionalità dichiarate della piattaforma. Questi includono autorizzazioni, rilegature delle risorse, strumenti, proprietà dei dati e connessioni dichiarate dell'app. Risolvere il blocco dei feedback e rivedere l'anteprima prima dell'installazione. Un utente autorizzato può installare la bozza rivista nell'area di lavoro. Un utente senza autorizzazione di installazione può inviare una richiesta di installazione per un amministratore da rivedere. L'installazione di una modifica aggiorna l'app esistente; non crea una seconda copia. ## Chi può modificare un'app Chiunque abbia accesso a un'app installata può usarla. Solo le persone nella sua lista possono modificarla. Chi pubblica per primo un'app ne diventa il proprietario, e **Impostazioni → App** mostra il proprietario nella riga dell'app. Seleziona **Persone** per vedere la lista. Il proprietario può aggiungere editor, che possono modificare e pubblicare l'app, rimuoverli o rendere qualcun altro proprietario. Quando il proprietario non è disponibile, un admin può aprire **Persone** e selezionare **Diventa proprietario**. Il proprietario precedente resta sull'app come editor, e il cambiamento compare nell'[attività](https://docs.opser.com/it/workspace/activity/). Gli agenti seguono la stessa lista. Se chiedi al tuo agente di modificare un'app di cui non fai parte, ti dice chi ne è il proprietario, così puoi chiedere di essere aggiunto. ## Storia e cambiamenti in corso Chiedi modifiche mirate e ispeziona il diff o la cronologia quando rivedi un aggiornamento. Il ripristino di un'origine bozza precedente crea una nuova revisione sorgente e ricostruisce i dati di anteprima usa e getta. Non annulla i record aziendali di produzione. Quando un altro aggiornamento ha cambiato l'app installata, potrebbe essere necessario riconciliare la bozza con quella versione più recente prima dell'installazione. Mantieni il comportamento più recente e la personalizzazione prevista. Usa **Impostazioni → App** per le app installate, il lavoro in corso e la cronologia delle operazioni. Vedi [gestione delle app](https://docs.opser.com/it/apps/managing/) per i dettagli sul ciclo di vita. --- # Crea siti web e app esterne Creare un sito Web o un portale separato mantenendo la build connessa al flusso di lavoro Opser. Source: https://docs.opser.com/it/capabilities/external-apps/ ## Un'esperienza web separata Un'app esterna è un sito Web o un'applicazione web al di fuori dell'interfaccia dello spazio di lavoro Opser. Utilizzalo per un sito pubblico, un portale clienti o un altro pubblico che ha bisogno di un'esperienza separata. Una [app interna](https://docs.opser.com/it/capabilities/internal-apps/) viene invece eseguita all'interno dell'area di lavoro. > Crea un portale di onboarding con una pagina di benvenuto, una lista di controllo e un modulo di dettagli dell'azienda. Mostra quali pagine sono pubbliche, cosa richiede l'accesso e dove verranno memorizzate le presentazioni. Il builder supporta un frontend statico collegato ai servizi della piattaforma Opser. Descrivere i confini dell'esperienza e dei dati piuttosto che assumere una connessione server o area di lavoro separata. ## Dichiarare dati e accesso L'app dichiara le tabelle di dati e le funzionalità di cui ha bisogno. La piattaforma utilizza tali dichiarazioni quando si preparano i dati dell'app e li si pubblica. L'accesso a un'app installata o a una funzionalità associata all'utente richiede la sovvenzione corrispondente. Rivedere ciò che un visitatore può leggere o modificare e la cui autorità utilizza una capacità. Una pagina pubblica non deve esporre i dati dell'area di lavoro semplicemente perché il proprietario dell'app può accedervi. Se la pubblicazione segnala una concessione di capacità mancante, l'agente può richiedere tale concessione per la revisione nella conversazione. ## Chi può vedere un'app Ogni app esterna ha la propria lista di accesso. Chi la crea ne diventa il proprietario e nessun altro la vede finché non viene aggiunto. Apri l'app e seleziona **Condivisione** per vedere chi ha accesso. Il proprietario può aggiungere persone come editor, che può modificare e pubblicare l'app, o revisore, che può consultarla. Il proprietario può anche cambiare un ruolo, rimuovere qualcuno o rendere qualcun altro proprietario. Gli admin vedono ogni app esterna in **Impostazioni → App**, insieme al suo proprietario. Un'app di cui non fanno parte si apre in sola lettura, con **Unisciti come editor** e **Diventa proprietario**. Diventando proprietario, il proprietario precedente resta sull'app come editor. Gli admin possono anche modificare la lista di accesso di qualsiasi app. Questo deriva dal permesso `external-apps.manageAll`, che gli admin hanno; assegnalo in **Impostazioni → Accesso** per dare a qualcun altro la stessa supervisione. Il permesso di creare app esterne, da solo, non mostra le app degli altri. Gli agenti seguono solo la lista di accesso. Un agente lavora su un'app solo quando la sua persona è nella lista di quell'app. ## Anteprima e verifica Quando apri un’app esterna, viene mostrata la dashboard mentre l’anteprima protetta si carica in background. Seleziona **Anteprima** per visualizzare l’app. Passando dall’anteprima alla dashboard, l’anteprima rimane aperta: puoi controllare le impostazioni senza riavviarla. Il primo avvio può richiedere più tempo per preparare le dipendenze e l’ambiente di anteprima. L'agente può creare l'app, eseguire i controlli, ispezionare i registri e aprire un'anteprima protetta. Rivedere la navigazione, i moduli, gli stati di caricamento, i layout mobili e l'accesso da parte di un visitatore non autorizzato. I dati di anteprima sono separati dalla produzione. Le chiamate di capacità possono essere stordite nell'anteprima, quindi un'anteprima di successo non è la prova che un'integrazione dal vivo ha completato un'azione. Verificare il flusso di funzionalità concesso anche sull'app pubblicata. ## Pubblicare e connettere un dominio La pubblicazione crea una revisione della distribuzione e restituisce il suo URL pubblico. Ispezionare il risultato prima di condividerlo. La creazione e la pubblicazione dipendono dai servizi configurati nel tuo ambiente. Per un dominio personalizzato, la configurazione restituisce il traffico richiesto e i record di verifica della proprietà DNS. Crea i record esatti mostrati e controlla lo stato del dominio. Un dominio verificato può ancora attendere il suo certificato; confermare che HTTPS è attivo prima di trattare il dominio come pronto. ## Aggiornare, annullare la pubblicazione e ripristinare La cronologia delle origini consente di rivedere le modifiche e ripristinare una versione precedente come nuova revisione. Il ripristino di origine e il ripristino dei dati sono operazioni diverse; non presumere che il ritorno a un'interfaccia precedente restituisca anche il database a uno stato precedente. Unpublishing rimuove la distribuzione pubblica preservando l'app, l'origine, le impostazioni, la cronologia e i dati per la pubblicazione successiva. Rivedere l'operazione specifica prima di un teardown o il ripristino dei dati. Confermare dove vengono archiviati gli invii degli utenti e come verranno gestiti dopo che l'app sarà offline. --- # Come funzionano le app Software che il tuo team e gli agenti utilizzano insieme, costruito attorno alla tua attività. Source: https://docs.opser.com/it/apps/overview/ ## Software che si adatta al tuo business Un'app è una parte funzionante del tuo spazio di lavoro Opser: memorizza i record aziendali, offre alle persone un'interfaccia per lavorare con loro e può fornire agli agenti strumenti per svolgere lo stesso lavoro. Il tuo team può utilizzare lo schermo, chiedere a un agente o combinare entrambi in un flusso di lavoro. È possibile installare un'app disponibile o descrivere un flusso di lavoro e avere un agente che crea un'app per esso. Le app offerte al tuo spazio di lavoro possono cambiare. Queste guide spiegano il sistema che condividono; l'App Store e l'area di lavoro mostrano ciò che è disponibile per te. ## Persone e agenti lavorano sugli stessi record Un'app potrebbe tenere traccia delle attrezzature, rivedere le richieste o coordinare un processo specifico per la tua attività. La sua interfaccia presenta tali record come moduli, elenchi, schede o altre visualizzazioni. I suoi strumenti di agente espongono le azioni supportate, come trovare un record o aggiornarne lo stato. Ad esempio, è possibile aprire un record di apparecchiature e modificarne la data di ritorno o chiedere a un agente di apportare tale modifica. Un'app ben costruita mette entrambe le azioni attraverso le stesse regole di business. L'agente non ha bisogno di imitare i clic del mouse quando l'app fornisce uno strumento per l'attività. di un'app [competenze](https://docs.opser.com/it/agents/skills/) spiegare il suo flusso di lavoro e come utilizzare i suoi strumenti. Le autorizzazioni decidono quali persone e agenti possono usarli. Vedi [All'interno di un'app](https://docs.opser.com/it/apps/anatomy/) per come questi pezzi si incastrano. ## Descrivi di cosa hai bisogno Inizia con il flusso di lavoro, non un elenco di funzionalità: > Prestiamo attrezzature al personale. Crea un posto per richiedere un checkout, approvarlo e tenere traccia dei ritorni. I richiedenti dovrebbero vedere le proprie richieste; i coordinatori dovrebbero gestire tutti i checkout. Lasciate che l'agente trovare gli elementi in ritardo e preparare i promemoria. L'agente può ispezionare le app esistenti prima di creare in modo da poter estendere quella giusta o riutilizzare un'operazione già fornita da un'altra app. È possibile rivedere una bozza con i dati di test prima di installare il risultato nell'area di lavoro. [Costruisci un'app interna](https://docs.opser.com/it/capabilities/internal-apps/) passa attraverso quel processo. La costruzione deve essere abilitata nel vostro ambiente. ## Le app si connettono attraverso interfacce esplicite Un'app può offrire un'operazione con un'altra app, emettere un evento quando qualcosa cambia o inviare una notifica a una persona. Si tratta di capacità diverse con scopi diversi. Una connessione deve essere implementata e dichiarata; l'installazione di due app non si unisce automaticamente ai loro flussi di lavoro. Leggi [Come funzionano le app](https://docs.opser.com/it/apps/connected/) per comprendere contratti, eventi, notifiche e visualizzazioni in tempo reale. ## Il tuo spazio di lavoro decide cosa è disponibile La barra laterale riflette le app installate e il tuo accesso. L'installazione, la pubblicazione e gli aggiornamenti richiedono le autorizzazioni pertinenti. Un'app installata può essere disponibile per un gruppo e nascosta a un altro. Consulta [Installare e gestire le app](https://docs.opser.com/it/apps/managing/) per il ciclo di vita e [Permessi](https://docs.opser.com/it/workspace/permissions/) per l'accesso. Un sito web o un portale per i clienti separato ha un confine di distribuzione diverso; vedi [app esterne](https://docs.opser.com/it/capabilities/external-apps/). --- # Dentro un’app Comprendere i record, l'interfaccia, gli strumenti degli agenti e le regole di accesso che rendono utile un'app. Source: https://docs.opser.com/it/apps/anatomy/ ## Un’app, diverse interfacce Un'app Opser è più di una pagina nella barra laterale. Riunisce i record, un'interfaccia umana e le capacità che espone agli agenti e ad altre app. Il suo manifesto descrive quelle superfici in modo che la piattaforma possa scoprirle e governarle. Non tutte le app hanno bisogno di ogni superficie. Una piccola app di riferimento può fornire solo schermate e letture. Un'app operativa può anche fornire modifiche, eventi, notifiche, integrazioni e guida agli agenti. | Parte | Cosa fa | | --- | --- | | Registri e regole | Definire le informazioni che l'app possiede, la sua convalida e le modifiche consentite | | Viste e azioni | Consentire alle persone di trovare i record ed eseguire il flusso di lavoro | | Strumenti dell'agente | Lascia che un agente esegua azioni con nome con input strutturati | | Competenze | Spiegare quando e come utilizzare le funzionalità dell'app | | Permessi e risorse | Controllare l'accesso alle azioni e, ove implementato, ai singoli record | | Contratti | Offrire operazioni con nome ad altre parti dell'area di lavoro | | Eventi | Annunciare le modifiche ai flussi di lavoro di sottoscrizione | | Notifiche | Portare un cambiamento o una decisione all'attenzione di una persona | ## I record appartengono a un dominio aziendale Un'app possiede il proprio modello di dati e le regole che la circondano. Quando un agente costruisce un'app, definisce i record e le relazioni necessarie per quel flusso di lavoro. L'aggiornamento di un'app live deve preservare i record esistenti e introdurre il nuovo comportamento. Le app non ottengono accesso illimitato alle rispettive tabelle di database. Per riutilizzare le informazioni di un'altra app, chiamano un'operazione che l'app espone. Questo mantiene le regole dell'app proprietaria nel percorso. I set di dati gestiti dall'utente hanno un separato [dati e reportistica](https://docs.opser.com/it/capabilities/data/) superficie. ## Gli strumenti rendono l'app utilizzabile dagli agenti Uno strumento agente è un'azione con un nome, una descrizione e input strutturati. Un'app di apparecchiature potrebbe esporre le azioni per trovare una risorsa, creare una richiesta di checkout o registrare un ritorno. Questi sono esempi di un design, non un catalogo di app promesso. La piattaforma rileva gli strumenti dall'app caricata e controlla l'accesso quando sono elencati e invocati. Un'azione può anche richiedere l'approvazione. Quando qualcuno parla con un agente, l'accesso di quella persona conta insieme a quello dell'agente: un agente non fa mai più di quanto la persona che gli parla può fare, e l'accesso a un agente non è un'autorizzazione per ogni record. Chiedi al costruttore di fare in modo che l'interfaccia umana e gli strumenti agente utilizzino le stesse regole di servizio. Rivedere entrambi i percorsi: un modulo di lavoro non dimostra che l'agente può completare il flusso di lavoro. Un'app può anche esporre i record primari ricercabili a [ricerca spazio di lavoro](https://docs.opser.com/it/workspace/search/). Includi quel comportamento quando vuoi che le persone trovino i suoi record dal controllo di ricerca dell'area di lavoro. ## Le competenze spiegano il flusso di lavoro Un'app può fornire istruzioni sui suoi concetti, input richiesti e sequenza preferita di azioni. Questo aiuta l'agente a scegliere lo strumento giusto e interpretare il risultato. L'installazione di un'abilità non concede i permessi necessari ai suoi strumenti. Ad esempio, un'abilità di checkout potrebbe spiegare che un'attività deve essere disponibile prima che una richiesta possa essere approvata e che la registrazione di un ritorno dovrebbe chiudere il checkout attivo. Leggi [Abilità integrate](https://docs.opser.com/it/agents/skills/) per la differenza tra le istruzioni e l'esecuzione. ## L’accesso dipende dall’azione e dai dati Le app dichiarano le autorizzazioni e possono vincolare le azioni alle regole delle risorse per la proprietà, la condivisione o altre relazioni. L'accesso può quindi essere più stretto della possibilità di aprire un'app. Una persona che può visualizzare le richieste potrebbe ancora non essere in grado di approvarne una. Durante la revisione di un'app personalizzata, prova con i ruoli previsti e con qualcuno che non dovrebbe vedere il record. Includi le chiamate degli agenti in questa recensione. [Permessi e gruppi di accesso](https://docs.opser.com/it/workspace/permissions/) spiega i controlli dell'area di lavoro. ## Costruire per l'intero flusso di lavoro Specificare i record, le schermate, le azioni degli agenti, le regole di accesso, le notifiche e le connessioni quando si informa l'agente. I controlli di prontezza del costruttore ispezionano le capacità dichiarate e la build. Quindi prova tu stesso il flusso di lavoro, inclusi i dati mancanti e le azioni rifiutate, prima dell'installazione. Continua con [app collegate](https://docs.opser.com/it/apps/connected/) o la [guida alla creazione di app](https://docs.opser.com/it/capabilities/internal-apps/). --- # Come collaborano le app Connetti i flussi di lavoro attraverso operazioni dichiarate, eventi e servizi di piattaforma condivisa. Source: https://docs.opser.com/it/apps/connected/ ## Contesto condiviso, connessioni esplicite Opser porta le app in un'unica area di lavoro con un sistema di identità e autorizzazioni condiviso. Ogni app possiede ancora i propri record e comportamenti. Le app lavorano insieme esponendo le capacità e dichiarando quelle che usano. Questa distinzione è importante quando si chiede a un agente di collegare i flussi di lavoro. Denomina la fonte, il grilletto o la richiesta, la destinazione e il risultato. L'agente può ispezionare le interfacce disponibili e identificare tutto ciò che deve essere costruito. ## I contratti richiedono un'operazione Un contratto è un'operazione denominata che un'app offre a un'altra. Un provider potrebbe offrire "ottenere la disponibilità delle apparecchiature". Un'app richiedente dichiara di consumare tale operazione, invia gli input richiesti e ottiene un risultato. La piattaforma controlla il fornitore dichiarato e il rapporto con i consumatori. Si applicano anche le regole sulle risorse e l'autorità in base alla quale viene eseguita la richiesta. Un'app non può semplicemente chiamare un'operazione arbitraria in un'altra app perché entrambe sono installate. Utilizzare un contratto quando un flusso di lavoro ha bisogno di una risposta o di un'azione. Se il provider manca, non è disponibile o nega l'accesso, il flusso di lavoro richiedente deve gestire tale risultato. Un'utile app personalizzata spiega il problema invece di presentare un risultato vuoto come successo. ## Gli eventi annunciano un cambiamento Un evento descrive qualcosa che è accaduto, come un ritorno dell'apparecchiatura in fase di registrazione. L'app emettitrice dichiara l'evento e un'app ricevente dichiara la sua sottoscrizione e implementa la risposta. Gli eventi consentono ai flussi di lavoro di reagire senza far eseguire all'app originale ogni passaggio a valle. Un sistema di richiesta potrebbe reagire a un ritorno controllando una lista d'attesa. Tale connessione deve essere implementata; un nome di evento da solo non crea il comportamento. La consegna può essere riprovata, quindi un flusso di lavoro ricevente deve gestire lo stesso evento più di una volta senza duplicare il suo lavoro. Gli eventi vengono consegnati agli abbonamenti attivi quando vengono emessi. Un nuovo abbonamento non riproduce automaticamente il passato e una consegna fallita non è garanzia di un eventuale completamento. Controllare i record risultanti quando manca un'azione a valle. ## Le notifiche informano le persone Una notifica è un messaggio per una persona. Un evento è un segnale per un flusso di lavoro. Lo stesso cambiamento di business può produrre entrambi, ma non sono intercambiabili. Le app possono dichiarare i tipi di notifica che appaiono in **Impostazioni → Notifiche**, con le preferenze di campana ed e-mail dove supportate. La disattivazione di una notifica e-mail non disabilita l'evento aziendale o l'automazione sottostanti. Leggi [Inbox & Notifiche](https://docs.opser.com/it/workspace/notifications/) per le preferenze di consegna. ## Le viste aggiornate riutilizzano le operazioni di lettura Un'app può esporre esplicitamente un'operazione di lettura per una dashboard o un'altra visualizzazione composta. Il suo input e output descrivono i dati che la vista può utilizzare, e l'operazione mantiene la logica dell'app, quindi la vista continua a funzionare quando l'app cambia le sue tabelle. L'agente preferisce un'operazione del genere quando esiste. Altrimenti una dashboard può comunque leggere le tabelle delle app che puoi aprire, in sola lettura, come fa lo strumento dati dell'agente; non mostra mai un'app che non puoi aprire. Vedi [Dashboards & live views](https://docs.opser.com/it/capabilities/dashboards/). ## Le connessioni esterne sono un confine separato Le connessioni degli agenti autorizzano un agente a utilizzare un servizio esterno. Un'app può invece dichiarare la propria integrazione per i dati in entrata o in uscita, con requisiti di configurazione e accesso separati. Nessuna connessione garantisce l'accesso generale a tutti i record dell'area di lavoro. Per un flusso di lavoro connesso, verificare l'account, le operazioni consentite, chi avvia il lavoro e dove viene memorizzato il risultato. Leggi [Collega i tuoi strumenti](https://docs.opser.com/it/agents/integrations/) per le connessioni degli agenti. ## Spiega il compito con un esempio completo > Quando l'attrezzatura viene restituita, controllare le richieste di attesa, identificare la persona idonea successiva e informare il coordinatore. Non approvare automaticamente il prossimo checkout. Mostrami come vengono gestiti un evento ripetuto e un'app di destinazione mancante. Rivedere il percorso normale, una dipendenza non disponibile, l'accesso negato e un evento ripetuto. La connessione è completa quando il comportamento a valle funziona con le autorizzazioni previste, non solo quando l'azione originale ha successo. --- # Installa e gestisci le app Tenere traccia di ciò che è installato, ciò che viene costruito e chi può usarlo. Source: https://docs.opser.com/it/apps/managing/ ## Scopri e installa Apri l'**App Store** per vedere le app offerte al tuo spazio di lavoro. Controlla la descrizione e i requisiti di un'app, poi usa i comandi di installazione se hai l'autorizzazione. La possibilità di installare dipende dal catalogo e dai requisiti dell'app. Ogni piano include app installate senza limiti. Dopo l'installazione, controllare **Impostazioni → Apps** e la barra laterale. Un'app può essere installata senza essere visibile a tutti gli utenti; i permessi di accesso determinano chi può aprirlo. ## App installate e lavori in corso Impostazioni → Le app separano la gestione delle app dell'area di lavoro dalla scoperta nello store. Controlla le app installate, il lavoro in costruzione e la cronologia delle operazioni. Una bozza o un'anteprima non è la stessa versione utilizzata dal team in produzione. **Le tue app · Dati fittizi** Northstar ha un portale clienti e una bacheca feedback creati per i propri processi. Questi esempi fittizi non descrivono un catalogo fisso. Per le app create dall'agente, segui la guida [app interna](https://docs.opser.com/it/capabilities/internal-apps/) o [app esterna](https://docs.opser.com/it/capabilities/external-apps/) e rivedi il risultato della pubblicazione. ## Aggiornamenti e autorizzazioni Le app si aggiornano automaticamente: quando viene pubblicata una nuova versione, si installa da sola e le persone che gestiscono le app ricevono una notifica. Per aggiornare le app manualmente, disattivare **Aggiorna le app automaticamente** in **Impostazioni → Generali**, sotto **Spazio di lavoro**; ogni nuova versione arriverà quindi come notifica di aggiornamento da installare. Un'app personalizzata non si aggiorna mai automaticamente, perché il suo aggiornamento deve essere esaminato e unito alle modifiche. Se un aggiornamento automatico non riesce, si riceve una notifica di aggiornamento per installarlo manualmente. Prima di cambiare un'app, comprendere il flusso di lavoro e i dati interessati. Verificare le schermate chiave e gli strumenti agente dopo un aggiornamento. Rivedere le sovvenzioni per le funzionalità appena introdotte piuttosto che presumere che ogni utente dovrebbe riceverle. ## Rimozione di un'app Leggi la conferma di rimozione e comprendi l'effetto sui suoi record, flussi di lavoro collegati, dashboard e automazioni. Esportare o conservare le informazioni di cui il team ha bisogno prima di una rimozione distruttiva. Non trattare la disinstallazione come un modo reversibile per nascondere un'app da un utente; regola invece l'accesso di quell'utente. ## Se un'installazione non riesce Controlla l'errore riportato per l'operazione. Le cause più comuni sono un accesso mancante, una dipendenza richiesta o una build non valida. Consulta la [risoluzione dei problemi](https://docs.opser.com/it/help/troubleshooting/) e indica il nome dell'app e l'errore quando chiedi aiuto. --- # Pagine Wiki e checklist Crea, organizza e condividi pagine Wiki collaborative, scrivi checklist e lavora in sicurezza con il tuo agente. Source: https://docs.opser.com/it/apps/wiki/ ## Aprire Wiki Wiki raccoglie le conoscenze del team in un albero di pagine collaborative. Usalo per istruzioni, documentazione dei processi, note delle riunioni e checklist. Apri **Wiki** dalle app della tua area di lavoro. Se manca, chiedi a un amministratore di verificare l'installazione e il tuo accesso; le app disponibili dipendono dall'area di lavoro. ## Creare e organizzare le pagine Scegli **Nuova pagina**, inserisci un titolo e scrivi nell'editor. Le pagine possono contenere altre pagine: usa il comando di aggiunta di una pagina nell'albero, oppure il comando pagina dell'editor, per creare una sottopagina. Apri una pagina dall'albero per leggerla o modificarla. Usa i controlli della pagina per spostarla, duplicarla o aggiungerla ai preferiti. Lo spostamento e la duplicazione includono le sottopagine. Sposta le pagine che non servono nel **Cestino**; puoi ripristinarle da lì. L'eliminazione definitiva rimuove per sempre la pagina e le sue sottopagine. ## Scrivere una checklist Nell'editor, digita `/` per aprire il menu dei blocchi e scegli una voce della checklist. Scrivi un passaggio per voce e fai clic sulla casella per segnarlo come completato. Combina checklist, titoli e paragrafi esplicativi per documentare un processo. Un agente può creare una pagina con un corpo iniziale in Markdown, compresa la sintassi degli elenchi di attività: ```markdown - [ ] Review the instructions - [ ] Confirm the owner - [x] Prepare the draft ``` Le voci non selezionate sono da completare; quella selezionata è completata. Controlla la pagina in Wiki dopo la creazione. Una casella registra il completamento su quella pagina; assegnare attività, scadenze o notifiche richiede un flusso di lavoro supportato separato. ## Trovare e condividere le pagine Usa la ricerca di Wiki per trovare pagine per titolo o testo. Aggiungi ai preferiti quelle che consulti spesso. Copia il collegamento della pagina per condividerla con un collega che dispone dell'accesso. Il collegamento apre la pagina, ma non concede il permesso di visualizzarla. Più persone possono modificare la stessa pagina in collaborazione. Usa i commenti della pagina per discutere e quelli inline per un passaggio specifico. Risolvi una discussione inline quando è conclusa. ## Chiedere al tuo agente di lavorare in Wiki > Crea una pagina Wiki chiamata Checklist di lancio sotto la nostra pagina Operations. Inserisci i passaggi di preparazione come voci non selezionate e dammi il collegamento al risultato. L'agente può trovare, leggere, creare e organizzare pagine con gli strumenti Wiki. `wiki_create_page` accetta un titolo facoltativo, una pagina padre e un corpo iniziale in Markdown. Chiedi all'agente di trovare prima la pagina padre e usare l'URL restituito per il risultato. Prima di cambiare una pagina esistente, l'agente deve leggerla. Sostituire il corpo richiede la revisione più recente e l'approvazione; se nel frattempo qualcuno lo modifica, l'agente deve leggerlo di nuovo. La sostituzione può lasciare i commenti inline esistenti senza il testo a cui erano ancorati: controlla attentamente il contenuto sostitutivo e i commenti interessati. Anche i commenti visibili ai collaboratori e l'eliminazione definitiva richiedono approvazione. ## Accesso e risoluzione dei problemi `wiki.view` consente lettura e ricerca. `wiki.edit` consente di modificare contenuti, preferiti e commenti. `wiki.manage` consente di creare, spostare, duplicare, cestinare, ripristinare ed eliminare definitivamente le pagine. Anche l'agente deve avere accesso all'app Wiki. Un amministratore gestisce le autorizzazioni in [Impostazioni → Autorizzazioni](https://docs.opser.com/it/workspace/permissions/). Se una pagina o un'azione non è disponibile, controlla il tuo accesso e se la pagina è nel Cestino. Gli strumenti Wiki richiedono un utente che avvia l'azione per controllare i permessi e attribuire le modifiche; un'automazione senza tale utente non può usarli. Consulta [Approvazioni e controllo](https://docs.opser.com/it/agents/approvals/) per la revisione delle azioni dell'agente. --- # Il tuo spazio di lavoro Scegli l'orientamento, personalizza la tua esperienza e dai al tuo team il giusto accesso. Source: https://docs.opser.com/it/workspace/overview/ ## Orientati nello spazio di lavoro La barra laterale riunisce i tuoi agenti, le app installate e le destinazioni dell'area di lavoro. Utilizzare **Inbox** per le notifiche della piattaforma e **Automazioni** per il lavoro automatizzato. Un'app **Email** installata ha una propria casella di posta; è separata dalla piattaforma Inbox. Il menu del tuo account apre le impostazioni e le azioni dell'account. Le impostazioni di navigazione raggruppano le preferenze personali, l'amministrazione dell'area di lavoro e gli strumenti per sviluppatori. ## Impostazioni personali Queste impostazioni riguardano la tua esperienza: - [Preferenze](https://docs.opser.com/it/workspace/preferences/): aspetto, lingua e home page. - [Profilo](https://docs.opser.com/it/workspace/profile/): dettagli dell'account e password. - [Notifiche](https://docs.opser.com/it/workspace/notifications/): come si sente l'attività dell'area di lavoro. - [Attività](https://docs.opser.com/it/workspace/activity/): cosa hai fatto tu e cosa hanno fatto gli agenti per te. - [Context](https://docs.opser.com/it/agents/context/): informazioni che aiutano i tuoi agenti a lavorare con te. ## Amministrazione dello spazio di lavoro Gli amministratori configurano le informazioni dell'organizzazione, aggiungono utenti e gestiscono la fatturazione. Permessi specifici possono consentire l'accesso alla gestione delle app, al reporting sull'utilizzo, all'archiviazione e all'amministrazione degli accessi. | Destinazione | Guida | | --- | --- | | Organizzazione | [Impostazioni organizzazione](https://docs.opser.com/it/workspace/organization/) | | Utenti | [Aggiungere e gestire i compagni di squadra](https://docs.opser.com/it/workspace/users/) | | Agenti | [Gli agenti e chi può usarli](https://docs.opser.com/it/agents/overview/) | | Accesso | [Permessi e gruppi di accesso](https://docs.opser.com/it/workspace/permissions/) | | App | [Gestione delle app installate](https://docs.opser.com/it/apps/managing/) | | Uso | [Comprensione dell'uso](https://docs.opser.com/it/billing/usage/) | | Fatturazione | [Piani e abbonamenti](https://docs.opser.com/it/billing/plans/) | | Dati | [Dati ed esportazioni](https://docs.opser.com/it/workspace/data/) | ## Quando manca un'impostazione La navigazione riflette le tue autorizzazioni. Se non vedi un'impostazione dell'area di lavoro o non riesci ad aprire un'app, chiedi a un amministratore di rivedere l'accesso. Aggiornare dopo la modifica delle autorizzazioni. Se il problema persiste, utilizzare il [guida alla risoluzione dei problemi](https://docs.opser.com/it/help/troubleshooting/). ## Trova una pagina o un record Usa [search](https://docs.opser.com/it/workspace/search/) o **K / Ctrl K** per aprire le destinazioni e trovare i record delle app supportati. La ricerca rispetta il tuo accesso e le funzionalità che ogni app installata espone. --- # Trova pagine e dati Utilizza la ricerca nell'area di lavoro per navigare e trovare i record dalle app a cui puoi accedere. Source: https://docs.opser.com/it/workspace/search/ ## Aprire la ricerca dell'area di lavoro Utilizzare il controllo di ricerca nell'area di lavoro Opser o premere **K K** su macOS e **Ctrl K** su Windows e Linux. La ricerca ti aiuta ad aprire una pagina o a trovare un record senza attraversare la barra laterale. Questo è separato dalla ricerca su questo sito di documentazione. La ricerca nell'area di lavoro utilizza l'accesso connesso. La ricerca dei documenti legge solo guide pubbliche. ## Passare a un'app o un'impostazione Digitare il nome di una pagina, un'app o un'impostazione. I risultati di navigazione riflettono le destinazioni disponibili. Selezionare un risultato per aprirlo o chiudere la ricerca con Escape per tornare al lavoro corrente. Se manca una destinazione, controlla se l'app è installata e se il tuo account ha l'autorizzazione per aprirla. Un termine di ricerca diverso non rivelerà una pagina a cui non è possibile accedere. ## Trova record aziendali La ricerca può anche chiedere app installate per i record corrispondenti. Un'app deve esporre la sua capacità di ricerca e i risultati vengono filtrati per accesso. Potresti vedere i record di diverse app in una ricerca, ma questo non significa che ogni campo o file nell'area di lavoro sia indicizzato. Utilizzare un nome o un identificatore distintivo. Apri il risultato per ispezionare il record autorevole nella sua app. Se un record atteso è assente, controlla la ricerca dell'app e l'accesso a livello di record. ## Continua con il tuo agente Puoi anche chiedere al tuo agente di trovare una pagina o un record, elencare le pagine di un'app o aprire una pagina per te. Prima di aprirla, l'agente verifica che la pagina esista e che tu possa accedervi. La conversazione resta accanto alla pagina, così puoi seguire il suo lavoro. Le esecuzioni pianificate non aprono pagine sul tuo schermo. L'interfaccia di ricerca può offrire di consegnare una domanda all'agente quando si desidera indagine piuttosto che la navigazione. Date all'agente la fonte e il risultato di cui avete bisogno. Una ricerca record trova candidati; l'agente può utilizzare gli strumenti supportati per confrontarli o completare un'attività. Quando si crea un'app, includere record primari ricercabili nei suoi requisiti. Leggi [All'interno di un'app](https://docs.opser.com/it/apps/anatomy/) per l'interfaccia e le funzionalità dello strumento che rendono un'app utilizzabile in tutto lo spazio di lavoro. --- # Temi e preferenze Rendere Opser comodo da usare, dalla tavolozza dei colori alla pagina che si apre per prima. Source: https://docs.opser.com/it/workspace/preferences/ ## Impostazioni personali Apri **Impostazioni**. La sezione Personale elenca **Generali**, **Aspetto**, **Notifiche** e **Profilo**. **Generali** è un breve elenco in gruppi. **Di base** contiene la lingua e dove si apre Opser. **Il tuo agente** contiene come apre le pagine, se la chat mostra i suoi passaggi e le tue parole per la dettatura. **Telefono** elenca i telefoni collegati, che puoi disconnettere, e **Collega un telefono** mostra un codice QR monouso che collega l'app mobile Opser al tuo account. Per chi gestisce le app, **Spazio di lavoro** indica se le app si aggiornano automaticamente per tutti. La voce di un agente si configura con quell'agente, nelle sue impostazioni **Generali**. Il sito di documenti ha il proprio controllo del tema nell'intestazione. La modifica del tema Documenti non cambia le preferenze dell'account Opser. ## Personalizza l'aspetto Apri **Impostazioni → Aspetto**. **Stile** contiene la modalità colore, la palette, la forma, il carattere e lo spessore delle icone. **Disposizione**, su computer o iPad, contiene la densità, le dimensioni di testo e icone della barra laterale e **Comprimi la barra laterale nelle app**, che lascia più spazio a un’app quando la apri; puoi riaprire la barra laterale quando vuoi. Ogni modifica si applica subito, quindi controlla sia le viste dense delle app sia le schermate di conversazione. **Ripristina** torna ai valori predefiniti. Queste scelte influenzano la tua esperienza personale. Non cambiano il tema preferito di un altro compagno di squadra. ## Imposta la tua lingua Apri **Impostazioni → Generali** e scegli **Lingua** in **Di base**: inglese, italiano, spagnolo, tedesco o francese. La selezione della lingua si applica immediatamente nell'interfaccia della piattaforma supportata. Le app fornite separatamente possono avere una copertura di traduzione diversa. Questi documenti sono disponibili nelle stesse cinque lingue. Utilizzare il menu della lingua nell'intestazione dei documenti per cambiare le lingue mentre si rimane sulla stessa guida. La lingua dei documenti è separata dalla preferenza dell'account Opser. ## Scegli la tua home page Apri **Impostazioni → Generali** e usa **Apri Opser su** in **Di base** per scegliere tra le destinazioni disponibili per il tuo account. Questo controlla dove arrivi quando apri Opser. Una destinazione deve essere disponibile per te; cambiare la pagina iniziale non consente l'accesso a un'app. ## Mostra i passaggi dell'agente Apri **Impostazioni → Generali** e trova **Mostra i suoi passaggi** in **Il tuo agente**. È disattivata per impostazione predefinita, quindi la chat di un agente mostra ciò che l'agente scrive, come fumetti, con una breve frase che dice cosa sta facendo mentre lavora. Attivala per vedere anche gli strumenti, il ragionamento, il piano e i sub-agenti dietro ogni risposta, per controllare come lavora l'agente. La scelta è solo tua e vale per la pagina della chat, la chat laterale e l'app mobile. Puoi anche chiedere a un agente di cambiarla per te. Vedi [cosa vedi mentre l'agente lavora](https://docs.opser.com/it/agents/conversations/#what-you-see-while-the-agent-works). ## Insegna le tue parole alla dettatura La dettatura riconosce già i nomi dei tuoi colleghi, dei tuoi agenti, delle tue app e della tua azienda. Apri **Impostazioni → Generali**, trova **Parole per la dettatura** in **Il tuo agente** e scegli **Modifica** per aggiungere tutto ciò che deve scrivere correttamente. In **Parole**, aggiungi nomi e termini che pronunci, come un cliente o un prodotto, scritti esattamente come devono apparire. In **Correzioni**, aggiungi una parola che la dettatura sbaglia sempre e cosa scrivere al suo posto, per esempio **opzer** → **Opser**: ogni trascrizione viene corretta, solo a parole intere e con qualsiasi uso di maiuscole. Puoi tenere fino a 100 parole e 100 correzioni e rimuoverle con la loro **X**. Una correzione cambia quella parola ovunque detti, quindi evitala per una parola comune che usi anche nel suo senso normale. Il dizionario è solo tuo. Puoi anche dirlo al tuo agente, per esempio "la dettatura continua a scrivere opzer, è Opser", e salverà la correzione per te. Meetings usa le stesse parole e correzioni per il tuo microfono; le registrazioni che distinguono le voci ricevono le tue correzioni. Vedi [conversazioni vocali](https://docs.opser.com/it/agents/voice/). ## Se una preferenza non viene salvata Attendere che il salvataggio finisca e verificare la presenza di un messaggio di errore. Aggiornare la pagina una volta. Per una destinazione domestica non disponibile, chiedi a un amministratore di ispezionare le tue autorizzazioni o se l'app è ancora installata. --- # Profilo e sicurezza Mantieni i dettagli del tuo account riconoscibili e gestisci la tua password di accesso. Source: https://docs.opser.com/it/workspace/profile/ ## Aggiorna il tuo profilo Apri **Impostazioni → Profilo**. Aggiorna il nome visualizzato e usa il controllo avatar per caricare un'immagine del profilo. Salvare le modifiche e controllare il risultato nell'interfaccia dell'account. Puoi anche chiederlo al tuo agente in chat. Allega una foto e scrivi "usa questa come immagine del profilo", oppure chiedigli di cambiare il nome visualizzato. L'agente salva la modifica come fa questa pagina e la nuova immagine compare subito nella barra laterale. Il tuo indirizzo email viene mostrato come informazioni sull'account. Non è modificabile attraverso lo stesso campo nome. Chiedi aiuto all'amministratore dell'area di lavoro se l'indirizzo associato al tuo account ha bisogno di attenzione. **Account collegati**, nella stessa pagina, gestisce il collegamento dell'accesso Google e la connessione di un abbonamento ChatGPT che i tuoi agenti possono usare per i modelli Codex (vedi [modelli](https://docs.opser.com/it/agents/models/)). ## Cambia la tua password Utilizzare la sezione password nella pagina Profilo. Inserisci la tua password attuale, una nuova password e la conferma, quindi invia la modifica. Se la conferma non corrisponde o la password corrente non è corretta, correggere gli input e riprovare. Utilizzare una password univoca per questo account. Non inviarlo a una conversazione con un agente o includerlo in una richiesta di supporto. ## Accesso per la prima volta Un amministratore [ti invita](https://docs.opser.com/it/workspace/users/) via email. Apri il link, inserisci il tuo nome e scegli la tua password; nessun altro la imposta per te. ## Recuperare una password dimenticata **Password dimenticata** nella pagina di accesso dell'area di lavoro per richiedere un'e-mail di reset. Apri il collegamento monouso e scegli una nuova password. Se il link è scaduto o è già stato utilizzato, richiedine un altro. Una richiesta di successo non conferma se un indirizzo email ha un account. L'accesso può anche richiedere un codice di verifica inviato via e-mail. Inserisci quel codice nel flusso di accesso; non condividerlo mai in una conversazione. Vedere [accesso all'area di lavoro](https://docs.opser.com/it/start/access/). ## Se non riesci ad accedere Conferma che stai utilizzando l'indirizzo corretto dell'area di lavoro e l'email dell'account. Chiedi al tuo amministratore di verificare se il tuo account esiste ed è attivo. Non creare un account duplicato per aggirare un problema di accesso. Vedere [troubleshooting](https://docs.opser.com/it/help/troubleshooting/) per informazioni da includere quando si richiede aiuto. --- # Azienda e contesto Imposta l'identità condivisa e le impostazioni predefinite che aiutano l'area di lavoro a rimanere coerente. Source: https://docs.opser.com/it/workspace/organization/ ## Apri le impostazioni dell’azienda Gli amministratori possono aprire **Impostazioni → Organizzazione**. Le sue schede dividono la pagina: **Generale** visualizza l'identità dell'organizzazione e fornisce controlli per il logo, il fuso orario e la valuta; **Azienda** contiene i dettagli aziendali, **Modelli** i modelli aziendali riutilizzabili e il contesto aggiuntivo, e **Pagamenti** l'account Stripe dell'attività. Il nome dell'organizzazione è fornito dalla configurazione dell'area di lavoro e non viene modificato attraverso lo stesso modulo degli altri campi. Contattare l'operatore dell'area di lavoro se è necessario modificare tale identità. ## Imposta un logo riconoscibile Carica il logo dell'organizzazione corretto e ispeziona l'anteprima. Scegliere un'immagine che rimane chiara alle piccole dimensioni utilizzate nell'interfaccia. ## Verifica fuso orario e valuta Scegli il fuso orario che riflette le operazioni dell'organizzazione e la sua valuta predefinita. Salvare le modifiche e rivedere qualsiasi flusso di lavoro in cui tali impostazioni predefinite sono importanti. Una valuta di default non converte i record finanziari storici o rende comparabili i totali delle valute miste. Un predefinito fuso orario non è anche un sostituto per controllare il fuso orario su una pianificazione importante. ## Definire modelli Usa Modelli per definire documenti, contenuti multimediali, flussi di lavoro, post social e altri materiali riutilizzabili. Aggiungi contenuti o esempi, istruzioni e file di riferimento facoltativi. Gli agenti ricevono questi modelli per le attività pertinenti. Vedi [Modelli](https://docs.opser.com/it/workspace/document-standards/). ## Aggiungi contesto aziendale Uso **Impostazioni → Organizzazione → Modelli → Contesto aggiuntivo** per informazioni sul business che gli agenti dovrebbero capire. Il contesto organizzativo e il contesto personale hanno scopi diversi; vedi [Contesto e memoria](https://docs.opser.com/it/agents/context/). ## Rivedi le impostazioni con il team Informare le persone pertinenti quando si modifica un default condiviso. Controllare [schedules](https://docs.opser.com/it/agents/automations/) e flussi di lavoro finanziari se si basano sull'impostazione interessata. --- # Modelli Modelli riutilizzabili per documenti, contenuti multimediali, flussi di lavoro, post e altri materiali aziendali. Source: https://docs.opser.com/it/workspace/document-standards/ ## Crea modelli aziendali riutilizzabili Apri **Impostazioni → Organizzazione → Modelli** per definire contenuti, esempi, istruzioni e file di riferimento. Scegli **Documento**, **Multimedia**, **Flusso di lavoro**, **Post social** o **Altro**. I modelli di documenti esistenti rimangono disponibili. ## Aggiungi un modello Gli amministratori possono aggiungere un nome, una descrizione di quando usarlo, un contenuto o un esempio e le istruzioni. Il file di riferimento è facoltativo. Puoi allegare documenti, immagini, video, audio, JSON o YAML. Per un lancio su LinkedIn, scegli Post social e inserisci un esempio: > Scopri {{product}}, pensato per {{audience}}. Maggiori informazioni: {{url}} Nelle istruzioni indica il tono del marchio, i dettagli richiesti e come sostituire i segnaposto. Un modello di flusso di lavoro descrive i passaggi di un processo ricorrente; salvarlo non esegue né pianifica il processo. ## Usa e aggiorna i modelli Chiedi all’agente di usare il modello per un’attività pertinente. Tutti gli agenti aziendali ricevono il tipo, il contenuto, le istruzioni e i riferimenti ai file allegati. Puoi chiedere al tuo agente predefinito, quello creato con il tuo account, di creare o aggiornare un modello tramite `list_templates`, `set_template` e `delete_template`. Le modifiche richiedono l’autorizzazione dell’organizzazione; gli altri agenti possono leggere i modelli. I campi dei modelli esistenti si salvano automaticamente. Puoi sostituire, scaricare o rimuovere il file. Controlla i risultati e aggiorna i modelli obsoleti. Le modifiche guidano le attività future. Usa le [competenze](https://docs.opser.com/it/agents/skills/) per le procedure degli agenti e il [contesto](https://docs.opser.com/it/agents/context/) per i fatti duraturi. I modelli contengono esempi riutilizzabili e convenzioni aziendali per i risultati. --- # Aggiungi e gestisci i colleghi Invita il tuo team via email e dai a ogni persona il ruolo e le app di cui ha bisogno. Source: https://docs.opser.com/it/workspace/users/ ## Prima di invitare qualcuno Apri **Impostazioni → Membri** con l'autorizzazione a invitare persone. Ogni [piano](https://docs.opser.com/it/billing/plans/) include utenti senza limiti, quindi puoi invitare tutte le persone che ti servono. ## Invitare persone 1. Seleziona **Invita**. 2. Scrivi ogni indirizzo email e premi Invio, oppure incolla un elenco. 3. Scegli il ruolo. Un **Membro** usa le app che gli dai e può creare i propri agenti e creare app (le installa un amministratore). Un **Amministratore** gestisce anche persone, app, impostazioni e fatturazione. Solo gli amministratori possono nominare un amministratore. 4. Scegli le app. **Tutte le app** comprende anche quelle aggiunte in seguito; disattivalo per scegliere app specifiche. 5. Invia gli inviti. Puoi dare solo l'accesso che hai tu. Ogni persona riceve un'email con un link per unirsi. Inserisce il proprio nome e sceglie la propria password, quindi nessuno imposta una password al posto suo. Il link scade dopo sette giorni. ## Gestire gli inviti in attesa Le persone invitate compaiono nell'elenco come invitate finché non si uniscono. Apri la pagina di una persona per inviare di nuovo l'invito o per revocarlo. Revocandolo, la persona che non si è mai unita viene rimossa. ## Modificare l'accesso o rimuovere qualcuno Apri la pagina di una persona e seleziona **Autorizzazioni** per cambiarne il ruolo e le app. Quando un ruolo e le app non bastano, apri **Autorizzazioni avanzate** per usare gruppi di autorizzazioni e singole autorizzazioni. Per impostazione predefinita solo gli amministratori installano le app. Per permettere a qualcuno di installare app senza essere amministratore, attiva **Install, update and remove apps** nelle sue autorizzazioni avanzate. Per rimuovere qualcuno, apri la sua pagina e seleziona **Rimuovi dallo spazio di lavoro**. Non potrà più accedere e potrai invitarlo di nuovo in seguito. Rendi membro un amministratore prima di rimuoverlo. Per chi lascia il team, controlla anche gli agenti di cui è proprietaria o che può usare, gli account esterni e le automazioni che dipendono da quella persona. Gli agenti di cui una persona è proprietaria non fanno mai più di quanto potrebbe fare lei. Vedi [Autorizzazioni e gruppi di accesso](https://docs.opser.com/it/workspace/permissions/) per capire come si combinano ruoli, gruppi e singole autorizzazioni. Un record di dipendente o contatto in un'app è separato da un account di accesso a Opser. --- # Ruoli e permessi Controlla quali persone e agenti possono utilizzare senza dare a tutti l'accesso all'amministratore. Source: https://docs.opser.com/it/workspace/permissions/ ## Come funziona l'accesso di un agente Ogni agente ha un proprietario. Un agente non fa mai più di quanto potrebbe il suo proprietario, né più di quanto la persona che gli parla può fare in Opser. Modificare i permessi di una persona cambia quindi ciò che possono fare gli agenti di cui è proprietaria e ciò che qualsiasi agente può fare per lei. Dare a qualcuno accesso a un agente gli permette di usarlo, ma non di fare tramite l'agente ciò che non potrebbe fare da solo. Chi può usare un agente e cosa l'agente può fare sono due decisioni separate. Vedi [Dare accesso alle persone](https://docs.opser.com/it/agents/overview/#give-people-access). Un'azione può verificare l'agente, il suo proprietario e la persona che fa la richiesta, oltre alle regole del dato di destinazione. L'accesso a un agente non autorizza automaticamente tutte le sue possibili azioni. ## Verifica una persona o un agente Apri **Impostazioni → Accesso** se hai il permesso di gestire gli accessi. Seleziona la persona o l'agente e controlla l'accesso effettivo. Le autorizzazioni possono derivare da permessi individuali e dai gruppi di accesso assegnati. **Permessi di accesso · Dati fittizi** Maya non è amministratrice. Il suo gruppo Successo clienti concede l’accesso al portale, ma non la gestione della fatturazione. Usa i gruppi di permessi per trovare l'area della piattaforma o l'app pertinente. Alcune app separano lettura, collaborazione e gestione. Il permesso di leggere i dati non consente necessariamente di configurare l'app. ## Usa i gruppi di accesso I gruppi di accesso raccolgono i permessi necessari per una responsabilità comune. Crea un gruppo con nome e scopo chiari, aggiungi i permessi previsti e assegna le persone o gli agenti appropriati. Per esempio, un gruppo operativo può accedere a determinati flussi di lavoro per attività e acquisti, lasciando la fatturazione agli amministratori. Rivedi l'appartenenza quando cambiano le responsabilità di una persona. Le modifiche al gruppo interessano le identità assegnate. Dopo aver rimosso un permesso, controlla l'accesso effettivo: un altro gruppo o un'autorizzazione diretta potrebbe continuare a concederlo. ## Accesso amministrativo Il ruolo di amministratore offre ampi poteri sullo spazio di lavoro, incluse la gestione dell'azienda e la fatturazione. Assegnalo a chi deve amministrare lo spazio di lavoro. Per il normale utilizzo delle app, preferisci permessi e gruppi mirati. ## Permessi e approvazioni sono diversi I permessi definiscono le azioni consentite. Le [approvazioni](https://docs.opser.com/it/agents/approvals/) stabiliscono se un'azione autorizzata dell'agente deve attendere la verifica di una persona. Approvare un'azione non permette di aggirare un permesso mancante. Contano anche la condivisione e l'appartenenza all'interno delle app. Una casella email, un canale di chat privato o un documento condiviso possono avere regole di accesso aggiuntive rispetto ai permessi della piattaforma. ## Individua la causa di un accesso mancante Controlla l'utente o l'agente selezionato, i permessi diretti, l'appartenenza ai gruppi, l'installazione dell'app e la condivisione dei singoli dati. Dopo una modifica, aggiorna la pagina e prova una semplice lettura prima di ripetere il compito originale. --- # Attività Scopri cosa hanno fatto persone e agenti nella tua area di lavoro, e chi l'ha fatto. Source: https://docs.opser.com/it/workspace/activity/ ## Scopri cosa è successo nella tua area di lavoro Opser tiene un registro delle attività con una voce per ogni cosa che qualcuno ha fatto: un record creato o modificato in un'app, un'impostazione o un permesso cambiato, un accesso, una conversazione iniziata, un'azione che un agente ha svolto per qualcuno, un'automazione eseguita. Aprire pagine, cercare e leggere record non viene registrato. Vengono registrate solo le azioni che hanno cambiato o inviato qualcosa. Per consultare il registro, chiedi al tuo agente. Ogni voce indica chi ha agito e cosa ha fatto, l'app o la conversazione in cui è successo, per chi ha agito un agente, da dove è arrivata (web, app mobile, chat o automazione) e se non è riuscita o è stata rifiutata. ## Chi vede cosa Ognuno vede la propria attività, compreso ciò che gli agenti hanno fatto per lui. Chi ha il permesso **View everyone's activity in the workspace** può chiedere al proprio agente l'attività dell'intera area di lavoro; gli amministratori lo hanno per impostazione predefinita. Concedilo dalla [pagina dei permessi](https://docs.opser.com/it/workspace/permissions/) a chi deve controllare l'area di lavoro senza essere amministratore. Vede cosa hanno fatto gli altri, in quale app e su quale record, ma non le parole del record, come l'oggetto di un'email, il titolo di una nota o di una conversazione: compaiono solo nell'attività della persona stessa. ## Come vengono registrate le voci Opser registra ogni voce da sé, nel momento in cui gestisce l'azione. L'app che ha svolto l'azione non scrive mai la propria voce, quindi un'app non può tralasciare un'azione né attribuirla a qualcun altro. Quando agisce un agente, Opser registra l'agente e verifica la persona per cui dice di aver agito: qualcuno in quella conversazione, la persona che ha impostato l'automazione o il proprietario di un agente predefinito. Le voci non possono essere modificate né eliminate. Un accesso rifiutato al tuo account compare nel tuo registro, così puoi accorgerti di tentativi che non hai fatto tu. ## Chiedi al tuo agente Il tuo agente può leggere la tua attività. Chiedi "cosa ho modificato la settimana scorsa?", "chi ha aggiornato questo ordine?" o "l'automazione del lunedì è stata eseguita?". Legge con il tuo accesso, quindi vede solo ciò che puoi vedere tu. La [revisione settimanale](https://docs.opser.com/it/agents/automations/) predefinita usa lo stesso registro per suggerire miglioramenti basati su come lavori davvero. ## Per quanto tempo vengono conservate le voci Le voci vengono conservate per un anno e poi rimosse. Quando un account viene eliminato, la persona viene rimossa da ogni voce che la nomina: resta cosa è successo e quando, ma non chi. --- # Sicurezza e protezione dei dati Come Opser isola il tuo spazio di lavoro, protegge l’accesso e ti permette di controllare i dati. Source: https://docs.opser.com/it/workspace/security/ ## Il tuo spazio di lavoro è isolato Ogni spazio di lavoro Opser è un tenant separato. Record aziendali, file, utenti e agenti appartengono al tuo spazio di lavoro. La piattaforma li separa da quelli degli altri spazi a livello di database, oltre che nell’interfaccia. L’accesso ai dati è sempre soggetto ai permessi del tuo spazio di lavoro. Lo spazio di lavoro ha una regione di hosting configurata. I servizi collegati e i fornitori di modelli possono elaborare il contenuto dei compiti altrove: la regione di hosting non garantisce che ogni fornitore tratti i dati nella stessa località. Verifica con Opser eventuali requisiti sulla localizzazione dei dati prima di aggiungere informazioni sensibili. ## L’accesso è protetto Gli account accedono con email e password. Opser aggiunge una verifica: dopo la password, inserisci un codice monouso inviato all’indirizzo email dell’account. Le password vengono conservate esclusivamente come hash sicuri non reversibili, mai in chiaro. Non possono essere recuperate: una password dimenticata viene [reimpostata](https://docs.opser.com/it/workspace/profile/). Se una persona lascia il team, rimuovi il suo account in [Aggiungere e gestire i membri del team](https://docs.opser.com/it/workspace/users/). Reimpostare la password termina le sessioni esistenti dell’account. ## Gli agenti rispettano i limiti che imposti Un agente può usare soltanto le app, i record e gli account collegati consentiti dal suo accesso. Due controlli indipendenti definiscono questo limite: - I **permessi** stabiliscono a cosa possono accedere agenti e persone. Assegna l’accesso per persona o agente, oppure tramite [gruppi di accesso](https://docs.opser.com/it/workspace/permissions/) riutilizzabili, evitando di rendere tutti amministratori. - Le **approvazioni** stabiliscono quali azioni possono partire autonomamente e quali richiedono una revisione. Per impostazione predefinita, inviare email, eliminare record e modificare impostazioni richiede conferma. Vedi [Approvazioni e controllo](https://docs.opser.com/it/agents/approvals/). Un permesso è diverso da un’approvazione: approvare una singola azione non concede accesso permanente a un’app, una casella di posta o un record riservato. ## Account collegati e segreti Quando colleghi un account esterno, come una casella di posta, un calendario o un altro servizio, controlla l’agente selezionato e l’accesso mostrato nelle impostazioni del collegamento. La conservazione dell’autorizzazione dipende dall’integrazione; alcuni collegamenti sono gestiti da un fornitore di integrazioni. Collegare un account non vi dà accesso a tutti gli agenti dello spazio di lavoro. Puoi scollegarlo in qualsiasi momento da [Collega i tuoi strumenti](https://docs.opser.com/it/agents/integrations/). Per valori necessari a un’app, come una chiave API, un amministratore può usare il **Vault** dello spazio di lavoro, separato dai record ordinari. Non incollare password, codici di verifica o chiavi API in una conversazione: usa il flusso di configurazione previsto per collegare gli account. ## Cosa inviano gli agenti ai fornitori di modelli Per svolgere il lavoro, gli agenti usano modelli linguistici di grandi dimensioni e, quando li abiliti, servizi come la ricerca web o la generazione multimediale. Il contenuto del compito viene elaborato dal fornitore che esegue quel modello o servizio. Fornisci all’agente il contesto necessario e usa permessi e approvazioni per mantenere sotto controllo le azioni sensibili. La ricerca web conserva i collegamenti alle [fonti](https://docs.opser.com/it/capabilities/research/), così puoi verificare i risultati. ## Gestisci i tuoi dati Gli amministratori possono consultare i record di ogni app e i file dello spazio di lavoro, ed esportarli, in [Dati ed esportazioni](https://docs.opser.com/it/workspace/data/). Esportare o eliminare i dati dello spazio di lavoro richiede un’azione esplicita: annullare un abbonamento non esporta né cancella automaticamente i record. Pianifica un’esportazione prima di una modifica irreversibile alla fatturazione e consulta [Abbonamenti e pagamenti](https://docs.opser.com/it/billing/subscriptions/) per sapere quali effetti ha l’annullamento. ## Segnala un problema di sicurezza Se ritieni che un account sia stato compromesso o hai una domanda sulla sicurezza, [contatta Opser](https://opser.com/contact) indicando l’indirizzo dello spazio di lavoro e ciò che hai osservato. Non includere password, codici di verifica o collegamenti per reimpostare la password. --- # Notifiche Tieni traccia dell'attività dell'area di lavoro e scegli le notifiche che ricevi. Source: https://docs.opser.com/it/workspace/notifications/ ## Utilizza la piattaforma Inbox La piattaforma Inbox riunisce le notifiche di Opser e le app installate. Aprire una notifica per ispezionare i suoi dettagli e seguire il suo collegamento al lavoro pertinente. Usa i controlli dello stato di lettura per tenere traccia di ciò che hai esaminato: il menu di una riga può segnarla come letta o non letta e segnare come letta una notifica raggruppata azzera anche le sue ripetizioni. Le notifiche dell'area di lavoro sono separate dai messaggi archiviati in un account di posta elettronica collegato o in un'app di messaggistica installata. ## Scegli le preferenze di notifica Apri **Impostazioni → Notifiche**. Le preferenze sono raggruppate per tipo di notifica della piattaforma e dell'app. I tipi disponibili dipendono dalle app installate e da ciò che dichiarano. La pagina fornisce controlli Inbox, Push ed E-mail per i tipi supportati. Il push invia avvisi a un telefono con l'app mobile Opser quando lo spazio di lavoro supporta il push mobile e consenti le notifiche sul dispositivo; l'attività di un'app installata, come i messaggi di chat, può raggiungere il telefono anche per i tipi tenuti fuori dall'Inbox. Le notifiche e-mail dipendono dall'attivazione della corrispondente notifica Inbox; l'interfaccia riflette tale relazione. La consegna dipende anche dalla configurazione e-mail dell'area di lavoro. ## Rendere utili le notifiche Mantenere le notifiche per il lavoro che richiede l'azione, ad esempio approvazioni e lavoro assegnato. Ridurre le notifiche di basso valore per tipo piuttosto che ignorare l'intera Posta in arrivo. Un'app installata può anche offrire i propri controlli di notifica. Controlla le impostazioni dell'app quando una preferenza riguarda una particolare conversazione o registrazione. La sezione **Email da Opser** controlla separatamente i consigli iniziali, i riepiloghi settimanali e i promemoria per riprendere il lavoro. Queste preferenze valgono in tutti i tuoi spazi di lavoro, con un massimo di due email facoltative a settimana e almeno 48 ore tra un invio e l’altro. Le email relative all’account, alla sicurezza e alle notifiche delle app seguono controlli separati. Se le preferenze email sono temporaneamente indisponibili, le scelte salvate non cambiano; riprova quando il servizio torna disponibile. ## Se manca una notifica Controlla la preferenza pertinente, l'accesso al record sottostante e se l'azione di origine è effettivamente completata. Per la consegna via e-mail, controllare l'indirizzo dell'account e la cartella spam, quindi chiedere all'amministratore di ispezionare la configurazione della consegna se necessario. --- # Dati ed esportazioni Consulta le tabelle di ogni app e i file dello spazio di lavoro in sola lettura, e scaricali o esportali. Source: https://docs.opser.com/it/workspace/data/ ## Cosa mostra Dati Gli amministratori possono aprire **Impostazioni → Dati** per vedere tutto ciò che lo spazio di lavoro conserva, in sola lettura. **Tabelle** elenca le tabelle di ogni app, con l'app a cui appartiene ciascuna e quante righe contiene. Apri una tabella per cercare e ordinare le sue righe, vedere cosa contengono le sue colonne o aprire un singolo record con tutti i campi. **File** mostra quanta parte dello spazio di archiviazione del piano è in uso e quali cartelle delle app lo occupano, fino al singolo file, che puoi visualizzare in anteprima e scaricare. Niente in questa pagina modifica i dati. Per aggiungere, modificare o rimuovere un record o un file, usa l'app a cui appartiene oppure chiedilo al tuo agente. Le colonne che contengono segreti, come i token dei link di condivisione e le password, risultano nascoste nella pagina e in ogni download. I file di lavoro del tuo agente si trovano nella sua area [Files](https://docs.opser.com/it/agents/files/). ## Scaricare ed esportare **Scarica CSV** su una tabella salva tutte le sue righe. **Esporta tutto** crea in background un unico ZIP: un CSV per ogni tabella, una descrizione delle loro colonne e i file dello spazio di lavoro, se in tutto non superano 2 GB. Oltre questa soglia, lo ZIP elenca i file e li scarichi da **File**. Ricevi una notifica quando l'esportazione è pronta, che resta disponibile nella pagina per 7 giorni. Una nuova esportazione sostituisce la precedente. ## Quote del piano Il tuo piano include una quota di archiviazione. Se i file caricati o generati non vengono salvati per un limite, controlla l'utilizzo e decidi cosa conservare o se cambiare piano. Crediti e archiviazione sono quote separate: acquistare crediti non aggiunge di per sé spazio di archiviazione. ## Prima di rimuovere i dati Controlla quale app o record fa riferimento a un file e se deve essere conservato. Rimuovi i contenuti dall'app che li possiede, usando la sua azione di archiviazione o di cestino quando è quello il flusso previsto. L'eliminazione definitiva può compromettere link e record che fanno ancora riferimento al contenuto. Per le modifiche di accesso, usa [Permissions](https://docs.opser.com/it/workspace/permissions/) invece di eliminare i record per nasconderli a una persona. --- # Piani e prezzi Confronta le quote incluse e trova il piano giusto per il tuo team. Source: https://docs.opser.com/it/billing/plans/ ## Piani a prezzo fisso Questi sono i prezzi di listino e le quote incluse nella piattaforma attuale. Controlla **Impostazioni → Fatturazione** e il riepilogo del pagamento per l'offerta disponibile nel tuo spazio di lavoro, le imposte applicabili e l'importo finale. | Piano | Prezzo | Crediti al mese | Archiviazione | | --- | --- | --- | --- | | Free | $0 | 500 | 2 GB | | Growth | $49 / mese | 25,000 | 100 GB | I prezzi sono espressi in USD. Growth viene fatturato mensilmente. ## Embedded Embedded è un piano concordato su misura che include un ingegnere dedicato al tuo team (forward-deployed engineer). Crediti, spazio di archiviazione, termini di pagamento e intervallo di fatturazione dipendono dall'accordo per il tuo spazio di lavoro. Fai riferimento ai dettagli mostrati in Fatturazione e al tuo accordo, senza applicare a Embedded la tabella dei piani a prezzo fisso. ## Cosa include ogni piano Ogni piano include utenti, agenti e app installate senza limiti. I piani si differenziano solo per i crediti mensili e lo spazio di archiviazione. Lo **spazio di archiviazione** limita la scrittura di file nei percorsi di archiviazione pertinenti dello spazio di lavoro. ## Crediti e rinnovo I crediti del piano vengono ripristinati fino alla quota mensile. I crediti del piano non utilizzati non si accumulano. I crediti non si vendono separatamente da un piano. Con Growth e con i contratti Embedded fatturati tramite Stripe in USD, un amministratore può attivare il [pagamento a consumo](https://docs.opser.com/it/billing/usage/): gli agenti continuano oltre il piano a $0.002 per credito, fino a un limite mensile (Embedded può funzionare senza limite), addebitato con la fattura successiva. I crediti aggiuntivi, come quelli concessi dal supporto o acquistati prima del ritiro dei pacchetti di crediti, sono conteggiati separatamente, non scadono e vengono usati dopo l'esaurimento del saldo del piano. Un credito è un'unità di valore dell'utilizzo, non la garanzia di un messaggio o di un compito. Modelli e operazioni diversi consumano importi diversi. Vedi [Utilizzo e crediti](https://docs.opser.com/it/billing/usage/). Gli spazi di lavoro Free esistenti mantengono il saldo attuale dei crediti fino al prossimo rinnovo mensile. Al rinnovo, il saldo del piano viene reimpostato a 500 crediti; i crediti non utilizzati non vengono riportati al mese successivo. I rinnovi seguono la ricorrenza mensile della data di fatturazione dello spazio di lavoro. ## Cambia piano Un amministratore può aprire **Impostazioni → Fatturazione** per controllare il piano attuale e i comandi disponibili per l'abbonamento. Consulta [Abbonamenti e pagamenti](https://docs.opser.com/it/billing/subscriptions/) prima di modificare o annullare un abbonamento. La [pagina pubblica dei prezzi](https://opser.com/pricing) presenta l'offerta commerciale attuale. --- # Utilizzo e crediti Capire dove vanno i crediti e come indagare un cambiamento nel vostro equilibrio. Source: https://docs.opser.com/it/billing/usage/ ## I crediti misurano l’utilizzo dello spazio di lavoro I crediti rappresentano il valore di utilizzo disponibile per l'area di lavoro. Un credito vale $0.002 di valore di utilizzo, quindi 500 crediti valgono $1. Il numero di crediti che un'attività consuma dipende dai modelli e dalle operazioni che utilizza, piuttosto che semplicemente dal numero di messaggi inviati. Il lavoro di modello, la generazione dei media, la ricerca del browser e altre funzionalità misurate possono avere costi diversi. Uno strumento dell'app contrassegnato come gratuito non rende il modello circostante dell'agente gratuito. ## Due saldi di credito I crediti di piano sono l'indennità inclusa nel tuo abbonamento. Ricaricano la quota del piano al ciclo mensile applicabile e i crediti non utilizzati non portano avanti. I crediti aggiuntivi sono un saldo persistente separato, come quelli concessi dal supporto o acquistati prima del ritiro dei pacchetti di crediti. Vengono consumati dopo l'esaurimento dei crediti del piano e non scadono. I crediti non si vendono separatamente da un piano. Con Growth ed Embedded, il pagamento a consumo copre l'utilizzo oltre il piano (vedi sotto). ## Ispezionare l'utilizzo Apri **Impostazioni → Utilizzo** con l'autorizzazione di reporting dell'utilizzo richiesta. È una sola pagina. Gli amministratori vedono per primi i **Crediti**: i crediti disponibili e quanta parte della disponibilità mensile del piano è stata usata. Chiunque abbia l'autorizzazione vede **Crediti utilizzati**: seleziona il periodo di riferimento e il filtro dell'agente per concentrarti sul lavoro che stai esaminando, e suddividi il totale per modello, strumento o agente. Gli amministratori vedono anche il **Registro crediti** sotto, ogni transazione con il saldo dopo ciascuna, per capire come cambia il saldo. **Utilizzo e crediti · Dati fittizi** Saldo di esempio: 2.400 crediti = 2.000 del piano + 400 acquistati. Utilizzo mensile di esempio: 720 per i modelli e 280 per strumenti a consumo. Sono saldi fittizi, non quote dei piani o prezzi. Per un controllo rapido, il menu dell'account mostra **Utilizzo mensile** con la quota dei crediti mensili del piano già usata. Il suo dettaglio elenca quando si rinnova la disponibilità, i crediti del piano rimasti nel ciclo, gli eventuali crediti extra e una scorciatoia **Gestisci utilizzo** verso il report completo. La voce compare con la stessa autorizzazione di report sull'utilizzo. La percentuale usa gli stessi colori della pagina Utilizzo: ambra dal 75% e rosso dal 90%. I crediti extra non cambiano l'utilizzo del piano. Quando il piano raggiunge il 100%, il menu mostra **Crediti extra in uso** e il saldo extra rimanente finché quei crediti finiscono o il piano si rinnova. Il banner dei crediti in esaurimento resta nascosto finché sono disponibili crediti extra e ricompare quando tutti i crediti finiscono. Quando tornano disponibili dei crediti, una chiusura precedente del banner si azzera; chiudere l'avviso di crediti in esaurimento non nasconde un successivo avviso di crediti esauriti. Un'automazione intensa o un'attività media-pesante può consumare più di una breve conversazione di testo. Ispezionare la conversazione sottostante o eseguire la cronologia quando un totale è inaspettato. ## Avvisi sui crediti Gli amministratori ricevono avvisi via email e nella posta in arrivo man mano che i crediti vengono usati. Nella scheda **Avvisi sui crediti** in **Impostazioni → Fatturazione** (in **Impostazioni → Utilizzo** nell'app mobile, che non ha la pagina Fatturazione), un amministratore può impostare: - **Avvisi di utilizzo**: un avviso ogni volta che l'utilizzo supera una di queste soglie, come quota dei crediti mensili del piano. Le soglie predefinite sono 75% e 90%; uno spazio di lavoro può tenerne fino a cinque, dall'1% al 99%, o nessuna. - **Avviso crediti esauriti**: un avviso quando i crediti finiscono e gli agenti si fermano. È attivo a meno che non venga disattivato. Finché il pagamento a consumo copre l'utilizzo, gli amministratori ricevono invece un avviso quando subentra e quando raggiunge il limite. Ogni avviso viene inviato una volta per soglia e per ciclo mensile. Ogni amministratore può comunque disattivare l'email nelle impostazioni delle notifiche. ## Comprendere i rinnovi Per gli abbonamenti fatturati con carta, i crediti di rinnovo dipendono da un pagamento mensile riuscito. Free e i piani negoziati utilizzano il ciclo appropriato alla loro configurazione. Utilizza le prossime date di ricarica e fatturazione mostrate nell'area di lavoro piuttosto che assumere ogni reset del piano il primo giorno del mese solare. ## Quando i crediti si esauriscono Il nuovo lavoro a consumo può essere bloccato quando non c'è saldo disponibile. Controlla se il piano sta per essere ricaricato, se un pagamento non è andato a buon fine e se conviene cambiare piano. I limiti di archiviazione sono separati dal saldo dei crediti. Con Growth o Embedded, controlla anche se il pagamento a consumo è attivo. Vedere [Abbonamenti e pagamenti](https://docs.opser.com/it/billing/subscriptions/) per i problemi di fatturazione e [Piani](https://docs.opser.com/it/billing/plans/) per le indennità incluse. ## Pagamento a consumo Con Growth e con i contratti Embedded fatturati tramite Stripe in USD, il pagamento a consumo tiene attivi i tuoi agenti quando i crediti del piano finiscono. Dove non si può ancora attivare, la scheda offre il passo che lo permette: i piani su Free, l'impostazione del pagamento con carta di un contratto Embedded o il metodo di pagamento dopo un pagamento non riuscito. Resta disattivato finché un amministratore non lo attiva nella scheda **Pagamento a consumo** in **Impostazioni → Fatturazione**, oppure dalla scheda dei crediti esauriti in una chat. Finché è attivo, l'utilizzo oltre il piano costa gli stessi $0.002 per credito. L'uso extra del mese viene addebitato in crediti interi con la successiva fattura mensile di Growth. Quando quella fattura viene pagata, i crediti che copre tornano nel saldo. Con Growth, il pagamento a consumo ha sempre un limite mensile: per impostazione predefinita 1,000,000 crediti ($2,000), e un amministratore può impostarne uno più basso. Un contratto Embedded può impostare un limite o disattivarlo e funzionare senza limite. Quando l'uso extra del mese raggiunge il limite, il lavoro si ferma come quando i crediti finiscono, finché il limite non viene alzato o il piano non si ricarica. Gli amministratori ricevono un avviso quando i crediti del piano finiscono e subentra il pagamento a consumo, e di nuovo quando si raggiunge il limite. Disattivarlo ferma il nuovo uso extra; quanto già usato viene comunque addebitato. Il pagamento a consumo richiede un abbonamento mensile fatturato tramite Stripe in USD il cui ultimo pagamento sia andato a buon fine. Se un pagamento non riesce, l'uso extra si sospende finché non viene pagato. Se l'abbonamento termina, l'uso extra non ancora addebitato finisce in una fattura finale. --- # Abbonamenti e pagamenti Gestisci il piano dell'area di lavoro, il metodo di pagamento e le fatture. Source: https://docs.opser.com/it/billing/subscriptions/ ## Apri Fatturazione Gli amministratori possono aprire **Impostazioni → Fatturazione**. La scheda **Piano** mostra il piano corrente, l'intervallo di fatturazione, la data di rinnovo o cancellazione, la prossima fattura, il [pagamento a consumo](https://docs.opser.com/it/billing/usage/) e gli avvisi sui crediti; la scheda **Cronologia** mostra la cronologia dei pagamenti dell'area di lavoro. I crediti e ciò che li ha usati sono in **Impostazioni → Utilizzo**. Alcuni ambienti non hanno la fatturazione self-service configurata. I piani negoziati o gestiti dall'operatore possono avere controlli diversi dagli abbonamenti alle carte. Se un controllo non è disponibile, seguire il percorso di contatto o gestione mostrato nell'interfaccia. ## Sottoscrivere o modificare un piano Per passare da Free a Growth, utilizza il flusso di selezione del piano e controlla i dettagli del checkout prima di pagare. Conferma il piano, la valuta, le tasse e l'importo del pagamento. Il diritto effettivo dell'area di lavoro dovrebbe essere controllato dopo il checkout e l'aggiornamento della fatturazione. Growth viene fatturato mensilmente. Con il pagamento a consumo attivo, la fattura mensile include anche l'uso extra del mese precedente. Embedded viene attivato tramite accordo anziché con il checkout. Per modificare un abbonamento esistente, utilizza il controllo di gestione della fatturazione o contatta l'assistenza. Non presumere che una modifica del piano sia completa solo perché hai fatto clic sul pulsante di selezione. Torna a Fatturazione e conferma il piano risultante. ## Gestisci i dettagli di pagamento Utilizzare il controllo di gestione della fatturazione quando disponibile per aprire il portale del provider di pagamento. Gestisci i metodi di pagamento supportati e le azioni di sottoscrizione lì. La pagina Fatturazione mostra anche la cronologia dei pagamenti e i collegamenti ai documenti di pagamento disponibili. ## Cancellazione Controlla la data di cancellazione mostrata in Fatturazione. Un abbonamento programmato per la cancellazione può rimanere attivo fino alla fine del suo periodo di pagamento. Una volta che la cancellazione ha effetto, l'area di lavoro torna al piano predefinito applicabile. Prima di passare a un piano inferiore, confronta lo spazio di archiviazione che usi con quello del nuovo piano e verifica che i suoi crediti mensili coprano il tuo utilizzo. Non presumere che l'annullamento esporti o elimini automaticamente i tuoi dati aziendali. L'uso a consumo non ancora addebitato finisce in una fattura finale quando l'abbonamento termina, e il pagamento a consumo si disattiva. ## Pagamenti falliti o ritardati Verificare la presenza di uno stato di pagamento non riuscito, aggiornare il metodo di pagamento se necessario e controllare il risultato del provider. Un rinnovo fallito della carta può impedire una nuova concessione di credito. Se un pagamento non è apparso correttamente, raccogliere il riferimento di pagamento e contattare il supporto invece di acquistare ripetutamente lo stesso articolo. Un pagamento non riuscito sospende anche il pagamento a consumo finché non viene pagato. --- # Cerca nella documentazione Cerca le guide, copia una pagina completa o leggi la documentazione come Markdown. Source: https://docs.opser.com/it/help/search/ ## Chiedi al tuo agente Opser Chiedi al tuo agente come usare Opser, ad esempio: “Come imposto un’automazione settimanale?” oppure “Dove posso modificare le impostazioni di approvazione?”. L’agente può cercare e leggere direttamente queste guide e includere i link alle pagine pertinenti. Non devi collegare un’app o configurare un servizio di ricerca sul web. Le guide spiegano come funziona il prodotto. L’agente verifica separatamente il tuo spazio di lavoro quando la risposta dipende dalle app installate, dalle autorizzazioni, dalle connessioni o dalle impostazioni attuali. L’agente conserva una copia temporanea delle guide pubbliche. Se il sito della documentazione non è disponibile, può usare l’ultima copia recuperata e avvisarti che potrebbe non essere aggiornata. Se non dispone ancora di una copia, segnala che non può leggere la documentazione invece di inventare istruzioni. ## Trova la guida giusta Uso **Cerca documenti**, **K** su macOS, oppure **Ctrl K** su Windows e Linux. La ricerca copre il testo e le intestazioni degli articoli pubblicati. Provare “file persistenti”, “strumenti integrati”, “eventi app” o “credit rollover”.” Utilizzare i filtri di sezione per restringere i risultati. I tasti freccia si muovono attraverso le partite, Enter apre uno, e Escape chiude la ricerca. I risultati della sezione ti portano direttamente all'intestazione pertinente. ## Copia una pagina completa Scegli **Copia pagina** nella parte superiore di una guida. Copia il titolo, la descrizione, il link sorgente e l'articolo completo come Markdown. I link sono assoluti, quindi un agente può seguirli dopo aver incollato il testo in una conversazione. Il testo copiato contiene la guida stessa, senza menu di navigazione o controlli di ricerca. Se l'accesso agli appunti non è disponibile, scegliere **Markdown** e selezionare il testo lì. ## Leggi i documenti senza l'interfaccia Ogni articolo ha un link **Markdown**. Puoi dare quell'URL direttamente a un agente che può recuperare contenuti web; non è necessario alcun account Opser o JavaScript per leggerlo. Il piè di pagina fornisce anche **llms.txt**, un indice che collega a ogni guida pubblica e **Tutti i documenti come testo**, la documentazione completa in un file di testo. Inizia con l'indice quando un agente dovrebbe scegliere le pagine pertinenti. Utilizzare il file completo quando si desidera fornire l'intero manuale, consentendo il limite di contesto dell'agente. Ad esempio, chiedi a un agente di leggere l'indice della documentazione, selezionare le guide sui file e gli script persistenti e spiegare come riutilizzare un'analisi la prossima settimana. Queste esportazioni documentano il prodotto pubblico; non collegano l'agente al tuo spazio di lavoro. ## Ambito della ricerca e della lettura La ricerca viene eseguita su un indice di documentazione statica. Non cerca i record o le conversazioni dell'area di lavoro privata e non invia la tua domanda a un servizio AI. JavaScript è necessario per la ricerca e la copia interattiva. Gli articoli, i file Markdown, la navigazione e la tabella dei contenuti rimangono leggibili senza di essa. Se la ricerca non riesce a caricare, riprovare o sfogliare la sezione pertinente. --- # Risoluzione dei problemi Trovare la causa di problemi comuni prima di ripetere un'attività o modificare la configurazione. Source: https://docs.opser.com/it/help/troubleshooting/ ## Manca un'app o un'impostazione Verificare di essere nell'area di lavoro corretta e di aver effettuato l'accesso come utente previsto. Chiedi a un amministratore di verificare che l'app sia installata e ispeziona le tue autorizzazioni effettive, inclusi i gruppi di accesso e la condivisione specifica dell'app. Aggiornare dopo le modifiche di accesso. Un'impostazione nascosta spesso riflette le autorizzazioni piuttosto che una pagina rotta. ## L'agente non può completare un compito Chiedi all'agente cosa l'ha fermato, oppure attiva **Mostra i passaggi dell’agente** in **Impostazioni → Generali** per leggere l'ultimo risultato dello strumento. Poi controlla: - è un [approvazione](https://docs.opser.com/it/agents/approvals/) in attesa di una decisione? - L'agente selezionato ha la [autorizzazioni](https://docs.opser.com/it/workspace/permissions/)? - È il pertinente [integrazione](https://docs.opser.com/it/agents/integrations/) collegato al giusto account? - Il file sorgente è stato caricato correttamente? - Sono [crediti e indennità di piano](https://docs.opser.com/it/billing/plans/) disponibile? Correggere la dipendenza specifica mancante, quindi riprovare un piccolo passo. La modifica dei modelli non risolve un'autorizzazione mancante o un account disconnesso. ## Una modifica potrebbe essere stata eseguita due volte Dopo un errore di rete, ispezionare il record di destinazione prima di ripetere una scrittura. Un’interruzione del browser non prova che il server abbia annullato l’operazione. Cerca un'attività, un ordine, una fattura o un messaggio esistente prima di crearne un altro. ## Un’esecuzione pianificata non è riuscita Apri la cronologia dell'automazione e ispeziona la corsa. Controlla il fuso orario, l'accesso all'agente, lo stato della connessione, i crediti e le approvazioni. Rivedere la pianificazione esistente prima di creare una sostituzione che potrebbe essere eseguita in parallelo. ## Un file non può essere aperto o salvato Controlla il risultato del caricamento, il formato del file, l'accesso all'app o alla cartella contenente e l'archiviazione disponibile. Per un file generato, apri la sua scheda nella chat, oppure attiva i passaggi dell'agente per ispezionare il risultato dello strumento. Conservare l'originale quando si chiede all'agente di riparare o trasformare un file complesso. ## Un pagamento non risulta registrato Ispezionare la fatturazione e lo stato del provider di pagamento. Registrare il riferimento di pagamento e il supporto di contatto se la transazione è riuscita ma l'area di lavoro non è stata aggiornata. Evitare acquisti ripetuti mentre il pagamento originale è irrisolto. ## Chiedi aiuto Utilizzare la [guida di supporto](https://docs.opser.com/it/help/support/) per includere un contesto sufficiente affinché qualcuno possa riprodurre il problema senza esporre credenziali o record privati non correlati. --- # Ottieni assistenza Fai una richiesta di supporto facile da capire e veloce da indagare. Source: https://docs.opser.com/it/help/support/ ## Prova prima un controllo rapido Molti problemi si risolvono con una verifica veloce. Consulta [Risoluzione dei problemi](https://docs.opser.com/it/help/troubleshooting/) per cause comuni come un account scollegato, un permesso mancante o un [saldo crediti esaurito](https://docs.opser.com/it/billing/usage/). Se in cima a Opser compare un avviso per tutto lo spazio di lavoro, un problema noto potrebbe essere già in fase di analisi. ## Parti da una descrizione chiara Se **Supporto** compare sotto App Store nella barra laterale, aprilo e scegli **Nuovo ticket**. Descrivi il problema e allega screenshot se servono. La pagina funziona senza installare Chat e non consuma crediti IA. I ticket sono visibili solo a te e al team Opser. Puoi anche chiedere al tuo agente predefinito, quello creato con il tuo account, di aprire un ticket, trovarne uno esistente, leggere le risposte o inviare un aggiornamento. Controlla e approva nuovi ticket e risposte prima che l’agente li invii. Gli altri agenti non possono accedere ai tuoi ticket privati; usa la pagina Supporto. Se altre persone possono usare il tuo agente predefinito, vedono la sua chat, compresi i ticket che leggi lì: usa la pagina Supporto per ciò che vuoi tenere per te. L’uso del modello resta soggetto alla fatturazione del tuo spazio di lavoro. Torna nella conversazione per leggere la risposta del team, aggiungere dettagli, risolvere il ticket o riaprirlo. Le preferenze di notifica controllano gli avvisi; una risposta del team non letta può generare un promemoria via email. Se Supporto non è disponibile nel tuo spazio di lavoro, usa la [pagina dei contatti Opser](https://opser.com/contact) o il canale di assistenza concordato per il tuo spazio di lavoro. Spiega cosa volevi fare, quale risultato ti aspettavi e cosa è successo. Includi l’indirizzo dello spazio di lavoro, l’app o l’agente interessato, l’orario approssimativo con il fuso orario e il messaggio di errore visibile. Indica se il problema riguarda una o più persone. ## Aggiungi elementi utili Una breve sequenza di passaggi è spesso più utile di un lungo registro. Includi un collegamento al record o alla conversazione, se adatto al canale di assistenza. Per problemi di fatturazione, fornisci il riferimento del pagamento anziché i dati della carta. Rimuovi password, chiavi API, token di sessione e informazioni private non pertinenti da screenshot e messaggi copiati. Non fornire mai la password, un codice di verifica o un collegamento per reimpostarla per diagnosticare un problema. ## Migliora le risposte dell’agente Se una risposta non è stata utile, usa il controllo di feedback su quel messaggio per segnalarla e aggiungere una nota facoltativa. È distinto da una richiesta di assistenza: contribuisce a migliorare le risposte future senza aprire un ticket. Per ottenere un miglioramento riutilizzabile, configura il [contesto](https://docs.opser.com/it/agents/context/) dell’agente o una [skill](https://docs.opser.com/it/agents/skills/), così il prossimo compito partirà da istruzioni migliori. Gli agenti possono anche segnalare in autonomia al team di prodotto Opser lacune di Opser stesso, come uno strumento che serviva ma non esiste, uno strumento che non ha funzionato correttamente o uno i cui risultati non erano chiari. Queste segnalazioni descrivono la lacuna in modo generico, senza dati personali, segreti o dati aziendali, e non ricevi una notifica quando ne viene inviata una. Una segnalazione non cambia nulla automaticamente e non è una richiesta di assistenza: per un aiuto con un tuo problema, apri un ticket come descritto sopra. ## Suggerisci un miglioramento alla documentazione Se una guida non è chiara, indica l’URL della pagina e il passaggio poco comprensibile. Descrivi ciò che hai visto nell’interfaccia, così la guida potrà essere verificata rispetto al prodotto. Per controlli immediati durante l’attesa, consulta [Risoluzione dei problemi](https://docs.opser.com/it/help/troubleshooting/). --- # Glossario Le parole che vedrete attraverso Opser, spiegate in termini quotidiani. Source: https://docs.opser.com/it/help/glossary/ ## Persone e agenti **Spazio di lavoro:** ambiente Opser dell'organizzazione, con i suoi utenti, app, record, agenti e impostazioni. **Agente predefinito:** il primo agente creato con il tuo account utente. Come per ogni agente, puoi dare accesso ad altre persone. **Agente specializzato:** un agente aggiuntivo che crei per un ruolo o un tipo di lavoro specifico. Lo usi solo tu finché non dai accesso ad altre persone. **Accesso all'agente:** le persone che possono usare un agente oltre al suo proprietario, che ne modifica le impostazioni. Tutti quelli con accesso usano l'agente insieme: la stessa chat, le automazioni, i file, la memoria e gli account collegati. Un agente non fa mai più di quanto potrebbe il suo proprietario. **Gruppo di accesso:** una raccolta riutilizzabile di autorizzazioni assegnate a persone o agenti. ## Compiti e funzionalità **Chat:** l'unica conversazione continua di un agente, condivisa da tutti quelli che possono usarlo, con messaggi, domande, file e risultati. Non si azzera mai. **Compattazione:** il modo in cui un agente mantiene gestibile una chat lunga. Riassume i messaggi precedenti, tiene gli ultimi parola per parola e recupera i dettagli più vecchi quando gli servono. Non si cancella nulla. **Passaggi:** gli strumenti, il ragionamento, il piano e i sub-agenti dietro la risposta di un agente. La chat li nasconde a meno che tu non attivi **Mostra i passaggi dell’agente** in **Impostazioni → Generali**. **Strumento:** un'operazione che un agente può eseguire, come la lettura di un file o l'aggiornamento di un record. **Abilità:** istruzioni che aiutano un agente ad avvicinarsi a un particolare tipo di lavoro. **Approvazione:** un punto di revisione prima che venga eseguita un'azione di agente proposta. Non sostituisce le autorizzazioni. **Automazione:** lavoro attivato da un evento o da una pianificazione supportati. I suoi risultati compaiono nella chat dell'agente. **Artefatto:** un file o un altro output prodotto durante un'attività, ad esempio una cartella di lavoro o un deck diapositive. ## App e dati **App:** uno strumento per lo spazio di lavoro con una propria interfaccia e operazioni dati supportate. Puoi anche vedere il termine tecnico "modulo" nei dettagli dell'operazione. **App interna:** un'app utilizzata nell'area di lavoro Opser. **App esterna:** un'esperienza web separata, come un sito o un portale, costruita attraverso la capacità dell'app esterna di Opser. **Integrazione:** una connessione autorizzata a un servizio o account esterno. **Bozza:** lavoro in fase di costruzione o revisione prima della pubblicazione. Un'anteprima non è necessariamente la versione pubblicata. **Contratto:** un'operazione dichiarata offre un'app e un'altra app è autorizzata a richiedere. **Evento:** un segnale che qualcosa è accaduto, consegnato a un flusso di lavoro di sottoscrizione dichiarato. **Notificazione:** un messaggio che porta l'attività all'attenzione di una persona, separata da un evento del flusso di lavoro. **Agente area di lavoro:** il filesystem persistente appartenente a un agente, utilizzato per input, script e risultati da un'attività all'altra. **Standard del documento:** istruzioni di un'organizzazione e file di riferimento opzionale per un formato di documento ricorrente. ## Fatturazione **Credito:** un'unità di valore d'uso. Il costo di un'attività dipende dai modelli e dalle operazioni che utilizza. **Crediti del piano:** l'indennità ricorrente inclusa con un piano di spazio di lavoro. **Crediti aggiuntivi:** un saldo separato che non scade, usato dopo i crediti del piano, come i crediti concessi dal supporto.