Connetti e gestisci le Integrazioni
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 non collegato potrebbe 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 ne hai bisogno.
| Obiettivo | Esempi |
|---|---|
| Fornire contesto all'Agente mentre crei | Trovare file, riassumere attività, esaminare problemi o usare dati di progetto in un prompt |
| Consentire all'Agente di agire in un altro servizio | Creare un'attività, aggiornare un record, aggiungere dati a un foglio di calcolo o creare un evento di calendario |
| Aggiungere un servizio all'app pubblicata | Archiviare dati dell'applicazione, gestire l'autenticazione, elaborare pagamenti o eseguire 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 Settings → Connectors per usare il punto di accesso principale. Puoi anche selezionare Connect your tools to Atoms dalla dashboard.
Collegare o scollegare 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
- Apri la dashboard di Atoms.
- Seleziona Connect your tools to Atoms.
- Scegli il connettore che vuoi usare. Segui il controllo di connessione mostrato sulla scheda di quel connettore.
- 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.
- Accedi al servizio esterno, se richiesto.
- Esamina l'account e le autorizzazioni, quindi approva la connessione.
- 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 data di scadenza, un proprietario, uno stato o una priorità
- Cosa vuoi che Atoms legga, riassuma, crei o aggiorni
Per esempio:
- “Riassumi i problemi Linear ad alta priorità 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à effettuate.
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 consegna | GitHub, Linear |
| Backend e dati | Database, autenticazione, archiviazione e dati strutturati | Supabase |
| Pagamenti | Checkout, fatturazione e flussi di pagamento | Stripe |
| Gestione del lavoro | Attività, progetti, proprietari e date di scadenza | Asana, Todoist |
| File e contenuti | Cercare, leggere e organizzare file esterni | Box, Dropbox |
| Analisi e marketing | Traffico, rendimento della 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:
Per problemi di connessione, vedi Risoluzione dei problemi di Integrazione.