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.
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 weergegeven voor de verbonden connector; een niet-verbonden detailpaneel toont mogelijk alleen de beschrijving en verbindingsoptie.
Gebruik het account met de minste rechten en het machtigingsbereik dat de taak kan 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 een schrijfactie 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, issues 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.
Een Integratie verbinden
Open Instellingen → Connectors om het primaire toegangspunt te gebruiken. Je kunt ook Verbind je tools met Atoms selecteren vanuit het dashboard.
Voor het verbinden of verbreken van een Integratie kan toegang als werkruimte-eigenaar of geautoriseerde beheerder vereist zijn. Als je geen eigenaar of beheerder bent en een optie niet beschikbaar is, vraag het dan aan de eigenaar van de werkruimte of een geautoriseerde beheerder.
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 weergegeven.
- Gebruik de optie die voor die connector wordt weergegeven. Als er een algemeen detailpaneel wordt geopend, selecteer dan Verbinden; 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 waarin je deze wilt gebruiken de connector-kiezer en schakel de connector in voor die Chat.
Een verbonden Integratie gebruiken
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, issue-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-issues met hoge prioriteit samen die aan mij zijn toegewezen.”
- “Zoek de lanceringsbriefing in Drive en geef de openstaande beslissingen weer.”
- “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 weergegeven, 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 Bevestigen om door te gaan of annuleren om de externe service ongewijzigd te laten. Beschikbaarheid van schrijfacties 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 indien beschikbaar de eigen geschiedenis-, ongedaan maken- of hersteltools van de provider. Het verbreken van een connector stopt toekomstig gebruik; het maakt reeds aangebrachte wijzigingen niet ongedaan.
Een verbinding beheren
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 eigen account- of beveiligingsinstellingen van de service.
Voorbeelden per use case
De onderstaande tabel is een redactionele groepering op use case, geen set cataloguscategorieën. Gebruik de doorzoekbare catalogus voor de actuele lijst met beschikbare connectors.
Categorie | Veelvoorkomende toepassingen | Voorbeelden |
|---|---|---|
Ontwikkeling | Broncodebeheer, repositories, issues en opleverworkflows | GitHub, Linear |
Backend en data | Databases, authenticatie, opslag en gestructureerde gegevens | Supabase |
Betalingen | Checkout, facturatie 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:
Zie voor verbindingsproblemen Problemen met Integratie oplossen.