Usa l'IA nella tua 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 queste funzionalità.

Comprendere l'IA in Atoms Cloud

Apri il progetto nella versione desktop di Atoms e assicurati che sia in modalità Web. La 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 consulta Atoms Cloud prima di continuare.

Apri la AI Library in Atoms Cloud

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

La AI Library mostra i modelli attualmente disponibili per il tuo progetto. Puoi esplorare 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 un 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à operi dal punto di vista dell'utente. Includi i seguenti dettagli:

Cosa descrivere	Cosa dire all'Agente
Scopo	Spiega cosa dovrebbe aiutare gli utenti a realizzare la funzionalità.
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 cosa non deve includere.
Risultato previsto	Descrivi il formato, il tono, la lingua, la lunghezza preferiti e qualsiasi limite importante.
Caricamento ed errori	Spiega cosa dovrebbero vedere gli utenti 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 da un progetto all'altro. Verifica il comportamento che hai richiesto invece di aspettarti che ogni app usi lo stesso design.

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

Testa la funzionalità nel Visualizzatore App

Dopo che l'Agente ha terminato, testa l'intero percorso utente nel App Viewer. 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 posto 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 generare 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, consulta Cloud & AI Wallet.

Per controllare i crediti usati da una risposta specifica 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 un nome di modello attuale in modo che l'elenco sia comprensibile, ma maschera i dettagli dell'account, le informazioni dello spazio di lavoro e qualsiasi informazione sul saldo non necessaria. 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 utilizzati e i modelli attivi.”

Proteggi i dati utente e le credenziali

I contenuti inviati tramite una funzionalità IA possono essere trasmessi 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 richiede 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.