> ## Documentation Index
> Fetch the complete documentation index at: https://docs.devin.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Devin Apps

> Le Devin Apps sono applicazioni web che Devin crea ed esegue sulla propria macchina, accessibili da un URL stabile. Scopri come crearle, condividerle, bloccarle, aggiornarle e pagarle.

Una Devin App è un'applicazione web che Devin crea per te e continua a eseguire sulla propria macchina. Può essere uno strumento interno, un pannello di controllo, un modulo, un tracker o una demo. Ogni App ha un URL stabile che puoi condividere con il tuo team.

Le App vengono eseguite allo stesso modo delle [anteprime nel browser](https://docs.devin.ai/it/work-with-devin/browser-previews.md). Un'anteprima serve a visualizzare il lavoro in corso all'interno di una sessione ed è sufficiente nella maggior parte dei casi. Un'App è invece pensata per qualcosa che il tuo team continuerà a usare anche dopo la conclusione del lavoro della sessione.

> [!NOTE]
>
> Le Devin Apps sono in fase di rilascio graduale. Se non vedi **Apps** nella barra laterale, la funzionalità non è ancora attiva per te.

## Come funzionano le Devin Apps

* **L'App viene eseguita sulla macchina di Devin.** Devin crea l'App in una sessione e la esegue dalla macchina di quella sessione. Nulla viene distribuito su host di terze parti.
* **Qualsiasi stack va bene.** Devin può usare i framework e i linguaggi più adatti al compito, purché il risultato esponga un servizio HTTP su una porta.
* **I tuoi dati restano sulla macchina.** L'App può usare qualsiasi database tu preferisca, come SQLite o Postgres, in esecuzione sulla stessa macchina. Anche i file e i caricamenti risiedono lì.
* **L'URL è stabile.** L'URL di un'App ha questo formato: `https://<name>--<id>.preview.devinapps.com`. Rimane invariato a ogni aggiornamento e non cambia nemmeno se rinomini l'App. Devin conosce l'URL e te lo comunica quando l'App è online.
* **Le App sono private.** Chiunque apra un'App deve accedere a Devin. Sei tu a scegliere chi ha accesso. Le App non sono mai pubbliche.
* **Una sessione gestisce l'App.** La sessione che crea l'App rilascia anche le modifiche successive. Per modificare un'App, invia un messaggio alla sua sessione.

## Casi d'uso

* **Versioni beta e di staging del tuo prodotto.** Devin può eseguire lo stack reale della tua azienda sulla propria macchina: frontend, backend, database ed eventuali worker. Per questo una Devin App è il posto ideale per ospitare una copia beta o di staging della tua app, che i colleghi possono aprire da un collegamento senza dover configurare un hosting separato.
* **Strumenti interni.** Pannelli di amministrazione, moduli di richiesta, code di approvazione e piccoli strumenti che sostituiscono un foglio di calcolo condiviso.
* **Dashboard.** Metriche, stato operativo della reperibilità, code di supporto o dati di vendita, estratti dalle tue origini dati e aggiornati secondo una pianificazione.
* **Tracker di rollout.** Una pagina che mostra a che punto è una migrazione, un lancio o il rollout di un flag di funzionalità, e cosa resta da fare.
* **Demo e prototipi.** Una versione funzionante di un'idea che le persone possono provare con pochi clic prima che tu realizzi quella definitiva.

## Creare un'App

1. Apri [**Apps**](https://app.devin.ai/apps) nella barra laterale.
2. Descrivi cosa deve fare l'App. Puoi anche partire da un template di prompt.
3. Invia il prompt.

Si apre una nuova sessione Devin. Nel primo messaggio Devin pone le eventuali domande, quindi crea l'App e la mette online. L'App compare subito in **Apps** con il relativo URL e il suo stato resta **Building** finché la prima versione non è online.

Puoi anche richiedere un'App in qualsiasi sessione, ad esempio «crealo come Devin App». Se Devin ti ha già mostrato un'anteprima nel browser, puoi chiedergli di pubblicarla come App.

## Sospensione, risveglio e fatturazione

La macchina di Devin entra in sospensione quando nessuno la sta usando. Quando qualcuno apre l'App, la macchina si risveglia e fornisce la pagina. Il primo caricamento dopo una sospensione può richiedere alcuni secondi. La macchina torna in sospensione 5 minuti dopo l'ultima richiesta.

La fatturazione di un'App si basa sul tempo in cui la macchina rimane attiva. Un'App che nessuno visita non consuma nulla mentre la macchina è in sospensione. La creazione e la modifica dell'App rientrano nel normale lavoro di sessione e vengono fatturate come qualsiasi altra sessione. Consulta [Utilizzo](https://docs.devin.ai/it/admin/billing/usage.md).

## Condividere un'App

Fai clic su **Share** in un'App per copiarne il collegamento o modificare chi può aprirla. **General access** prevede tre livelli:

| Livello | Chi può aprire l'App |
| - | - |
| **Only people with access** | Il creatore, gli amministratori dell'organizzazione e le persone che aggiungi |
| **Organizzazione** | Tutti i membri della tua organizzazione e chiunque tu aggiunga |
| **Enterprise** | I membri di tutte le organizzazioni della tua azienda |

Puoi anche aggiungere singole persone, gruppi o organizzazioni e scegliere cosa può fare ciascuno: aprire l'App, modificarne le impostazioni o condividerla con altri.

Gli amministratori dell'organizzazione possono impostare il livello di condivisione predefinito per tutte le App dell'organizzazione in **Sharing defaults**.

## Trovare e fissare le Apps

La pagina Apps elenca le Apps che puoi aprire e offre ricerca, categorie e filtri. Puoi fissare in alto quelle che usi più spesso. Esistono due modi per fissarle:

* **Pin for me** mantiene un'App in cima alla tua home delle Apps.
* **Pin for everyone** porta un'App in cima alla home delle Apps per l'intera organizzazione. Solo gli amministratori dell'organizzazione possono farlo.

Se ti piace l'App di qualcun altro, con **Use as a starting point** puoi creare una nuova App basata su di essa.

## Aggiornare un'App

Apri l'App e fai clic su **Edit in session**, quindi indica a Devin cosa modificare. Devin applica la modifica, esegue la build di una nuova versione e la pubblica online. L'URL resta invariato.

Ogni aggiornamento genera una nuova versione. La pagina dell'App le elenca in **Deployments**, indicando per ciascuna lo stato, una descrizione e il commit. Se una nuova versione non si avvia, resta attiva la versione precedente. Per tornare a una versione precedente, chiedi alla sessione di distribuire di nuovo quella versione.

La pagina dell'App mostra anche le visualizzazioni di pagina delle ultime 24 ore, degli ultimi 7 giorni o degli ultimi 30 giorni.

Il creatore dell'App e gli amministratori dell'organizzazione possono aprirne le impostazioni per rinominarla, modificarne la descrizione, impostare un'immagine di copertina, metterla offline o eliminarla. Se un'App viene messa offline, la sua cronologia viene conservata. Se viene eliminata, l'URL smette di funzionare. Nessuna delle due operazioni ha effetto sulla sessione.

## Come Devin crea le App

Quando crea un'App, Devin segue una serie di istruzioni integrate. Ecco gli aspetti più utili da conoscere:

* **Esegue una build di produzione.** Devin sviluppa usando un server di sviluppo e verifica il proprio lavoro in un'anteprima nel browser. Quando l'App funziona, ne esegue la build ed esegue la build di produzione, non il server di sviluppo.
* **Mantiene il codice in git.** Devin esegue un commit prima di ogni distribuzione, così ogni versione corrisponde a un commit. Se l'App si trova in uno dei tuoi repository, Devin esegue il push dei commit o apre una pull request.
* **Tiene i dati fuori dalla cartella di build.** I file del database e i file caricati vengono archiviati al di fuori della cartella che viene ricompilata, così un aggiornamento o un rollback non li cancella.
* **Usa il tuo brand.** A meno che tu non richieda uno stile specifico, Devin cerca il design system della tua azienda nei tuoi repository e ne usa colori, font e componenti. Ti indica anche da dove ha preso il brand. Se non ne trova uno, usa uno stile semplice predefinito.
* **Fa subito tutte le domande.** Spesso le persone si allontanano dopo aver inviato una richiesta, quindi Devin chiede tutto ciò che gli serve già nella prima risposta.
* **Non lascia versioni non funzionanti.** Se una distribuzione non riesce, Devin legge l'errore, lo corregge e ripete la distribuzione.
* **Crea una miniatura.** Dopo una distribuzione, Devin acquisisce una schermata dell'App da mostrare nella relativa scheda della pagina Apps.

Puoi modificare uno qualsiasi di questi comportamenti nel tuo prompt. Ad esempio, puoi indicare lo stack, il database o lo stile che desideri.

## Mantenere un'App aggiornata con le automazioni

Un'App non deve aspettare che tu le chieda delle modifiche. Un'[automazione](https://docs.devin.ai/it/product-guides/automations.md) può risvegliare Devin e fargli aggiornare l'App al posto tuo. Due configurazioni comuni:

* **In base a una pianificazione.** Devin si risveglia ogni ora, ogni giorno o ogni settimana, recupera i dati più recenti e aggiorna l'App. Questa soluzione è ideale per dashboard e report.
* **A ogni push.** Se l'App segue un branch in uno dei tuoi repository, Devin la ridistribuisce ogni volta che il branch cambia.

Chiedi alla sessione dell'App di configurarla. Devin crea l'automazione e tu devi approvarla una sola volta. Puoi anche crearla tu stesso nella pagina Automazioni e impostarla in modo che invii un messaggio alla sessione dell'App.

> [!WARNING]
>
> Ogni run di un'automazione è una sessione Devin e viene fatturata come tale. Un'App che si aggiorna ogni pochi minuti può costare molto più dell'App stessa. Per contenere i costi:
>
> * Esegui l'automazione meno spesso. Per la maggior parte delle dashboard basta un aggiornamento orario o giornaliero.
> * Scegli un modello più economicamente efficiente per le sessioni dell'automazione.
> * Limita il lavoro al minimo. Chiedi a Devin di scrivere uno script che recuperi solo i nuovi dati e di eseguirlo a ogni aggiornamento, così non dovrà ricostruire la soluzione da capo ogni volta.
> * Imposta un limite di spesa per sessione sull'automazione. Consulta [Limiti e misure di sicurezza](https://docs.devin.ai/it/product-guides/automations.md#limits-and-safeguards).

## Segreti e altri servizi

Un'App può leggere dati da altri servizi e scrivervi. Devin configura il tutto esattamente come in qualsiasi sessione.

* **Chiavi API per altri servizi.** Aggiungi la chiave come [segreto](https://docs.devin.ai/it/product-guides/secrets.md) e indica a Devin a quale servizio è destinata. Devin passa la chiave al server dell'App, che chiama il servizio da lì. Conserva le chiavi sul lato server dell'App: tutto ciò che viene inviato al browser è visibile a chiunque possa aprire l'App.
* **L'API di Devin.** Un'App può chiamare l'[API di Devin](https://docs.devin.ai/it/api-reference/overview.md) con un [token di accesso personale](https://docs.devin.ai/it/api-reference/personal-access-tokens.md) o una chiave dell'utente di servizio. In questo modo puoi creare strumenti personalizzati basati su Devin, come una pagina che avvia sessioni da un modulo o un pannello di controllo con le sessioni del tuo team. Un token di accesso personale agisce a tuo nome, quindi chiunque usi l'App agisce con le tue autorizzazioni. Condividi con cautela un'App di questo tipo.
* **Accesso.** Chiunque apra un'App ha già effettuato l'accesso a Devin, quindi la maggior parte delle App non richiede un proprio login.

I segreti risiedono sulla macchina di Devin insieme al resto dell'App. Non rientrano nelle impostazioni di condivisione dell'App e chi può aprire l'App non può leggerli, a meno che non sia l'App stessa a mostrarli.

## Quando un'App è offline

Un'App dipende dalla propria sessione. Tieni presente quanto segue:

* **Se archivi o termini la sessione, l'App va offline.** Devin ti avvisa prima che tu archivi una sessione che esegue un'App. Per riportare l'App online, rimuovi la sessione dall'archivio o riprendila.
* **Un server andato in crash non viene riavviato automaticamente.** Se il server dell'App si arresta, l'URL mostra una pagina di errore finché Devin non lo riavvia. Apri la sessione dell'App e chiedi a Devin di distribuirla di nuovo.
* **Un'App senza una versione attiva mostra una pagina offline.** È ciò che vedi prima che la prima distribuzione sia completata, oppure dopo che qualcuno ha messo l'App offline.

In tutti questi casi, la soluzione è aprire la sessione dell'App dalla pagina Apps e chiedere a Devin di distribuirla.

## Limiti

* Le app non possono essere rese pubbliche: i visitatori devono sempre accedere tramite Devin.
* Le app non possono registrare un proprio service worker, quindi la modalità offline per le PWA non è disponibile.
* L'App viene eseguita su una sola macchina. È adatta a strumenti interni e dashboard, ma non a servizi di produzione ad alto traffico. In questi casi, distribuisci sulla tua infrastruttura con la pipeline CI/CD che già utilizzi e concedi a Devin l'accesso tramite [Segreti](https://docs.devin.ai/it/product-guides/secrets.md) e [Competenze](https://docs.devin.ai/it/product-guides/skills.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.