Session erstellen
Neue Sitzung erstellen
Berechtigungen
ManageOrgSessions auf Organisationsebene.
Zusätzliche Berechtigungen für erweiterte Funktionen
Devin-Modus
devin_mode legt fest, welcher Devin-Agent-Modus für die Sitzung verwendet wird:
Nutzer-Impersonation
create_as_user_id ermöglicht das Erstellen einer Sitzung im Namen eines anderen Nutzers. Dafür ist Folgendes erforderlich:
- Der Servicebenutzer muss die Berechtigung
ImpersonateOrgSessionshaben - Der Zielnutzer muss Mitglied der Organisation sein
- Der Zielnutzer muss die Berechtigung
UseDevinSessionshaben
Autorisierungen
Servicebenutzer-Anmeldedaten (Präfix: cog_)
Pfadparameter
Organisations-ID (Präfix: org-)
"org-abc123def456"
Abfrageparameter
Body
1 - 2083Überschreibt den Devin Agent-Modus für die Sitzung. 'normal' verwendet den Standard-Agent-Modus, 'fast' verwendet den Fast-Modus, 'lite' verwendet Devin Lite, 'ultra' verwendet Devin Ultra und 'fusion' verwendet Fusion. Für Preview-Modi gelten dieselben Feature-Flag- und Enterprise-Agent-Preview-Einschränkungen wie für die Web-App.
normal, fast, lite, ultra, fusion Überschreibt die VM-Plattform für die Sitzung (z. B. 'windows') oder den Namen eines Outpost-Pools (BYOB), um die Sitzung auf einer Ihrer eigenen Maschinen auszuführen. Wenn dieser Wert weggelassen wird (oder auf 'inherit' gesetzt ist), übernimmt eine von einem übergeordneten Devin erstellte Sitzung dessen Platzierung – also sowohl die Plattform als auch den Outpost-Pool. Ein in einem Outpost platzierter übergeordneter Devin startet untergeordnete Sitzungen also im selben Pool; andernfalls wird der Organisationsstandard verwendet. Jeder Wert muss entweder einer für Ihre Organisation konfigurierten Plattform oder einem Outpost-Pool-Namen entsprechen (Groß-/Kleinschreibung wird nicht beachtet) – integrierte Plattformen haben Vorrang, wenn ein Name auf beides zutrifft. Nicht erkannte Werte werden mit einem 400-Fehler abgelehnt; der Fehlertext listet die verfügbaren Plattformbezeichnungen und Outpost-Pool-Namen für die Organisation auf.
Ob der VM-Status der Sitzung nach dem Beenden beibehalten werden soll, damit die Sitzung fortgesetzt werden kann. Für temporäre Sitzungen auf false setzen.
Wenn „true“ (Standard), MUSS der Agent provide_structured_output mit is_final=true aufrufen, bevor sein Turn endet. Wenn „false“, ist das Tool verfügbar, aber nicht erforderlich — es ist nicht garantiert, dass es in einem bestimmten Turn aufgerufen wird.
JSON-Schema (Draft 7) zur Validierung strukturierter Ausgaben. Max. 64 KB. Muss in sich abgeschlossen sein (keine externen $ref-Verweise).
Antwort
Erfolgreiche Antwort
new, claimed, running, exit, error, suspended, resuming Die der Sitzung zugewiesene Anwendungsfallkategorie, falls die Kategorisierung ausgeführt wurde. Nur bei GET-/List-Endpunkten befüllt.
bug_fixing, ci_cd_and_devops, code_quality_and_security, code_review, code_review_and_analysis, data_and_automation, documentation_and_content, feature_development, migrations_and_upgrades, other, production_investigation, refactoring_and_optimization, research_and_exploration, security, unit_test_generation Die Quelle, aus der die Sitzung erstellt wurde.
webapp, slack, teams, api, linear, jira, automation, cli, desktop, code_scan, other Zusätzliche Details zum aktuellen Status der Sitzung. Wenn der Status „running“ ist: „working“ (arbeitet aktiv), „waiting_for_user“ (benötigt Eingaben des Nutzers), „waiting_for_approval“ (wartet im abgesicherten Modus auf die Genehmigung einer Aktion) oder „finished“ (Aufgabe abgeschlossen). Wenn der Status „suspended“ ist: der Grund für die Unterbrechung, z. B. „inactivity“, „user_request“, „usage_limit_exceeded“, „out_of_credits“, „out_of_quota“, „no_quota_allocation“, „payment_declined“, „org_usage_limit_exceeded“, „total_session_limit_exceeded“ oder „error“. Nur bei GET-/List-Endpunkten befüllt.
working, waiting_for_user, waiting_for_approval, finished, inactivity, user_request, usage_limit_exceeded, out_of_credits, out_of_quota, no_quota_allocation, payment_declined, org_usage_limit_exceeded, total_session_limit_exceeded, error Validierte strukturierte Ausgabe aus der Session. Wird nur bei GET-/LIST-Endpunkten befüllt.
Der Anzeigename der der Sitzung zugewiesenen Unterkategorie. „Other“, wenn eine Kategorie festgelegt ist, aber keine Unterkategorie zugewiesen oder bezogen werden konnte. Nur bei GET-/List-Endpunkten befüllt.

