Documentazione · App Builder
App Studio
Dove si trova e chi può usarlo
App Studio si trova su /dashboard/app-studio nel Cloud Dashboard. L'elenco delle app è su
/dashboard/app-studio/apps.
| Ruolo nell'organizzazione | Che cosa può fare |
|---|---|
| viewer | Niente in App Studio: al posto dell'editor e dell'elenco delle app compare un avviso di sola lettura. |
| developer | Progettare, salvare bozze, pubblicare aggiornamenti. |
| admin | Tutto ciò che fa un developer, più la prima pubblicazione di un'app (crea la chiave API dell'app), l'attivazione dei pagamenti, il collegamento a GitHub e l'esportazione, l'eliminazione di un'app. |
La parte alta della pagina
La fascia in alto contiene i comandi per l'app su cui stai lavorando.
- Il badge App Studio, poi un selettore con le app della tua organizzazione. Riporta Open an app… (o No apps
yet); ogni voce mostra il nome dell'app seguito da
· v<N>se è pubblicata o da· draftse non lo è. - + New app (nuova app) chiude l'app corrente e riparte dalla pagina vuota.
- All apps apre l'elenco delle app.
- A destra, lo stato:
status: draftostatus: published v<N>, seguito da· unsavedquando hai modifiche non ancora salvate e da· <N> problem(s)quando il manifest non supera la validazione. Sulla pagina vuota riportanew app.
La casella del co-pilot
Su un'app nuova il titolo è Describe your app. The co-pilot builds it. e il segnaposto della casella è Describe your app — e.g. “a valuation report for real-estate agents, paid with credits”. Il pulsante è Design the app (progetta l'app).
Su un'app aperta il titolo è Describe a change. The co-pilot redesigns your app., il segnaposto è Describe a change — e.g. “add a Paphos option and ask for the budget” e il pulsante è Propose change (proponi modifica).
Premi il pulsante o Invio per partire. Il co-pilot riceve sempre il tuo testo e il manifest corrente, quindi una richiesta di modifica cambia solo ciò che chiedi. Vedi l'esecuzione del co-pilot.
Esempi
Su un'app nuova con la casella vuota, Start from an example (parti da un esempio) mostra tre schede: Property valuation report, Supplier due-diligence e Trip planner. Use this → copia il testo della scheda nella casella. Modificalo, poi premi Design the app.
Pulsanti di azione
Quando un'app è aperta compare una fila di pulsanti:
| Pulsante | Che cosa fa |
|---|---|
| Save draft | Salva il manifest e la disposizione del canvas. Mostra Saving… mentre lavora. |
| Open preview | Apre https://preview-<slug>.webrobot.eu in una nuova scheda: la bozza salvata, servita dal runtime. Compare dopo il primo salvataggio dell'app. |
| Export code | Apre o chiude il pannello di esportazione. |
| Export diagram (PDF) | Apre una finestra di stampa con il canvas come disegno vettoriale, la legenda delle frecce e l'elenco dei riquadri. Salvalo come PDF dal browser. |
| Publish | Salva le modifiche non salvate, poi pubblica. Disattivato finché ci sono errori (tooltip Fix the problems first). Mostra Publishing…. Vedi Pubblicazione. |
App vuota
Quando nessuna app è aperta, una scheda Or start from a blank app offre Start blank (parti da zero). Il browser chiede l'App name (nome dell'app). Lo slug viene ricavato dal nome: minuscole, accenti rimossi, gli altri caratteri trasformati in trattini, al massimo 40 caratteri. Se il risultato non è uno slug valido il messaggio è Choose a name with at least 3 letters.
L'app vuota è uno scheletro funzionante:
- accesso tramite link via email, con due ruoli:
admin(dalle email degli amministratori dell'app) euser(chiunque si registri); - una home page visibile senza accedere;
- un modulo con un'area di testo obbligatoria, What should the report be about?;
- un agente,
main, con il modelloclaude-sonnet-5-5, 6 turni e un budget di 0.5 USD per esecuzione; - le pagine New report, My reports, il report stesso (stampabile) e Credits;
- billing a crediti: 50 crediti gratuiti alla registrazione, pagamento per uso con 10 crediti trattenuti per esecuzione, un ricarico del 50%, 1 credito = 0.01 EUR e un pacchetto da 200 crediti a 5 EUR.
spec:
pattern: report
billing:
modes: [credits]
signupCredits: 50
costs:
"agent:main": { estimate: 10, metered: true }
metering: { creditEur: 0.01, markupPct: 50, drivers: [llm_tokens, compute] }
packs:
- { key: small, credits: 200, price: 5 }
L'app vuota non viene salvata finché non premi Save draft.
Esecuzione del co-pilot
- Il co-pilot è un agente della piattaforma. Lavora in background. Il pulsante mostra Designing… e la pagina dice The co-pilot is designing the app (usually 1–3 minutes). You can leave the page: the proposal waits for you. Le app più grandi richiedono più tempo; un'app completa con più agenti e approvazioni ha richiesto circa 2 minuti nelle nostre prove.
- App Studio controlla l'esecuzione ogni 5 secondi. Se ricarichi la pagina o torni sulla stessa app entro 30 minuti, riprende a seguire la stessa esecuzione.
- Quando arriva la proposta, App Studio la valida. Se ha errori, o anche solo avvisi di progettazione, App Studio la rimanda al co-pilot una volta, con l'elenco (al massimo 30 voci), e mostra The proposal had N problem(s): the co-pilot is fixing them…. La seconda risposta viene mostrata così com'è, anche se restano errori.
- Se il co-pilot ha bisogno di qualcosa che non può indovinare, risponde con una domanda invece che con un'app. La pagina mostra The co-pilot asks: e la domanda. Aggiungi la risposta al tuo testo ed eseguilo di nuovo.
- Se l'esecuzione fallisce, la pagina mostra il suo errore, oppure the co-pilot failed. Se termina senza un'app né una domanda, la pagina mostra the co-pilot gave no app — describe it again.
Il co-pilot non modifica mai la tua app da solo: vedi sempre prima una proposta.
La proposta
Mentre è mostrata una proposta, il canvas disegna la proposta, non la tua app, e una barra sopra di esso dice The canvas shows the proposal: <app name>.
- Bordo verde e badge new: un riquadro che non esiste nella tua app.
- Bordo ambra e badge changed: un riquadro il cui contenuto è diverso. Un obiettivo modificato sulla freccia che entra in un agente segna quell'agente come modificato.
- would remove: seguito da nomi: riquadri della tua app che la proposta non ha più.
- Se la proposta ha ancora errori di schema, la barra dice N schema problem(s): you can apply it and fix them.
Poi:
- Apply (applica) sostituisce il tuo manifest con la proposta. Su un'app nuova, l'app prende lo slug scelto dal co-pilot. Su un'app esistente lo slug resta lo stesso: l'indirizzo non cambia mai a tua insaputa. Il messaggio dice Proposal applied — click the boxes to review, then Save draft.
- Discard (scarta) elimina la proposta e mostra di nuovo la tua app.
Mentre una proposta è sullo schermo non puoi selezionare i riquadri, i pulsanti di aggiunta sono disattivati e l'inspector è nascosto. Applicare non salva: premi Save draft dopo.
Il canvas
Il canvas disegna il manifest come un flusso da sinistra a destra. È una proiezione del manifest: ogni modifica torna nel manifest attraverso i pannelli. Puoi trascinare i riquadri; le loro posizioni vengono salvate con la bozza, fuori dal manifest. Ingrandisci e sposta la vista con i comandi nell'angolo.
Corsie
I riquadri stanno in corsie che dicono a che cosa servono, da sinistra a destra: Users & pricing, Navigation, Pages, Input & data, Agents, App data, What users see. Se le viste sono molte, si distribuiscono su più colonne da cinque.
Riquadri
Passa con il mouse su un riquadro per vederne il tipo e una riga su che cosa fa. Fai clic per modificarlo nell'inspector.
| Icona | Riquadro | Che cos'è |
|---|---|---|
| 👤 | Users | Chi usa l'app: come accede e i suoi ruoli. |
| ☰ | Menu | L'intestazione per i visitatori e il menu dell'app per gli utenti che hanno effettuato l'accesso, in ordine. |
| 🏠 | Home page / Page | Una pagina costruita con blocchi (/ per la home, /v/<key> per le altre). Fai doppio clic per aprire l'editor delle pagine. |
| 📝 | Form | I campi che l'utente compila; diventano l'obiettivo dell'agente. |
| 🤖 | Agent | Un agente dell'app. Le sue righe mostrano il modello (o la dimensione della squadra), se agisce sulla piattaforma e l'inizio delle sue istruzioni. |
| 📄 | View | Una pagina dell'app non costruita con blocchi: report, storico, tabella, schede, grafico, chat, approvazioni… |
| 💳 | Pricing | Come pagano gli utenti: modalità, crediti gratuiti, pacchetti, piani. Compare quando il billing non è gratuito. |
| 🗃 | App collection | Record conservati dall'app. Compare quando una vista la legge o un agente la usa come strumento. |
| 🐍 | Python slot | Codice Python tuo, eseguito in una sandbox. |
| 🔌 | External service (MCP) | Un server MCP di un altro servizio, i cui strumenti possono essere usati da un agente. |
| 🗄 | Data job | Una pipeline di cui l'app legge il dataset. |
| ⏱ | Schedule | Esegue un agente o un job di dati a orari fissi. Il suo titolo è l'orario a parole, per esempio Every day at 06:00 UTC. |
| 👥 | Team | Agenti che lavorano insieme, in sequenza o come sciame. |
| ⚡ | Trigger | Un evento che avvia un agente, una squadra o un job di dati. |
| ✋ | Approval | Un punto di controllo umano e il ruolo che decide. |
| 🧩 | Agent template | Un agente che gli utenti dell'app creano per sé. |
| 🧠 | Memory | Ciò che un agente ricorda di ogni utente. |
| 📞 | Channel | Dove le conversazioni raggiungono un agente. |
Un riquadro con bordo tratteggiato e not run yet nella sua scheda al passaggio del mouse è conservato nel
manifest, ma App Studio non si aspetta che il runtime lo esegua. È il caso, per esempio, dei job di dati, dei canali
diversi da web e degli agenti di supporto che non vengono avviati né dal modulo, né da una pianificazione, né da una
condizione when.
Frecce
Ogni freccia ha un solo significato, un suo colore e un suo stile di linea. Passa con il mouse su una freccia per leggerla; fai clic per selezionarla.
| Freccia | Significato |
|---|---|
| Menu item | Una voce del menu dell'app che apre questa pagina (utenti che hanno effettuato l'accesso). |
| Link | Un pulsante o un link dell'intestazione che porta l'utente a questa pagina o sezione. |
| Contains | La pagina mostra al suo interno questa vista (il modulo, l'ultimo report, la chat…). |
| Starts the agent | L'invio del modulo esegue l'agente con l'obiettivo costruito dai campi. La sua etichetta mostra la prima riga dell'obiettivo e il prezzo. |
| Writes | Il risultato dell'agente arriva in questa vista o raccolta. |
| Each message | Ogni messaggio della chat è un'esecuzione di questo agente, con la conversazione fino a quel punto. |
| Data | Righe o risultati in arrivo: un job di dati, una raccolta dell'app, una pianificazione. |
| Uses as a tool | L'agente può chiamarlo mentre lavora: strumenti dell'app su una raccolta, uno slot Python, un server MCP esterno. |
| Helps | Un agente di supporto di quello principale. |
| Pays | Come pagano gli utenti le esecuzioni. |
| Uses | Che cosa fanno gli utenti: compilano il modulo, aprono il menu. |
| Delegates | L'agente affida a questo agente un sotto-compito (strumento ask_<agent>) e attende la sua risposta. |
| Then | Nella sequenza di una squadra: questo passo viene eseguito dopo quello e riceve il suo output. |
| Emits an event | Qui succede qualcosa (un record scritto, un acquisto, una decisione, una chiamata) e il trigger lo rileva. |
| Starts | Quando l'evento si verifica, il trigger avvia questo agente, squadra o job di dati. |
| Waits for approval | L'agente chiede a una persona di decidere (strumento request_<approval>); la decisione fa riprendere il lavoro tramite un trigger. |
| Creates their own | Ogni utente dell'app crea istanze di questo modello. |
| Remembers | L'agente legge ciò che ricorda dell'utente a ogni compito e lo aggiorna (strumento remember). |
| Answers on | Le conversazioni da questo canale raggiungono l'agente. |
Aggiungere parti
La barra sopra il canvas aggiunge una parte con valori predefiniti sensati, la seleziona e la apre nell'inspector.
| Pulsante | Che cosa aggiunge |
|---|---|
| + Agent | Un agente (ruolo main se l'app non ne ha, altrimenti helper), modello claude-sonnet-5-5, 6 turni, budget di 0.5 USD, un obiettivo con una riga facoltativa per ogni campo del modulo. |
| + Form field | Un campo di testo chiamato field, field2… |
| + Output | Una vista report stampabile, oppure una vista storico My runs se esiste già un report. |
| + Page | Una pagina con un blocco hero. La prima è la home page, visibile senza accedere. |
| + Pricing | Billing a crediti come nell'app vuota, e una vista Credits se non ce n'è una. |
| + Data | Un job di dati con una pipeline di esempio. Disegnato tratteggiato. |
| + Python | Uno slot Python con un main(input) di esempio, limite di tempo di 3000 ms. |
| + Schedule | Esegue l'agente principale ogni giorno alle 06:00 UTC (0 6 * * *), a nome dell'app. |
| + Team | Una squadra in sequenza con i primi due agenti come passi. |
| + Trigger | Un trigger webhook che avvia l'agente principale. |
| + Approval | Un'approvazione decisa dal ruolo admin, timeout di 30 minuti, rifiutata allo scadere del timeout; l'agente principale può richiederla, e viene aggiunta una vista To approve se non ce n'è una. |
| + Template | Un modello di agente sull'agente principale, con un parametro, una pianificazione settimanale, al massimo 5 per utente e 10 crediti per esecuzione, più una vista My agents per il ruolo user. |
| + Channel | Un canale telefonico a cui risponde l'agente principale. Disegnato tratteggiato. |
L'inspector
La colonna di destra modifica il riquadro o la freccia selezionati. La sua intestazione ripete il tipo di riquadro, il nome del riquadro e una riga su che cosa fa. Se non è selezionato nulla dice Click a box or an arrow to edit it. Drag the boxes to arrange the flow.
| Selezione | Che cosa si apre |
|---|---|
| Users | Le impostazioni dell'app (come nella scheda App). |
| Menu, una freccia del menu o un link dell'intestazione | L'editor del menu: quali viste sono voci di menu e in che ordine, e l'intestazione per i visitatori. |
| Form | I campi del modulo. |
| La freccia dal modulo a un agente | L'editor dell'obiettivo. |
| Agent o la sua memoria | Le impostazioni di quell'agente. |
| Un riquadro MCP | Le impostazioni dell'agente che lo usa. |
| Pricing | Le impostazioni di billing. |
| View o pagina | Le impostazioni di quella vista; per una pagina, Open page editor (apri editor della pagina). |
| Slot Python, pianificazione, squadra, trigger, approvazione, modello, canale | I rispettivi pannelli. |
| Data job | L'editor JSON. |
L'editor dell'obiettivo
L'obiettivo è il testo che l'agente riceve a ogni esecuzione. Fai clic sul chip di un campo per aggiungerlo in coda;
i campi di selezione offrono anche {field_label}, mentre {date} e {lang} sono sempre disponibili.
{?field}…{/field} mantiene una riga solo quando il campo è compilato; {!field}…{/field} solo quando è vuoto.
Quando l'app non è gratuita, Credits per run (crediti per esecuzione) imposta il prezzo dell'esecuzione. Vedi
Agenti e automazione.
Slot Python
Il pannello dello slot mostra il codice (Python 3.12, definisci main(input), input è {values, lang}), il limite
di tempo (da 100 a 10000 ms, predefinito 3000) e quali agenti ricevono i suoi valori. Run test (esegui test)
esegue il codice con l'input di prova nella sandbox reale e mostra l'output e il tempo impiegato. Keep as example
(conserva come esempio) memorizza l'input di prova nel manifest.
Trigger con webhook
Un trigger webhook ha Show address and secret (mostra indirizzo e segreto). Mostra l'indirizzo
https://<slug>.webrobot.eu/api/hooks/<key> e il segreto che il servizio chiamante deve inviare. Il webhook risponde
solo sull'app pubblicata, non nell'anteprima.
L'editor delle pagine
Fai doppio clic sul riquadro di una pagina, oppure premi Open page editor nel suo pannello. L'editor occupa lo schermo: i blocchi a sinistra, la pagina come la vedono gli utenti a destra. La barra in alto mostra l'indirizzo della pagina. Done (fatto) o Esc lo chiude.
Trascina un blocco dalla tavolozza nella pagina, trascina i blocchi per riordinarli e modifica ciascuno sul posto:
| Blocco | Uso |
|---|---|
| Hero | Titolo, testo, pulsanti. |
| Steps | Numerati 1 · 2 · 3. |
| Cards | Funzionalità, fonti, piani. |
| Text | Markdown libero. |
| Data | Tabella, schede, numeri da una sorgente. |
| App view | Il modulo di esecuzione, lo storico, una tabella, la chat… dentro la pagina. |
| HTML | Un blocco personalizzato. Script, form e iframe vengono rimossi; gli stili inline restano. |
| Small print | Avvertenze, piè di pagina. |
I pulsanti portano alle pagine dell'app o a un blocco della pagina tramite un'ancora, scelti da un elenco. Vedi Viste e pagine.
Tutte le impostazioni
Sotto il canvas, ▸ All settings (tutte le impostazioni) apre ogni sezione come modulo, in schede:
| Scheda | Che cosa modifica |
|---|---|
| App | Nome, indirizzo (sola lettura), sottotitolo, lingue, pattern, domini del cliente, tema e colori, font, pulsanti, larghezza della pagina, l'email quando un report è pronto, orari di servizio, colori aggiuntivi, l'intestazione. |
| Form | I campi del modulo: nome, tipo, obbligatorio, etichetta, aiuto, opzioni. |
| Data | Raccolte: nome, campi, a chi appartengono i record, chi altro vi accede, conservazione in giorni; servizi che gli utenti collegano con le proprie chiavi API; quote per piano. |
| Agents | Ogni agente: chiave, ruolo, profilo, obiettivo, strumenti dell'app, server MCP esterni, modello, turni, budget, istruzioni. |
| Views | Ogni vista: chiave, tipo, ruoli, menu, titolo, sorgente dei dati e visualizzazione. |
| Billing | Stato dei pagamenti, modalità, crediti, pagamento per uso, pacchetti. |
| JSON | L'intero manifest. |
La scheda JSON viene applicata quando esci dall'area di testo. Se il testo non è JSON valido mostra Not valid JSON: e l'errore, e non cambia nulla. Usala per ciò che i pannelli non mostrano.
La scheda Billing inizia con lo stato dei pagamenti della tua organizzazione: Payments are on…, Your Stripe account is not ready yet… con Finish the Stripe onboarding, oppure Payments are off… con Enable payments. Solo un amministratore dell'organizzazione può attivare i pagamenti. Vedi Pagamenti e crediti.
Quello che vede l'utente
Sotto l'inspector, What the user sees (quello che vede l'utente) mostra il riquadro selezionato come lo vedranno i tuoi utenti, con i colori e i font dell'app: una pagina, il modulo, un report di esempio, l'accesso, i prezzi. È disegnato dal manifest che stai modificando, prima del salvataggio. La versione reale è all'indirizzo di anteprima.
Stato, errori e avvisi
La scheda sotto l'anteprima mostra Published v<N> o Not published yet, poi valid o <N> problem(s), l'indirizzo dell'app e ogni dominio del cliente con il CNAME che richiede.
- Gli errori (in rosso, ne vengono mostrati fino a 8) sono violazioni dello schema e delle regole del manifest. Una bozza con errori può essere salvata, ma Publish resta disattivato finché non vengono corretti.
- Gli avvisi (in ambra, segnati con ⚠, ne vengono mostrati fino a 6) sono controlli di progettazione, per esempio una raccolta in cui non scrive nulla. Vengono mostrati solo quando non ci sono errori e non bloccano mai la pubblicazione.
Vedi Validazione.
Elenco delle app
/dashboard/app-studio/apps elenca tutte le app della tua organizzazione, dalla più recentemente aggiornata. Cerca
per nome, slug o dominio.
Ogni scheda mostra:
- il nome, lo slug e quando è stata aggiornata l'ultima volta;
- un badge: Live · v<N> o Draft;
- Address:
<slug>.webrobot.eu, con la data di pubblicazione (solo quando è online); - Preview:
preview-<slug>.webrobot.eu; - Domains: i domini del cliente della versione pubblicata.
Azioni:
| Azione | Che cosa fa |
|---|---|
| Edit | Apre l'app in App Studio. |
| Open app | Apre l'indirizzo online (solo quando è pubblicata). |
| Export code | Apre App Studio con il pannello di esportazione aperto. |
| Delete | Solo amministratori. Chiede conferma, poi smette subito di servire l'app e revoca la sua chiave. Gli agenti e le pipeline che ha creato restano nell'organizzazione. |
Lo spostamento di un'app in un'altra organizzazione viene fatto dagli amministratori della piattaforma WebRobot. Vedi Pubblicazione.