Sfoglia la documentazione
Getting started

Avvio rapido

Collega uno store Shopify e ricevi il tuo primo audit. Cinque passi, nessun file di configurazione, nessun codice.

Questo ti porta da un account a freddo a un team di IA che legge i dati reali del tuo store. Nulla di tutto ciò richiede codice.

1. Creare un account

Accedi su /auth. L'autenticazione avviene tramite un codice a sei cifre inviato via email: non c'è una password da scegliere né un magic link da cliccare. Il codice è l'unica via di accesso.

2. Creare un'organizzazione

Un'organizzazione possiede store, fatturazione e membri. Tutto il resto dipende da essa:

  • Gli store appartengono a un'organizzazione, mai a un utente.
  • I crediti sono condivisi per organizzazione, non per posto.
  • I membri portano un ruolo: owner, admin, member o viewer.

3. Collegare uno store Shopify

Due percorsi, e quello che scegli decide cosa può toccare l'IA:

| Percorso | Cos'è | Quando | |---|---|---| | App OAuth | Il flusso standard di installazione Shopify. Gli scope sono approvati sulla schermata di consenso propria di Shopify. | La maggior parte degli store. | | Custom App | Generi un token API Admin nel tuo pannello Shopify e lo incolli. | Quando servono scope che l'app pubblica non richiede. |

Gli scope che approvi sono un tetto rigido. Nessun agente, strumento o livello di autonomia può superarlo: se l'IA non ha mai ottenuto read_orders, nessuna quantità di autonomia rende leggibili i dati degli ordini.

4. Lasciare che l'audit giri

Alla connessione, la piattaforma legge il catalogo, il tema, le pagine di contenuto e tutto ciò che i tuoi scope permettono in analytics. Il primo passaggio produce riscontri, non modifiche, qualunque sia il tuo livello di autonomia.

5. Chiedere

La chat è l'interfaccia. Rivolgiti direttamente all'orchestratore:

@Atlas controlla i miei titoli prodotto per il SEO e dimmi i
tre casi peggiori.

Oppure rivolgiti a uno specialista per nome quando sai già chi possiede la domanda — @Maya per il marketing, @Marco per il merchandising. L'elenco completo è in Il team IA.

Quanto costa

Ogni chiamata al modello è misurata contro il tuo saldo di crediti. Due salvaguardie stanno davanti, ed entrambe sono rigide:

  • Una richiesta il cui costo stimato supera il tuo saldo viene rifiutata con 402 prima che venga trasmesso un solo token.
  • Una richiesta che raggiunge il tuo saldo a metà dello streaming viene interrotta, mai lasciata sforare.

Dettagli in Crediti e misurazione.

Prossimi passi

Hai costruito con queste docs?

Passa dal forum se qualcosa non è chiaro o è sbagliato. La documentazione migliora più in fretta quando chi legge segnala le lacune.

Apri il forum