WebRobot
App Builder · pagine

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'organizzazioneChe cosa può fare
viewerNiente in App Studio: al posto dell'editor e dell'elenco delle app compare un avviso di sola lettura.
developerProgettare, salvare bozze, pubblicare aggiornamenti.
adminTutto 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 · draft se 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: draft o status: published v<N>, seguito da · unsaved quando hai modifiche non ancora salvate e da · <N> problem(s) quando il manifest non supera la validazione. Sulla pagina vuota riporta new 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:

PulsanteChe cosa fa
Save draftSalva il manifest e la disposizione del canvas. Mostra Saving… mentre lavora.
Open previewApre https://preview-<slug>.webrobot.eu in una nuova scheda: la bozza salvata, servita dal runtime. Compare dopo il primo salvataggio dell'app.
Export codeApre 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.
PublishSalva 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) e user (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 modello claude-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.

IconaRiquadroChe cos'è
👤UsersChi usa l'app: come accede e i suoi ruoli.
☰MenuL'intestazione per i visitatori e il menu dell'app per gli utenti che hanno effettuato l'accesso, in ordine.
🏠Home page / PageUna pagina costruita con blocchi (/ per la home, /v/<key> per le altre). Fai doppio clic per aprire l'editor delle pagine.
📝FormI campi che l'utente compila; diventano l'obiettivo dell'agente.
🤖AgentUn agente dell'app. Le sue righe mostrano il modello (o la dimensione della squadra), se agisce sulla piattaforma e l'inizio delle sue istruzioni.
📄ViewUna pagina dell'app non costruita con blocchi: report, storico, tabella, schede, grafico, chat, approvazioni…
💳PricingCome pagano gli utenti: modalità, crediti gratuiti, pacchetti, piani. Compare quando il billing non è gratuito.
🗃App collectionRecord conservati dall'app. Compare quando una vista la legge o un agente la usa come strumento.
🐍Python slotCodice 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 jobUna pipeline di cui l'app legge il dataset.
⏱ScheduleEsegue 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.
👥TeamAgenti che lavorano insieme, in sequenza o come sciame.
⚡TriggerUn evento che avvia un agente, una squadra o un job di dati.
✋ApprovalUn punto di controllo umano e il ruolo che decide.
🧩Agent templateUn agente che gli utenti dell'app creano per sé.
🧠MemoryCiò che un agente ricorda di ogni utente.
📞ChannelDove 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.

FrecciaSignificato
Menu itemUna voce del menu dell'app che apre questa pagina (utenti che hanno effettuato l'accesso).
LinkUn pulsante o un link dell'intestazione che porta l'utente a questa pagina o sezione.
ContainsLa pagina mostra al suo interno questa vista (il modulo, l'ultimo report, la chat…).
Starts the agentL'invio del modulo esegue l'agente con l'obiettivo costruito dai campi. La sua etichetta mostra la prima riga dell'obiettivo e il prezzo.
WritesIl risultato dell'agente arriva in questa vista o raccolta.
Each messageOgni messaggio della chat è un'esecuzione di questo agente, con la conversazione fino a quel punto.
DataRighe o risultati in arrivo: un job di dati, una raccolta dell'app, una pianificazione.
Uses as a toolL'agente può chiamarlo mentre lavora: strumenti dell'app su una raccolta, uno slot Python, un server MCP esterno.
HelpsUn agente di supporto di quello principale.
PaysCome pagano gli utenti le esecuzioni.
UsesChe cosa fanno gli utenti: compilano il modulo, aprono il menu.
DelegatesL'agente affida a questo agente un sotto-compito (strumento ask_<agent>) e attende la sua risposta.
ThenNella sequenza di una squadra: questo passo viene eseguito dopo quello e riceve il suo output.
Emits an eventQui succede qualcosa (un record scritto, un acquisto, una decisione, una chiamata) e il trigger lo rileva.
StartsQuando l'evento si verifica, il trigger avvia questo agente, squadra o job di dati.
Waits for approvalL'agente chiede a una persona di decidere (strumento request_<approval>); la decisione fa riprendere il lavoro tramite un trigger.
Creates their ownOgni utente dell'app crea istanze di questo modello.
RemembersL'agente legge ciò che ricorda dell'utente a ogni compito e lo aggiorna (strumento remember).
Answers onLe 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.

PulsanteChe cosa aggiunge
+ AgentUn 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 fieldUn campo di testo chiamato field, field2…
+ OutputUna vista report stampabile, oppure una vista storico My runs se esiste già un report.
+ PageUna pagina con un blocco hero. La prima è la home page, visibile senza accedere.
+ PricingBilling a crediti come nell'app vuota, e una vista Credits se non ce n'è una.
+ DataUn job di dati con una pipeline di esempio. Disegnato tratteggiato.
+ PythonUno slot Python con un main(input) di esempio, limite di tempo di 3000 ms.
+ ScheduleEsegue l'agente principale ogni giorno alle 06:00 UTC (0 6 * * *), a nome dell'app.
+ TeamUna squadra in sequenza con i primi due agenti come passi.
+ TriggerUn trigger webhook che avvia l'agente principale.
+ ApprovalUn'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.
+ TemplateUn 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.
+ ChannelUn 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.

SelezioneChe cosa si apre
UsersLe impostazioni dell'app (come nella scheda App).
Menu, una freccia del menu o un link dell'intestazioneL'editor del menu: quali viste sono voci di menu e in che ordine, e l'intestazione per i visitatori.
FormI campi del modulo.
La freccia dal modulo a un agenteL'editor dell'obiettivo.
Agent o la sua memoriaLe impostazioni di quell'agente.
Un riquadro MCPLe impostazioni dell'agente che lo usa.
PricingLe impostazioni di billing.
View o paginaLe impostazioni di quella vista; per una pagina, Open page editor (apri editor della pagina).
Slot Python, pianificazione, squadra, trigger, approvazione, modello, canaleI rispettivi pannelli.
Data jobL'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:

BloccoUso
HeroTitolo, testo, pulsanti.
StepsNumerati 1 · 2 · 3.
CardsFunzionalità, fonti, piani.
TextMarkdown libero.
DataTabella, schede, numeri da una sorgente.
App viewIl modulo di esecuzione, lo storico, una tabella, la chat… dentro la pagina.
HTMLUn blocco personalizzato. Script, form e iframe vengono rimossi; gli stili inline restano.
Small printAvvertenze, 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:

SchedaChe cosa modifica
AppNome, 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.
FormI campi del modulo: nome, tipo, obbligatorio, etichetta, aiuto, opzioni.
DataRaccolte: 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.
AgentsOgni agente: chiave, ruolo, profilo, obiettivo, strumenti dell'app, server MCP esterni, modello, turni, budget, istruzioni.
ViewsOgni vista: chiave, tipo, ruoli, menu, titolo, sorgente dei dati e visualizzazione.
BillingStato dei pagamenti, modalità, crediti, pagamento per uso, pacchetti.
JSONL'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:

AzioneChe cosa fa
EditApre l'app in App Studio.
Open appApre l'indirizzo online (solo quando è pubblicata).
Export codeApre App Studio con il pannello di esportazione aperto.
DeleteSolo 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.