Le Integrazioni collegano Atoms agli strumenti e ai servizi che usi già. A seconda del connettore, Atoms può usare informazioni esterne mentre ti aiuta a creare, aggiungere funzionalità alla tua app pubblicata o supportare entrambi i flussi di lavoro.

Ogni connettore supporta azioni e autorizzazioni proprie. Esamina le funzionalità e l'ambito delle autorizzazioni mostrati per il connettore collegato; un pannello dei dettagli di un connettore non collegato può mostrare solo la sua descrizione e il controllo di connessione.

Usa l'account con i privilegi minimi e l'ambito di autorizzazioni minimo che possono completare il lavoro. Non incollare password, token di accesso, chiavi private o dati sensibili non correlati in un prompt. Quando un servizio contiene dati di produzione o dei clienti, testa con un campione non sensibile e verifica la destinazione esatta prima di consentire una scrittura.

I connettori e le azioni che vedi possono variare in base all'account e alla release. Apri il catalogo dei connettori in Atoms per vedere cosa è attualmente disponibile per te.

Decidi cosa deve fare la connessione

Prima di collegare un servizio, decidi dove ti serve.

Obiettivo	Esempi
Fornisci contesto all'Agente mentre crei	Trova file, riassumi attività, esamina problemi o usa i dati del progetto in un prompt
Consenti all'Agente di eseguire azioni in un altro servizio	Crea un'attività, aggiorna un record, aggiungi dati a un foglio di calcolo o crea un evento di calendario
Aggiungi un servizio all'app pubblicata	Archivia i dati dell'applicazione, gestisci l'autenticazione, elabora i pagamenti o esegui un flusso di lavoro dell'app

Alcuni connettori supportano più di un obiettivo. Esamina la descrizione del connettore e le autorizzazioni richieste prima di collegarlo.

Collega un'Integrazione

Apri Impostazioni → Connettori per usare il punto di accesso principale. Puoi anche selezionare Collega i tuoi strumenti ad Atoms dalla dashboard.

Il collegamento o lo scollegamento di un'Integrazione può richiedere l'accesso del proprietario dello Spazio di lavoro o di un amministratore autorizzato. Se non sei un proprietario o un amministratore e un controllo non è disponibile, chiedi al proprietario dello Spazio di lavoro o a un amministratore autorizzato.

Dalla dashboard

1. Apri la dashboard di Atoms.
2. Seleziona Collega i tuoi strumenti ad Atoms.
3. Scegli il connettore che vuoi usare. Segui il controllo di connessione mostrato sulla scheda di quel connettore.
4. Usa il controllo mostrato per quel connettore. Se apre un pannello dei dettagli generico, seleziona Connect; le Integrazioni specifiche del provider possono aprire il proprio flusso di configurazione o autorizzazione.
5. Accedi al servizio esterno se richiesto.
6. Esamina l'account e le autorizzazioni, quindi approva la connessione.
7. Torna in Atoms e conferma che il connettore risulti collegato. Nella Chat in cui vuoi usarlo, apri il selettore dei connettori e abilita il connettore per quella Chat.

Usa un'Integrazione collegata

Indica all'Agente quale servizio usare e includi dettagli sufficienti per identificare l'elemento corretto. I dettagli utili includono:

• Il nome del progetto, dello spazio di lavoro, del repository, della cartella, del calendario o del foglio di calcolo
• Il nome di un'attività, l'ID di un problema, il nome di un file o l'identificatore di un record
• Un intervallo di date, una scadenza, un proprietario, uno stato o una priorità
• Cosa vuoi che Atoms legga, riassuma, crei o aggiorni

Per esempio:

• “Riassumi i problemi ad alta priorità di Linear assegnati a me.”
• “Trova il brief di lancio in Drive ed elenca le decisioni aperte.”
• “Aggiungi questi lead approvati al foglio di calcolo della campagna.”
• “Crea un evento di calendario per la revisione del design il prossimo martedì alle 15:00.”

Atoms può usare solo le azioni supportate dal connettore e i dati disponibili per l'account collegato. Se la funzionalità o l'azione di cui hai bisogno non è mostrata per quel connettore, fermati e non dare per scontato che sia supportata.

Esamina le modifiche esterne prima che vengano eseguite

Quando un connettore e un'azione supportano la creazione o l'aggiornamento di dati esterni, Atoms può mostrare una conferma prima di eseguirla.

Esamina:

• Il servizio e l'account collegato
• Il file, foglio di calcolo, calendario, progetto o record di destinazione
• Le informazioni che verranno create o modificate
• Qualsiasi data, ora, destinatario o altro valore importante

Se Atoms mostra una conferma, esaminala e seleziona Confirm per continuare oppure annulla per lasciare invariato il servizio esterno. La disponibilità della scrittura dipende dal connettore e dall'azione; i connettori di sola lettura non offrono azioni di scrittura.

Dopo una scrittura, verifica il risultato nel servizio esterno prima di riprovare. Se la destinazione o i valori sono errati, interrompi il flusso di lavoro e usa gli strumenti di cronologia, annullamento o ripristino del provider quando disponibili. Scollegare un connettore ne interrompe l'uso futuro; non annulla le modifiche già apportate.

Gestisci una connessione

Apri il catalogo dei connettori e seleziona un servizio collegato per esaminarne lo stato attuale.

Dal pannello dei dettagli del connettore, potresti essere in grado di:

• Controllare quale account è collegato
• Esaminare le azioni supportate dal connettore e l'ambito delle autorizzazioni
• Ricollegarti quando l'autorizzazione è scaduta
• Aggiornare o modificare l'accesso quando il servizio lo supporta
• Scollegare l'account da Atoms

Scollegare in Atoms interrompe l'uso futuro della connessione. Alcuni servizi potrebbero anche richiedere di revocare Atoms dalle impostazioni dell'account o di sicurezza del servizio stesso.

Esempi per caso d'uso

La tabella seguente è un raggruppamento editoriale per caso d'uso, non un insieme di categorie del catalogo. Usa il catalogo ricercabile per l'elenco aggiornato dei connettori disponibili.

Categoria	Usi comuni	Esempi
Sviluppo	Controllo del codice sorgente, repository, problemi e flussi di lavoro di delivery	GitHub, Linear
Backend e dati	Database, autenticazione, archiviazione e dati strutturati	Supabase
Pagamenti	Checkout, fatturazione e flussi di lavoro di pagamento	Stripe
Gestione del lavoro	Attività, progetti, proprietari e scadenze	Asana, Todoist
File e contenuti	Cerca, leggi e organizza file esterni	Box, Dropbox
Analisi e marketing	Traffico, performance di ricerca, campagne e reportistica	Google Analytics 4, Google Search Console, Google Ads

La disponibilità dei connettori cambia nel tempo. Usa il catalogo in Atoms per l'elenco aggiornato e apri un connettore per esaminarne le funzionalità esatte.

Guide di configurazione

Scegli la guida per il tuo servizio:

• Collega GitHub
• Collega Supabase
• Collega GA4
• Collega Google Search Console
• Collega Google Ads

Per problemi di connessione, vedi Risoluzione dei problemi di Integrazione.