WebRobot
App Builder · pagine

Documentazione · App Builder

Guida rapida

Prima di iniziare

  • Ti serve un account nel Cloud Dashboard con il ruolo developer o admin. Il ruolo viewer vede un avviso di sola lettura al posto di App Studio.
  • La prima pubblicazione di un'app crea la sua chiave API e la memorizza come credenziale della tua organizzazione. Per questo serve un admin dell'organizzazione. Dopo, un developer può pubblicare gli aggiornamenti.
  • Per far pagare i tuoi utenti, un amministratore collega un account Stripe (vedi Pagamenti e crediti). Puoi pubblicare anche senza: in quel caso l'app mostra che i pagamenti non sono ancora attivi.

Apri App Studio su /dashboard/app-studio.

Un esempio reale

Con questi passi abbiamo costruito un'app di prenotazione e pre-visita per uno studio di fisioterapia. La proposta del co-pilot è arrivata circa 2 minuti dopo l'invio della descrizione, e l'app era online circa 2,5 minuti dopo l'invio. Sull'app online, dopo la richiesta di un paziente, l'agente in background ha scritto il riepilogo pre-visita e ha chiesto l'approvazione dello studio in 28 secondi.

Una progettazione richiede di solito da 1 a 3 minuti: di più per un'app più grande, con più agenti, raccolte e approvazioni, e quando il co-pilot fa un secondo passaggio per correggere la sua prima proposta.

Passo 1: descrivi l'app

Su un'app nuova, in alto nella pagina si legge Describe your app. The co-pilot builds it. La casella di testo mostra il segnaposto Describe your app — e.g. “a valuation report for real-estate agents, paid with credits”.

Scrivi la tua descrizione, oppure fai clic su una delle tre schede sotto Start from an example (parti da un esempio) (Property valuation report, Supplier due-diligence, Trip planner); poi Use this → mette il suo testo nella casella.

Ecco il tipo di descrizione che funziona bene:

Un'app per uno studio di fisioterapia. I pazienti accedono, prenotano una prima visita tra gli orari liberi (45 minuti, dal lunedì al venerdì, 9:00–18:00) e compilano un modulo di accettazione: la zona che fa male, da quando, dolore da 0 a 10, trattamenti precedenti, e possono caricare un referto medico. Un agente in background legge il modulo e il referto e scrive un riepilogo pre-visita per il fisioterapista: problemi probabili, domande da fare, segnali d'allarme. Il riepilogo deve essere approvato dal personale dello studio prima di essere allegato alla prenotazione; i pazienti non lo vedono mai. Il personale vede tutte le prenotazioni in una tabella e i riepiloghi in attesa di approvazione. I pazienti vedono le proprie prenotazioni. La prima visita si paga per prenotazione. Italiano e inglese.

Poi premi Design the app (progetta l'app) o Invio.

Che cosa deve sapere il co-pilot

Scrivi la descrizione come se stessi dando istruzioni a una persona. Copri questi punti:

PuntoPerché contaEsempio
Chi la usaDiventa i ruoli e chi vede quale pagina."pazienti" e "personale dello studio"
Che cosa inserisconoDiventa i campi del modulo e i loro tipi."dolore da 0 a 10", "caricare un referto medico"
Che cosa restituisce l'agenteDiventa le istruzioni dell'agente e dove va il risultato."un riepilogo pre-visita: problemi probabili, domande da fare, segnali d'allarme"
Che cosa conservaDiventa le raccolte."prenotazioni", "riepiloghi"
Chi approvaDiventa un'approvazione e una pagina delle approvazioni per quel ruolo."approvato dal personale dello studio"
Che cosa avvia il lavoroInvio del modulo, un record scritto, una pianificazione."quando viene fatta una prenotazione"
Come paganoDiventa la sezione billing."si paga per prenotazione", "crediti", "gratis"
LingueDiventa metadata.langs."italiano e inglese"

Indica anche che cosa gli utenti non devono vedere ("i pazienti non lo vedono mai"): diventa le regole delle viste e dei record.

Passo 2: attendi la proposta

Il pulsante mostra Designing… e la riga The co-pilot is designing the app (usually 1–3 minutes). You can leave the page: the proposal waits for you. Il co-pilot lavora in background. Se ricarichi la pagina o torni entro 30 minuti, App Studio riprende la stessa esecuzione.

Al posto di una proposta possono succedere due cose:

  • Se la prima proposta ha errori (non supera la validazione) o avvisi di progettazione, App Studio la rimanda al co-pilot con l'elenco e mostra The proposal had N problem(s): the co-pilot is fixing them…. Questo secondo passaggio avviene una volta sola.
  • Se il co-pilot ha bisogno di informazioni, mostra The co-pilot asks: seguito dalla sua domanda. Aggiungi la risposta alla tua descrizione e premi di nuovo il pulsante.

Passo 3: rivedi e applica

Il canvas mostra la proposta, con una barra sopra: The canvas shows the proposal: <app name>. I riquadri nuovi hanno un bordo verde e un badge new, quelli modificati un bordo ambra e un badge changed. I riquadri che la proposta eliminerebbe sono elencati dopo would remove:.

  • Apply rende la proposta la tua app. Il messaggio dice Proposal applied — click the boxes to review, then Save draft. Un'app nuova prende lo slug proposto dal co-pilot. L'indirizzo ora compare nel pannello a destra, per esempio https://<slug>.webrobot.eu.
  • Discard la scarta.

Non è ancora salvato nulla. Fai clic sui riquadri per controllarli:

  • il riquadro Form: i campi e quali sono obbligatori;
  • ogni riquadro Agent: le istruzioni (system prompt), il modello, i turni e il budget per esecuzione;
  • la freccia dal modulo all'agente: l'obiettivo, il testo che l'agente riceve a ogni esecuzione;
  • il riquadro Pricing: come pagano gli utenti;
  • ogni riquadro Approval: quale ruolo decide e che cosa succede allo scadere del tempo.

La colonna di destra mostra il riquadro selezionato sotto What the user sees (quello che vede l'utente), con i colori dell'app.

Passo 4: salva la bozza

Premi Save draft. Il messaggio dice Draft saved., oppure Draft saved — fix the problems before publishing. se il pannello a destra elenca errori in rosso. Una bozza con errori viene comunque salvata, così non perdi mai il lavoro. Vedi Validazione.

Dopo il primo salvataggio lo slug appartiene alla tua organizzazione e l'indirizzo di anteprima esiste.

Passo 5: apri l'anteprima

Premi Open preview. Apre https://preview-<slug>.webrobot.eu in una nuova scheda: la bozza salvata, servita dal runtime, con una barra Preview — draft not yet published.

L'anteprima non è pubblica: accedi come amministratore dell'app. Nell'anteprima gli agenti non vengono eseguiti (un'esecuzione risponde che l'agente ha un profilo inline e che l'app va prima pubblicata), i pagamenti sono disattivati e i dati inseriti lì restano separati da quelli dell'app online.

Passo 6: pubblica

Premi Publish. È disattivato finché la bozza ha errori (il suo tooltip dice Fix the problems first). Se hai modifiche non salvate, App Studio prima le salva.

Il pulsante mostra Publishing…. Al termine il messaggio dice Published v1 — live on https://<slug>.webrobot.eu. Lo stato in alto nella pagina passa da draft a published v1.

Se un passaggio fallisce, il messaggio ne riporta il nome, per esempio api key: …. Vedi Pubblicazione.

Passo 7: prova l'app online

Apri l'indirizzo. Accedi con la tua email: l'app invia un messaggio con un link di accesso e un codice di 6 cifre. Fai una prenotazione o compila il modulo e guarda arrivare il risultato dell'agente. Per un'app con approvazioni, accedi come persona con il ruolo che approva e apri la pagina delle approvazioni.

Modificarla in seguito

Apri l'app dal selettore in alto (Open an app…) o da All apps (tutte le app). Il titolo diventa Describe a change. The co-pilot redesigns your app. e il pulsante Propose change. Descrivi la modifica, per esempio aggiungi una visita di controllo di 30 minuti e chiedi la data dell'infortunio. La proposta mostra solo ciò che cambia. Applicala, salva e pubblica di nuovo: il numero di versione sale e i dati dell'app restano.

Passi successivi