Einrichtung
Legen Sie diese Umgebungsvariablen fest, bevor Sie ein Beispiel ausführen:Erste Schritte: vom API key bis zur ersten Sitzung
Der häufigste Workflow — authentifizieren Sie sich, ermitteln Sie Ihr Konto und erstellen Sie Ihre erste Sitzung.Schritt 1: Überprüfen Sie Ihre Anmeldedaten
Service-Benutzer im org-Geltungsbereich können zu Schritt 3 wechseln — Sie kennen Ihre org-ID bereits von der Settings-Seite.
Schritt 2: Ihre Organisationen auflisten
Enterprise-Service-Benutzer können alle Organisationen auflisten:Schritt 3: Eine Sitzung erstellen
Schritt 4: Auf Ereignisse pollen
Überwachen Sie die Sitzung, indem Sie Nachrichten regelmäßig pollen:Vollständiges Python-Beispiel
Anhänge einer Sitzung herunterladen
Laden Sie Dateien herunter, die in einer Sitzung erstellt wurden (Logs, Screenshots, generierter Code usw.).Schritt 1: Sitzung abrufen
Schritt 2: Anhänge auflisten
Schritt 3: Herunterladen
Verwenden Sie für den Werturl keinen API-Schlüssel. Für diese URL ist eine Anmeldung in der Web-App erforderlich.
Verwenden Sie den Download-Endpunkt mit den Werten attachment_id und name. Der Endpunkt gibt eine 307-Weiterleitung auf eine kurzlebige URL zurück. Folgen Sie daher Weiterleitungen:
Vollständiges Python-Beispiel
Verwaltung von Knowledge und Playbooks
Verwalten Sie den Kontext und die Anweisungen, die Devin sitzungsübergreifend verwendet.Knowledge-Hinweis erstellen
Knowledge-Hinweise auflisten
Einen Knowledge-Hinweis aktualisieren
Einen Knowledge-Hinweis löschen
Ein Playbook erstellen
Die
/playbooks-Endpunkte sind veraltet. Playbooks werden zu Fähigkeiten migriert. In einem bereits migrierten Konto schreibt diese Anfrage den Skill des Playbooks. Ein Konto, das am oder nach dem 24. Oktober 2026 erstellt wurde und keine Playbooks enthält, erhält von diesen Endpunkten 410. Siehe Playbooks werden zu Fähigkeiten migriert.Vollständiges Beispiel in Python
Automatisierte Sitzungen planen
Erstellen Sie wiederkehrende Sitzungen mit einer Automatisierung, die über einenschedule:recurring-Trigger verfügt. Der Trigger erwartet eine rrule-Bedingung: eine iCalendar-RRULE, die in UTC ausgewertet wird (zum Beispiel FREQ=WEEKLY;BYDAY=MO,TU,WE,TH,FR;BYHOUR=13;BYMINUTE=0 für Wochentage um 9 Uhr Eastern Time während der Sommerzeit). Erfordert die Berechtigung ManageOrgAutomations.
Eine zeitgesteuerte Automatisierung erstellen
DTSTART mit COUNT=1, zum Beispiel DTSTART:20260915T170000Z\nRRULE:FREQ=DAILY;COUNT=1. Die Automatisierung wird einmal ausgelöst und deaktiviert sich anschließend selbst.
Auflisten, Update und Löschen
Vollständiges Python-Beispiel
Eine Aufgabe von überall an Devin übergeben
Da die Sessions API mit einer einzigen Anfrage eine Cloud-Devin-Sitzung erstellt, kann jedes Tool, Skript oder jeder Coding-Agent Arbeit an Devin “übergeben”, indem das aktuelle Repo, der Branch und nicht committete Änderungen im Prompt mitgegeben werden, sodass die Cloud-Sitzung dort anknüpft, wo Sie aufgehört haben.Sitzung mit Repo-Kontext erstellen
Fehlerbehandlung
Alle obigen Beispiele sollten im Produktiveinsatz eine Fehlerbehandlung enthalten. Hier ist ein wiederverwendbares Muster:Support
Benötigen Sie Hilfe?
Bei Fragen zur API oder um issues zu melden, schreiben Sie an support@cognition.ai

