Integraties verbinden en beheren
Integraties verbinden Atoms met de tools en services die je al gebruikt. Afhankelijk van de connector kan Atoms externe informatie gebruiken terwijl het je helpt bij het bouwen, mogelijkheden toevoegt aan je gepubliceerde app, of beide workflows ondersteunt.
Elke connector ondersteunt zijn eigen acties en machtigingen. Bekijk de mogelijkheden en het machtigingsbereik dat wordt getoond voor de verbonden connector; een niet-verbonden detailpaneel toont mogelijk alleen de beschrijving en verbindingsoptie.
Gebruik het account en het machtigingsbereik met de minste rechten die de taak kunnen voltooien. Plak geen wachtwoorden, toegangstokens, privésleutels of niet-gerelateerde gevoelige gegevens in een prompt. Wanneer een service productie- of klantgegevens bevat, test dan met een niet-gevoelig voorbeeld en controleer het exacte doel voordat je schrijven toestaat.
De connectors en acties die je ziet, kunnen per account en release verschillen. Open de Connector-catalogus in Atoms om te bekijken wat momenteel voor jou beschikbaar is.
Bepaal wat de verbinding moet doen
Bepaal voordat je een service verbindt waar je die nodig hebt.
| Doel | Voorbeelden |
|---|---|
| Geef de Agent context terwijl je bouwt | Bestanden vinden, taken samenvatten, problemen beoordelen of projectgegevens in een prompt gebruiken |
| Laat de Agent actie ondernemen in een andere service | Een taak maken, een record bijwerken, spreadsheetgegevens toevoegen of een agenda-afspraak maken |
| Voeg een service toe aan de gepubliceerde app | Applicatiegegevens opslaan, authenticatie afhandelen, betalingen verwerken of een app-workflow uitvoeren |
Sommige connectors ondersteunen meer dan één doel. Bekijk de beschrijving van de connector en de gevraagde machtigingen voordat je deze verbindt.
Verbind een Integratie
Open Settings → Connectors om het primaire toegangspunt te gebruiken. Je kunt ook Verbind je tools met Atoms selecteren vanuit het dashboard.
Het verbinden of verbreken van een Integratie kan toegang als werkruimte-eigenaar of geautoriseerde admin vereisen. Als je geen eigenaar of admin bent en een optie niet beschikbaar is, vraag het dan aan de werkruimte-eigenaar of een geautoriseerde admin.
Vanuit het dashboard
- Open het Atoms-dashboard.
- Selecteer Verbind je tools met Atoms.
- Kies de connector die je wilt gebruiken. Volg de verbindingsoptie die op die connectorkaart wordt getoond.
- Gebruik de optie die voor die connector wordt getoond. Als deze een algemeen detailpaneel opent, selecteer dan Connect; providerspecifieke integraties kunnen hun eigen installatie- of autorisatiestroom openen.
- Meld je aan bij de externe service als daarom wordt gevraagd.
- Controleer het account en de machtigingen en keur daarna de verbinding goed.
- Ga terug naar Atoms en bevestig dat de connector als verbonden wordt weergegeven. Open in de Chat waar je deze wilt gebruiken de connector-kiezer en schakel de connector in voor die Chat.
Gebruik een verbonden Integratie
Vertel de Agent welke service moet worden gebruikt en geef voldoende details om het juiste item te identificeren. Nuttige details zijn onder andere:
- De naam van het project, de werkruimte, repository, map, agenda of spreadsheet
- Een taaknaam, probleem-ID, bestandsnaam of record-ID
- Een datumbereik, vervaldatum, eigenaar, status of prioriteit
- Wat je wilt dat Atoms leest, samenvat, maakt of bijwerkt
Bijvoorbeeld:
- “Vat de Linear-problemen met hoge prioriteit samen die aan mij zijn toegewezen.”
- “Zoek de launch brief in Drive en geef een lijst van de openstaande beslissingen.”
- “Voeg deze goedgekeurde leads toe aan de campagnespreadsheet.”
- “Maak een agenda-afspraak voor de design review volgende dinsdag om 15:00 uur.”
Atoms kan alleen acties gebruiken die door de connector worden ondersteund en gegevens die beschikbaar zijn voor het verbonden account. Als de mogelijkheid of actie die je nodig hebt niet voor die connector wordt getoond, stop dan en ga er niet van uit dat deze wordt ondersteund.
Controleer externe wijzigingen voordat ze worden uitgevoerd
Wanneer een connector en actie het maken of bijwerken van externe gegevens ondersteunen, kan Atoms een bevestiging tonen voordat deze wordt uitgevoerd.
Controleer:
- De service en het verbonden account
- Het doelbestand, de spreadsheet, agenda, het project of record
- De informatie die zal worden gemaakt of gewijzigd
- Elke datum, tijd, ontvanger of andere belangrijke waarde
Als Atoms een bevestiging toont, controleer deze dan en selecteer Confirm om door te gaan of annuleer om de externe service ongewijzigd te laten. Beschikbaarheid voor schrijven hangt af van de connector en actie; alleen-lezen-connectors bieden geen schrijfacties.
Controleer na een schrijfactie het resultaat in de externe service voordat je het opnieuw probeert. Als het doel of de waarden onjuist zijn, stop dan de workflow en gebruik de eigen geschiedenis-, ongedaan maken- of hersteltools van de provider wanneer die beschikbaar zijn. Het verbreken van een connector stopt toekomstig gebruik; het maakt reeds aangebrachte wijzigingen niet ongedaan.
Beheer een verbinding
Open de Connector-catalogus en selecteer een verbonden service om de huidige status te bekijken.
Vanuit het detailpaneel van de connector kun je mogelijk:
- Controleren welk account is verbonden
- De ondersteunde acties en het machtigingsbereik van de connector bekijken
- Opnieuw verbinden wanneer de autorisatie is verlopen
- Toegang vernieuwen of wijzigen wanneer de service dit ondersteunt
- Het account loskoppelen van Atoms
Loskoppelen in Atoms stopt toekomstig gebruik van de verbinding. Bij sommige services moet je Atoms mogelijk ook intrekken via de account- of beveiligingsinstellingen van de service zelf.
Voorbeelden per gebruikssituatie
De onderstaande tabel is een redactionele groepering per gebruikssituatie, geen reeks cataloguscategorieën. Gebruik de doorzoekbare catalogus voor de actuele lijst met beschikbare connectors.
| Categorie | Veelvoorkomende toepassingen | Voorbeelden |
|---|---|---|
| Ontwikkeling | Bronbeheer, repositories, problemen en leveringsworkflows | GitHub, Linear |
| Backend en gegevens | Databases, authenticatie, opslag en gestructureerde gegevens | Supabase |
| Betalingen | Checkout-, facturerings- en betalingsworkflows | Stripe |
| Werkbeheer | Taken, projecten, eigenaren en vervaldata | Asana, Todoist |
| Bestanden en content | Externe bestanden zoeken, lezen en organiseren | Box, Dropbox |
| Analytics en marketing | Verkeer, zoekprestaties, campagnes en rapportage | Google Analytics 4, Google Search Console, Google Ads |
De beschikbaarheid van connectors verandert in de loop van de tijd. Gebruik de catalogus in Atoms voor de actuele lijst en open een connector om de exacte mogelijkheden te bekijken.
Installatiehandleidingen
Kies de handleiding voor je service:
- GitHub Verbinden
- Supabase Verbinden
- GA4 verbinden
- Google Search Console verbinden
- Google Ads verbinden
Zie bij verbindingsproblemen Problemen met Integratie oplossen.