Zum Hauptinhalt springen
POST
Sitzung erstellen

Berechtigungen

Erfordert einen Servicebenutzer oder ein persönliches Zugriffstoken mit der Berechtigung UseDevinSessions (org.devins.use) auf Organisationsebene.

Zusätzliche Berechtigungen für erweiterte Funktionen

Devin-Modus

Der Parameter devin_mode legt fest, welcher Devin-Agent-Modus für die Sitzung verwendet wird: Wenn der Parameter weggelassen wird, verwendet die Sitzung den Standardmodus der Organisation. Für Preview-Modi gelten dieselben Einschränkungen hinsichtlich Feature-Flags und der Enterprise-Agent-Preview wie für die Web-App.

Nutzer-Impersonation

Der Parameter create_as_user_id ermöglicht das Erstellen einer Sitzung im Namen eines anderen Nutzers. Dafür ist Folgendes erforderlich:
  1. Der Servicebenutzer muss die Berechtigung ImpersonateOrgSessions haben
  2. Der Zielnutzer muss Mitglied der Organisation sein
  3. Der Zielnutzer muss die Berechtigung UseDevinSessions haben

Autorisierungen

Authorization
string
header
erforderlich

Anmeldedaten für Service-Benutzer (Präfix: cog_)

Pfadparameter

org_id
string | null
erforderlich

Organisations-ID (Präfix: org-)

Beispiel:

"org-abc123def456"

Abfrageparameter

devin_id
string | null

Body

application/json
prompt
string
erforderlich
title
string | null
tags
string[] | null
max_acu_limit
integer | null
playbook_id
string | null
knowledge_ids
string[] | null
secret_ids
string[] | null
session_secrets
SessionSecretInput · object[] | null
repos
string[] | null
attachment_urls
string<uri>[] | null
Required string length: 1 - 2083
create_as_user_id
string | null
child_playbook_id
string | null
bypass_approval
boolean | null
security_profile
SessionSecurityProfileSelection · object | null

Weisen Sie dieser Sitzung ein Security Profile zu. Wird es nicht angegeben, greift die Standardauswahl: das Security Profile des Playbooks, sofern eines zugeordnet ist, andernfalls der Organisations-/Enterprise-Standard. Erfordert die Berechtigung zur Verwaltung von Security Profiles.

structured_output_schema
Structured Output Schema · object | null

JSON Schema (Draft 7) zur Validierung von Structured Output. Max. 64 KB. Muss in sich geschlossen sein (keine externen $ref).

structured_output_required
boolean | null

Wenn true (Standard), MUSS der Agent vor Ende seines Zuges provide_structured_output mit is_final=true aufrufen. Wenn false, ist das Tool verfügbar, aber nicht erforderlich — es ist nicht garantiert, dass es in einem bestimmten Zug aufgerufen wird.

resumable
boolean
Standard:true

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.

memory_enabled
boolean | null

Setzen Sie den Wert auf false, um das Gedächtnis für diese Sitzung und ihre untergeordneten Sitzungen deaktiviert zu lassen: Die Sitzung liest keine Gedächtnisinhalte und schreibt keine hinein, und das Gedächtnis lernt nicht aus ihrem Transkript. Lassen Sie den Wert weg oder setzen Sie ihn auf true, um die Gedächtnis-Settings des Eigentümers zu übernehmen; true aktiviert das Gedächtnis nicht, wenn es durch diese Settings deaktiviert ist.

platform
string | null

Überschreibt die VM-Plattform für die Sitzung (z. B. 'windows') oder den Namen eines Outpost-(BYOB-)Pools, um die Sitzung auf einer Ihrer eigenen Maschinen auszuführen. Wenn der Wert weggelassen wird (oder auf 'inherit' gesetzt ist), übernimmt eine von einem übergeordneten Devin erstellte Sitzung dessen Platzierung – sowohl die Plattform als auch den Outpost-Pool. Ein auf einem Outpost platzierter übergeordneter Prozess startet also untergeordnete Prozesse im selben Pool; andernfalls wird der organizationsspezifische Standard verwendet. Jeder Wert muss entweder mit einer für Ihre Organisation konfigurierten Plattform oder mit einem Outpost-Pool-Namen übereinstimmen (Groß-/Kleinschreibung wird nicht beachtet) – integrierte Plattformen haben Vorrang, wenn ein Name auf beides passt, und ein persönlicher Outpost-Pool im Besitz des Aufrufers hat Vorrang vor einem kontoweiten Pool mit demselben Namen. Nicht erkannte Werte werden mit einem 400-Fehler abgelehnt; dessen Fehlertext listet die verfügbaren Plattformbezeichnungen und Outpost-Pool-Namen für die Organisation auf.

devin_mode
enum<string> | null

Ü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. Die anderen Werte wählen den gleichnamigen Agent-Modus in der Web-App aus. Für Preview-Modi gelten dieselben Feature-Flag- und Einschränkungen für die Agent-Vorschau in Enterprise wie für die Web-App.

Verfügbare Optionen:
normal,
fast,
fusion,
lite,
ultra,
fast-ultra,
swe-2-medium,
swe-2-high,
swe-2-max

Antwort

Erfolgreiche Antwort

session_id
string
erforderlich
url
string
erforderlich
status
enum<string>
erforderlich
Verfügbare Optionen:
new,
claimed,
running,
exit,
error,
suspended,
resuming
tags
string[]
erforderlich
org_id
string | null
erforderlich

Organisation, der die Sitzung gehört. Null bei losgelösten Sitzungen, die dem Konto ihres Erstellers statt einer Organisation gehören.

created_at
integer
erforderlich
updated_at
integer
erforderlich
acus_consumed
number
erforderlich
pull_requests
SessionPullRequest · object[]
erforderlich
title
string | null
playbook_id
string | null
user_id
string | null
is_archived
boolean
Standard:false
parent_session_id
string | null
child_session_ids
string[] | null
service_user_id
string | null
category
enum<string> | null

Die der Sitzung zugewiesene Use-Case-Kategorie, sofern die Kategorisierung ausgeführt wurde. Nur in GET-/List-Endpunkten ausgefüllt.

Verfügbare Optionen:
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
subcategory
string | null

Der Anzeigename der der Sitzung zugewiesenen Unterkategorie. 'Other', wenn eine Kategorie festgelegt ist, aber keine Unterkategorie zugewiesen oder ermittelt wurde. Nur in GET-/List-Endpunkten ausgefüllt.

origin
enum<string> | null

Der Ursprung, aus dem die Sitzung erstellt wurde.

Verfügbare Optionen:
webapp,
slack,
teams,
api,
linear,
jira,
automation,
cli,
desktop,
code_scan,
other
automation_id
string | null

ID der Automatisierung, die diese Sitzung erstellt hat, falls zutreffend.

structured_output
Structured Output · object | null

Validierte strukturierte Ausgabe aus der Sitzung. Nur in GET-/List-Endpunkten ausgefüllt.

devin_mode
enum<string> | null

Der Devin-Agent-Modus, mit dem die Sitzung erstellt wurde, nachdem die Standardwerte der Organisation/des Nutzers und die Vererbung der übergeordneten Sitzung aufgelöst wurden. None, wenn die Sitzung eine Agent-Vorschau ausführt, die kein entsprechendes Äquivalent für den Modus hat.

Verfügbare Optionen:
normal,
fast,
fusion,
lite,
ultra,
fast-ultra,
swe-2-medium,
swe-2-high,
swe-2-max
status_detail
enum<string> | null

Zusätzliche Details zum aktuellen Status der Sitzung. Wenn der Status 'running' ist: 'working' (arbeitet aktiv), 'waiting_for_user' (benötigt Nutzereingabe), 'waiting_for_approval' (wartet im sicheren Modus auf die Genehmigung einer Aktion) oder 'finished' (Aufgabe abgeschlossen). Wenn der Status 'suspended' ist: der Grund für die Aussetzung, zum Beispiel 'inactivity', 'user_request', 'usage_limit_exceeded', 'out_of_credits', 'out_of_quota', 'no_quota_allocation', 'payment_declined', 'org_usage_limit_exceeded', 'user_usage_limit_exceeded', 'total_session_limit_exceeded', 'contract_expired' oder 'error'. Nur in GET-/List-Endpunkten ausgefüllt.

Verfügbare Optionen:
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,
user_usage_limit_exceeded,
total_session_limit_exceeded,
contract_expired,
error
on_demand_usage
number | null

Nutzungsabhängige Kosten im Überschreitungsstatus in USD für diese Sitzung, ohne untergeordnete Sitzungen. Nur bei Teams-Tarifen befüllt; 0, wenn die Sitzung vollständig durch das Kontingent abgedeckt war. Bei anderen Tarifen nicht enthalten. Nur bei get- und Listenendpunkten befüllt.

security_profile
SessionSecurityProfileResponse · object | null

Die eigene Sicherheitsprofilbindung der Sitzung. Nur in GET-/List-Endpunkten ausgefüllt.