Usa la sezione AI di Atoms Cloud per scegliere un modello di IA, usarlo nella tua app e controllare l'utilizzo dell'IA dell'app.

Questa pagina spiega le funzionalità IA con cui gli utenti interagiscono all'interno della tua app. Atoms Cloud fornisce la libreria dei modelli e le informazioni sull'utilizzo del progetto, mentre Atoms Agent in Chat crea e aggiorna tali funzionalità.

Comprendere l'IA in Atoms Cloud

Apri il progetto nella versione desktop di Atoms e assicurati che sia in modalità Web. AI Library contiene i modelli attualmente disponibili per il progetto, mentre AI Usage mostra l'utilizzo dei crediti del progetto e i modelli attivi.

Se Atoms Cloud non è connesso o AI non è disponibile, chiedi all'Agente di connettere Atoms Cloud oppure segui Atoms Cloud prima di continuare.

Apri AI Library in Atoms Cloud

1. Nella stessa barra degli strumenti dello spazio di lavoro in cui si trova Visualizzatore App , seleziona Atoms Cloud.
2. Nella barra laterale, seleziona AI.
3. Apri AI Library.

AI Library mostra i modelli attualmente disponibili per il tuo progetto. Puoi sfogliare i filtri per categoria oppure usare Search per trovare un modello adatto.

La libreria può cambiare nel tempo. Usa i modelli e le informazioni mostrati lì invece di fare affidamento su un elenco meno recente di modelli o provider.

Aggiungi un modello alla tua richiesta

1. Trova un modello in AI Library.
2. Seleziona # Add sulla sua scheda. Atoms inserisce il tag del modello nel messaggio Chat corrente.
3. Completa la richiesta della funzionalità dopo il tag, quindi invia il messaggio a Atoms Agent.

Seleziona # Add per indicare all'Agente quale modello di IA vuoi usare. Il modello appare come tag nel tuo messaggio Chat. Puoi quindi descrivere ciò che vuoi che l'Agente crei o modifichi.

Puoi anche allegare un modello direttamente da Chat: digita #, seleziona AI, quindi scegli uno dei modelli attualmente disponibili.

Seleziona # Add per inserire un tag del modello nella tua richiesta Chat.

Descrivi chiaramente la funzionalità

Dopo aver allegato un modello, spiega all'Agente come vuoi che la funzionalità funzioni dal punto di vista dell'utente. Includi i seguenti dettagli:

Cosa descrivere	Cosa dire all'Agente
Scopo	Spiega cosa la funzionalità dovrebbe aiutare gli utenti a realizzare.
Percorso utente	Descrivi cosa gli utenti inseriranno, caricheranno o selezioneranno e dove dovrebbero vedere il risultato.
Informazioni utilizzate	Specifica quali informazioni l'IA dovrebbe usare e tutto ciò che non deve includere.
Risultato previsto	Descrivi il formato, il tono, la lingua, la lunghezza preferiti ed eventuali limiti importanti.
Caricamento ed errori	Spiega cosa gli utenti dovrebbero vedere durante l'attesa, quando mancano informazioni o non sono valide e se una richiesta non va a buon fine.

Non è necessario spiegare come la funzionalità debba essere codificata. Concentrati su ciò che fanno gli utenti, sul risultato che dovrebbero ricevere e su come l'app dovrebbe rispondere in ogni fase.

Il layout generato può variare tra i progetti. Verifica il comportamento che hai richiesto invece di aspettarti che ogni app usi lo stesso design.

Il modello di IA selezionato appare come tag nel compositore Chat.

Testa la funzionalità in Visualizzatore App

Dopo che l'Agente ha terminato, testa l'intero percorso utente in Visualizzatore App. Usa contenuti di esempio innocui che non contengano informazioni personali o sensibili.

Test	Cosa fare	Risultato previsto
Input normale	Invia un esempio tipico che la funzionalità è progettata per gestire.	L'output richiesto appare nel punto e nel formato corretti.
Input vuoto	Prova a continuare senza fornire il contenuto richiesto.	L'app spiega cosa deve fornire l'utente e non invia una richiesta non necessaria.
Input non valido	Fornisci contenuti in un formato non supportato o al di fuori dei requisiti previsti della funzionalità.	L'app rimane utilizzabile e mostra una spiegazione chiara del problema.
Stato di caricamento	Invia una richiesta e osserva l'app mentre viene elaborata.	L'app mostra che la richiesta è in corso e impedisce invii duplicati accidentali.
Risposta non riuscita	Se una richiesta non va a buon fine durante il normale test, controlla come risponde l'app.	L'app mostra un messaggio utile, consente all'utente di riprovare e non espone dettagli tecnici o informazioni private.

Non usare deliberatamente dati sensibili, non consumare tutti i crediti disponibili e non interrompere il servizio per creare un errore. Se non puoi riprodurre in sicurezza una risposta lenta o non riuscita, spiega invece all'Agente come l'app dovrebbe gestire quella situazione.

Controlla l'utilizzo dell'IA in Atoms Cloud

1. Torna a Atoms Cloud → AI.
2. Apri AI Usage.
3. In Overview, controlla Total Crediti Used e Active Models per questo progetto.
4. Controlla i modelli elencati in Active Models.

AI Usage mostra una panoramica a livello di progetto. Per il saldo del wallet, la ricarica e dettagli più ampi sull'utilizzo di Cloud o IA, vedi Cloud & AI Wallet.

Per controllare i crediti usati da una specifica risposta dell'Agente, seleziona ... sotto quella risposta, quindi controlla Crediti used. Questo valore a livello di messaggio è separato dalla panoramica del progetto in AI Usage.

Apri il menu del messaggio per controllare i crediti usati da quella risposta dell'Agente.

Screenshot da aggiungere: AI Usage in un progetto di test pulito, che mostri Overview, Total Crediti Used e Active Models. Evidenzia la scheda AI Usage in arancione. Mantieni visibile il nome di un modello attuale in modo che l'elenco sia comprensibile, ma maschera i dettagli dell'account, le informazioni dello spazio di lavoro ed eventuali informazioni sul saldo non necessarie. Didascalia: “Apri AI Usage per controllare l'utilizzo dei crediti del progetto e i modelli attivi.” Testo alternativo: “Scheda AI Usage che mostra i crediti del progetto usati e i modelli attivi.”

Proteggi i dati utente e le credenziali

I contenuti inviati tramite una funzionalità IA possono essere inviati al provider del modello selezionato per l'elaborazione. Invia solo le informazioni necessarie per completare la richiesta.

Non inviare mai password, chiavi API, token di accesso o informazioni personali o riservate non necessarie. Assicurati che gli utenti capiscano quando i loro contenuti vengono inviati a un modello di IA e segui i requisiti della tua organizzazione in materia di privacy e gestione dei dati.

Controlla sempre i risultati generati dall'IA prima di farvi affidamento per decisioni importanti. Consulta Atoms Terms of Service per maggiori informazioni.

Se la tua app ha bisogno di una credenziale privata da un provider esterno, archiviala usando Chiavi and secrets. Non incollare mai la credenziale in Chat e non includerla nel codice eseguito nel browser.