Integrationen verbinden und verwalten
Integrationen verbinden Atoms mit den Tools und Diensten, die du bereits nutzt. Je nach Connector kann Atoms externe Informationen verwenden, während es dir beim Erstellen hilft, deiner veröffentlichten App Fähigkeiten hinzufügt oder beide Workflows unterstützt.
Jeder Connector unterstützt eigene Aktionen und Berechtigungen. Prüfe die für den verbundenen Connector angezeigten Fähigkeiten und den Berechtigungsumfang; ein nicht verbundener Detailbereich zeigt möglicherweise nur seine Beschreibung und die Verbindungssteuerung an.
Verwende das Konto mit den geringsten erforderlichen Rechten und den Berechtigungsumfang, die die Aufgabe abschließen können. Füge keine Passwörter, Zugriffstoken, privaten Schlüssel oder andere nicht zusammenhängende sensible Daten in einen Prompt ein. Wenn ein Dienst Produktions- oder Kundendaten enthält, teste mit einem unkritischen Beispiel und überprüfe das genaue Ziel, bevor du einen Schreibvorgang zulässt.
Die Connectoren und Aktionen, die du siehst, können je nach Konto und Release variieren. Öffne den Connector-Katalog in Atoms, um zu sehen, was dir derzeit zur Verfügung steht.
Entscheide, was die Verbindung tun soll
Bevor du einen Dienst verbindest, entscheide, wo du ihn benötigst.
| Ziel | Beispiele |
|---|---|
| Dem Agent Kontext geben, während du erstellst | Dateien finden, Aufgaben zusammenfassen, Issues prüfen oder Projektdaten in einem Prompt verwenden |
| Den Agent Aktionen in einem anderen Dienst ausführen lassen | Eine Aufgabe erstellen, einen Datensatz aktualisieren, Tabellendaten hinzufügen oder ein Kalenderereignis erstellen |
| Einen Dienst zur veröffentlichten App hinzufügen | Anwendungsdaten speichern, Authentifizierung verarbeiten, Zahlungen abwickeln oder einen App-Workflow ausführen |
Einige Connectoren unterstützen mehr als ein Ziel. Prüfe die Connector-Beschreibung und die angeforderten Berechtigungen, bevor du ihn verbindest.
Eine Integration verbinden
Öffne Settings → Connectors, um den primären Einstiegspunkt zu verwenden. Du kannst auch Connect your tools to Atoms im Dashboard auswählen.
Das Verbinden oder Trennen einer Integration kann Zugriff als Workspace-Eigentümer oder autorisierter Admin erfordern. Wenn du kein Eigentümer oder Admin bist und eine Steuerung nicht verfügbar ist, frage den Workspace-Eigentümer oder einen autorisierten Admin.
Vom Dashboard aus
- Öffne das Atoms-Dashboard.
- Wähle Connect your tools to Atoms.
- Wähle den Connector aus, den du verwenden möchtest. Folge der auf dieser Connector-Karte angezeigten Verbindungssteuerung.
- Verwende die für diesen Connector angezeigte Steuerung. Wenn sie einen generischen Detailbereich öffnet, wähle Connect; anbieterspezifische Integrationen können ihren eigenen Einrichtungs- oder Autorisierungsablauf öffnen.
- Melde dich beim externen Dienst an, wenn du dazu aufgefordert wirst.
- Prüfe das Konto und die Berechtigungen und genehmige dann die Verbindung.
- Kehre zu Atoms zurück und bestätige, dass der Connector als verbunden angezeigt wird. Öffne in dem Chat, in dem du ihn verwenden möchtest, die Connector-Auswahl und aktiviere den Connector für diesen Chat.
Eine verbundene Integration verwenden
Teile dem Agent mit, welchen Dienst er verwenden soll, und gib genügend Details an, um das richtige Element zu identifizieren. Nützliche Details sind unter anderem:
- Der Projekt-, Workspace-, Repository-, Ordner-, Kalender- oder Tabellenname
- Ein Aufgabenname, eine Issue-ID, ein Dateiname oder eine Datensatzkennung
- Ein Datumsbereich, Fälligkeitsdatum, Eigentümer, Status oder Priorität
- Was Atoms lesen, zusammenfassen, erstellen oder aktualisieren soll
Zum Beispiel:
- „Fasse mir zugewiesene Linear-Issues mit hoher Priorität zusammen.“
- „Finde das Launch-Briefing in Drive und liste die offenen Entscheidungen auf.“
- „Füge diese genehmigten Leads zur Kampagnen-Tabelle hinzu.“
- „Erstelle ein Kalenderereignis für das Design-Review nächsten Dienstag um 15 Uhr.“
Atoms kann nur Aktionen verwenden, die vom Connector unterstützt werden, sowie Daten, die für das verbundene Konto verfügbar sind. Wenn die Fähigkeit oder Aktion, die du benötigst, für diesen Connector nicht angezeigt wird, halte an und gehe nicht davon aus, dass sie unterstützt wird.
Externe Änderungen prüfen, bevor sie ausgeführt werden
Wenn ein Connector und eine Aktion das Erstellen oder Aktualisieren externer Daten unterstützen, zeigt Atoms möglicherweise vor der Ausführung eine Bestätigung an.
Prüfe:
- Den Dienst und das verbundene Konto
- Die Zieldatei, Tabelle, den Kalender, das Projekt oder den Datensatz
- Die Informationen, die erstellt oder geändert werden
- Jedes Datum, jede Uhrzeit, jeden Empfänger oder einen anderen wichtigen Wert
Wenn Atoms eine Bestätigung anzeigt, prüfe sie und wähle Confirm, um fortzufahren, oder brich ab, damit der externe Dienst unverändert bleibt. Die Verfügbarkeit von Schreibzugriff hängt vom Connector und der Aktion ab; schreibgeschützte Connectoren bieten keine Schreibaktionen an.
Überprüfe nach einem Schreibvorgang das Ergebnis im externen Dienst, bevor du es erneut versuchst. Wenn Ziel oder Werte falsch sind, stoppe den Workflow und verwende, wenn verfügbar, die Verlaufs-, Rückgängig- oder Wiederherstellungstools des Anbieters. Das Trennen eines Connectors stoppt die zukünftige Nutzung; bereits vorgenommene Änderungen werden dadurch nicht rückgängig gemacht.
Eine Verbindung verwalten
Öffne den Connector-Katalog und wähle einen verbundenen Dienst aus, um seinen aktuellen Status zu prüfen.
Im Connector-Detailbereich kannst du möglicherweise:
- Prüfen, welches Konto verbunden ist
- Die vom Connector unterstützten Aktionen und den Berechtigungsumfang prüfen
- Die Verbindung erneut herstellen, wenn die Autorisierung abgelaufen ist
- Den Zugriff aktualisieren oder ändern, wenn der Dienst dies unterstützt
- Das Konto von Atoms trennen
Das Trennen in Atoms stoppt die zukünftige Nutzung der Verbindung. Bei einigen Diensten musst du Atoms möglicherweise zusätzlich in den konto- oder sicherheitsbezogenen Einstellungen des Dienstes widerrufen.
Beispiele nach Anwendungsfall
Die folgende Tabelle ist eine redaktionelle Gruppierung nach Anwendungsfall, keine Reihe von Katalogkategorien. Verwende den durchsuchbaren Katalog für die aktuelle Liste verfügbarer Connectoren.
| Kategorie | Häufige Verwendungen | Beispiele |
|---|---|---|
| Entwicklung | Versionsverwaltung, Repositories, Issues und Auslieferungs-Workflows | GitHub, Linear |
| Backend und Daten | Datenbanken, Authentifizierung, Speicher und strukturierte Daten | Supabase |
| Zahlungen | Checkout-, Abrechnungs- und Zahlungs-Workflows | Stripe |
| Arbeitsmanagement | Aufgaben, Projekte, Eigentümer und Fälligkeitsdaten | Asana, Todoist |
| Dateien und Inhalte | Externe Dateien suchen, lesen und organisieren | Box, Dropbox |
| Analysen und Marketing | Traffic, Suchleistung, Kampagnen und Reporting | Google Analytics 4, Google Search Console, Google Ads |
Die Verfügbarkeit von Connectoren ändert sich im Laufe der Zeit. Verwende den Katalog in Atoms für die aktuelle Liste und öffne einen Connector, um seine genauen Fähigkeiten zu prüfen.
Einrichtungsanleitungen
Wähle die Anleitung für deinen Dienst:
- GitHub verbinden
- Supabase verbinden
- GA4 verbinden
- Google Search Console verbinden
- Google Ads verbinden
Bei Verbindungsproblemen siehe Fehlerbehebung bei Integrationen.