WebRobot
App Builder · pagine

Documentazione · App Builder

App Builder

Che cos'è l'App Builder

L'App Builder trasforma la descrizione di un'app in una web app funzionante che esegue agenti AI per i suoi utenti.

Tre parti lavorano insieme:

  • Il manifest. Un solo documento (kind: VerticalApp) descrive l'intera app: le pagine, il modulo che gli utenti compilano, i dati che conserva, i ruoli degli utenti, gli agenti, che cosa li avvia, chi approva il loro lavoro e come pagano gli utenti. Non c'è altro codice sorgente da scrivere.
  • Il runtime. Un unico web server condiviso e multi-tenant serve tutte le app pubblicate. Quando arriva una richiesta su <slug>.webrobot.eu, il runtime carica il manifest pubblicato di quell'app e lo visualizza. Non c'è una fase di build: una nuova versione è un nuovo manifest.
  • App Studio. L'editor visuale nel Cloud Dashboard (/dashboard/app-studio). Descrivi l'app a un co-pilot AI, esamini la sua proposta su un canvas, modifichi a mano qualsiasi parte e pubblichi.

Il canvas, i pannelli delle proprietà, la scheda JSON e il co-pilot modificano tutti lo stesso manifest.

Concetti principali

ConcettoChe cos'è
ManifestLa definizione dell'app (apiVersion: webrobot.eu/v1alpha1, kind: VerticalApp, metadata, spec). Vedi Il manifest.
SlugL'identificativo e l'indirizzo dell'app: da 3 a 40 caratteri, lettere minuscole, cifre e trattini, con una lettera all'inizio. Non cambia più una volta creata l'app.
BozzaIl manifest che stai modificando, salvato con Save draft (salva bozza). Una bozza può contenere errori; non è mai pubblica.
Versione pubblicataUna copia congelata della bozza, creata con Publish (pubblica). Ogni pubblicazione riceve il numero di versione successivo (v1, v2…). Gli utenti dell'app vedono sempre l'ultima versione pubblicata.
RuntimeIl server che visualizza le app pubblicate su <slug>.webrobot.eu (e sui tuoi domini) e le bozze su preview-<slug>.webrobot.eu. Vedi Il runtime.
AgentiGli esecutori AI dell'app, dichiarati in spec.agents. Nella bozza ogni agente porta con sé il proprio profilo (profile.inline). Alla pubblicazione ognuno diventa un profilo agente della tua organizzazione sulla piattaforma. Vedi Agenti e automazione.
Profilo agenteL'oggetto della piattaforma che esegue davvero un agente (modello, istruzioni, strumenti, budget). Il manifest pubblicato vi fa riferimento tramite id (profile.ref).
Modulospec.inputForm: i campi che un utente compila prima che un agente parta. L'obiettivo dell'agente viene costruito a partire da questi campi.
RaccolteI record che l'app conserva (spec.data.collections): prenotazioni, ordini, pratiche. Gli agenti e i moduli li scrivono, le viste li mostrano. Vedi Dati.
VisteLe pagine dell'app (spec.views): pagine costruite con blocchi, il modulo di esecuzione, lo storico, i report, le tabelle, i grafici, la chat, le approvazioni e altro. Vedi Viste e pagine.
TriggerEventi che avviano un agente, una squadra o un job di dati: un record scritto, un webhook, un acquisto, una decisione, un orario.
ApprovazioniPunti di controllo umani: un agente chiede, una persona con un certo ruolo approva o rifiuta e la decisione fa riprendere il lavoro.
BillingCome ti pagano gli utenti dell'app: gratis, crediti, abbonamento, per transazione. I pagamenti vanno all'account Stripe della tua organizzazione. Vedi Pagamenti e crediti.

Come si collegano: un utente accede (i ruoli vengono da spec.auth), apre una vista, compila il modulo o scrive un record. Questo avvia un agente, direttamente o tramite un trigger. L'agente lavora sulla piattaforma con il suo profilo, può usare le raccolte dell'app come strumenti, può fermarsi per un'approvazione e scrive il risultato in una vista o in una raccolta. Il billing decide quanto costa l'esecuzione all'utente.

Ciclo di vita di un'app

  1. Descrivi. Scrivi che cosa deve fare l'app nella casella in alto in App Studio.
  2. Progetta. Il co-pilot costruisce un manifest e lo mostra sul canvas come proposta.
  3. Rivedi. I riquadri nuovi sono verdi, quelli modificati color ambra. Premi Apply (applica) o Discard (scarta) sulla proposta, poi controlli i riquadri e li modifichi.
  4. Salva la bozza. Il manifest viene memorizzato per la tua organizzazione. Da questo momento lo slug è occupato.
  5. Anteprima. Open preview (apri anteprima) apre la bozza salvata su preview-<slug>.webrobot.eu. Nell'anteprima gli agenti non vengono eseguiti e i pagamenti sono disattivati.
  6. Pubblica. Gli agenti diventano profili agente della tua organizzazione, alla prima pubblicazione l'app riceve una sua chiave API e l'app va online su <slug>.webrobot.eu. Vedi Pubblicazione.
  7. Usa. Gli utenti accedono, eseguono gli agenti, pagano. Se l'app ha una vista admin, i suoi amministratori vi trovano gli utenti, i saldi, le ricariche di crediti e le ultime esecuzioni.
  8. Modifica. Descrivi una modifica al co-pilot (Propose change, proponi modifica) o modifica i riquadri, poi salva.
  9. Ripubblica. Vengono aggiornati gli stessi profili agente, il numero di versione sale e i dati dell'app restano.
  10. Esporta. Se vuoi, Export code (esporta codice) mette il codice dell'app nel tuo repository GitHub, con le shell per Android e iPhone se le richiedi. Vedi Esportazione su GitHub e telefoni.

Che cosa puoi e non puoi fare

Puoi:

  • descrivere un'app in linguaggio comune e ottenere un manifest completo in pochi minuti;
  • modificare ogni parte in modo visuale, oppure modificare l'intero manifest come JSON;
  • eseguire più agenti per app, in squadre, con trigger, approvazioni, pianificazioni e memoria;
  • conservare record in raccolte e mostrarli come tabelle, schede, grafici, elenchi, mappe e prenotazioni;
  • aggiungere funzioni Python tue che girano in una sandbox (senza rete, senza file);
  • farti pagare dagli utenti con crediti, piani o per transazione, tramite il tuo account Stripe;
  • servire l'app sui tuoi domini;
  • esportare il codice su GitHub e costruire da esso app Android e iPhone.

Non ancora disponibile:

  • Gli agenti non vengono eseguiti nell'anteprima. Pubblica per provare un'esecuzione reale.
  • I job di dati (spec.data.jobs) vengono creati come pipeline sulla piattaforma alla pubblicazione, ma il runtime non li esegue.
  • I canali diversi da web (telefono, Telegram, email) restano nel manifest ma non sono ancora collegati.
  • Alcune funzionalità del telefono non possono ancora essere usate da nessuna parte di un'app (contatti, Bluetooth, posizione in background, promemoria sul telefono, riconoscimento vocale). Vedi Esportazione su GitHub e telefoni.

Mappa della documentazione

PaginaChe cosa tratta
PanoramicaQuesta pagina: che cos'è l'App Builder, i suoi concetti e il ciclo di vita.
Guida rapidaDa una descrizione a un'app online in App Studio, passo per passo.
App StudioL'editor completo: co-pilot, canvas, inspector, editor delle pagine, impostazioni, anteprima, elenco delle app.
Il manifestLa struttura di un manifest VerticalApp e come si combinano le sue parti.
Accesso e ruoliCome accedono gli utenti, i ruoli, che cosa possono vedere i visitatori anonimi.
DatiRaccolte, record, a chi appartengono, conservazione, file.
Viste e pagineTutti i tipi di vista, le pagine costruite con blocchi, il menu e l'intestazione.
Agenti e automazioneAgenti, obiettivi, strumenti, squadre, trigger, approvazioni, pianificazioni, modelli, memoria, slot Python.
MessaggiLe email e le notifiche che l'app invia, e i canali.
Pagamenti e creditiCrediti, pacchetti, piani, pagamento per uso, pagamenti con Stripe Connect.
PubblicazioneBozze, anteprima, che cosa fa Publish, indirizzi, domini personalizzati, ripubblicazione, eliminazione.
Esportazione su GitHub e telefoniL'esportazione su GitHub, il codice web, le build Android e iPhone.
Il runtimeCome il runtime condiviso serve le app e che cosa fa per loro.
ValidazioneErrori e avvisi, che cosa blocca la pubblicazione e come correggerlo.
RiferimentoTutti i campi del manifest, generati dallo JSON Schema.

Per un'introduzione guidata alla scrittura dei manifest, segui il tutorial su webrobot.eu/learn/manifest.