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 Funktionen hinzufügt oder beide Workflows unterstützt.
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 Funktionen 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 verbundenes Detailfenster zeigt möglicherweise nur seine Beschreibung und die Verbindungssteuerung an.
Verwende das Konto mit den geringsten 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 eine Aktion in einem anderen Dienst ausführen lassen | Eine Aufgabe erstellen, einen Datensatz aktualisieren, Tabellenkalkulationsdaten hinzufügen oder einen Kalendereintrag 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 im Dashboard Connect your tools to Atoms 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 aus.
- Wähle den Connector aus, den du verwenden möchtest. Folge der Verbindungssteuerung, die auf dieser Connector-Karte angezeigt wird.
- Verwende die für diesen Connector angezeigte Steuerung. Wenn sie ein allgemeines Detailfenster ö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:
- Der Name des Projekts, Workspace, Repositorys, Ordners, Kalenders oder der Tabellenkalkulation
- 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 hochpriorisierte Linear-Issues zusammen, die mir zugewiesen sind.“
- „Finde das Launch-Briefing in Drive und liste die offenen Entscheidungen auf.“
- „Füge diese genehmigten Leads zur Kampagnen-Tabelle hinzu.“
- „Erstelle einen Kalendereintrag 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 eine Bestätigung an, bevor der Vorgang ausgeführt wird.
Prüfe:
- Den Dienst und das verbundene Konto
- Die Zieldatei, Tabellenkalkulation, 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 cancel, um den externen Dienst unverändert zu lassen. 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 eigenen 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-Detailfenster kannst du möglicherweise:
- Prüfen, welches Konto verbunden ist
- Die unterstützten Aktionen und den Berechtigungsumfang des Connectors 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 auch in den konto- oder sicherheitsbezogenen Einstellungen des Dienstes selbst widerrufen.
Beispiele nach Anwendungsfall
Die folgende Tabelle ist eine redaktionelle Gruppierung nach Anwendungsfall, keine Sammlung von Katalogkategorien. Verwende den durchsuchbaren Katalog für die aktuelle Liste verfügbarer Connectoren.
Kategorie | Häufige Verwendungen | Beispiele |
|---|---|---|
Entwicklung | Quellcodeverwaltung, Repositorys, Issues und Bereitstellungs-Workflows | GitHub, Linear |
Backend und Daten | Datenbanken, Authentifizierung, Speicher und strukturierte Daten | Supabase |
Zahlungen | Checkout-, Abrechnungs- und Zahlungs-Workflows | Stripe |
Arbeitsmanagement | Aufgaben, Projekte, Verantwortliche und Fälligkeitsdaten | Asana, Todoist |
Dateien und Inhalte | Externe Dateien suchen, lesen und organisieren | Box, Dropbox |
Analysen und Marketing | Traffic, Suchleistung, Kampagnen und Berichterstattung | 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:
Bei Verbindungsproblemen siehe Fehlerbehebung bei Integrationen.