Zum Hauptinhalt springen
POST
Neue Sitzung erstellen
Mit den Standardrollen Member und Admin kann jeder API-Schlüssel diesen Endpunkt aufrufen. In Enterprise muss eine benutzerdefinierte oder bearbeitete Rolle die Berechtigung Use Devin Sessions (UseDevinSessions) enthalten. Die Sitzung wird im Namen des Nutzers erstellt, zu dem der API-Schlüssel gehört.

Limits und Validierung

  • prompt darf höchstens 30,000 Zeichen umfassen; längere Prompts führen zu einem 400.
  • tags akzeptiert höchstens 50 Tags, jeweils eine nicht leere Zeichenfolge mit höchstens 256 Zeichen. Unternehmen, die erforderliche Tags erzwingen, lehnen reservierte Tag-Namen mit 400 ab.
  • structured_output_schema muss ein gültiges JSON Schema (Draft 7) mit "type": "object" auf Root-Ebene sein, darf keine externen $ref enthalten und höchstens 64 KB groß sein; andernfalls gibt die Anfrage 400 zurück.
  • is_new_session wird in der Antwort nur gesetzt, wenn die Anfrage idempotency_key (oder das veraltete idempotent) verwendet; andernfalls ist der Wert null.

Autorisierungen

Authorization
string
header
erforderlich

Persönlicher API-Schlüssel (apk_user_*) oder Service-API-Schlüssel (apk_*)

Body

application/json
prompt
string
erforderlich
idempotent
boolean
Standard:false
knowledge_ids
string[] | null

Liste der zu verwendenden Knowledge-IDs. Wenn None, wird die gesamte Knowledge verwendet. Wenn die Liste leer ist, wird keine Knowledge verwendet.

max_acu_limit
integer | null

Maximaler ACU-Grenzwert, muss positiv sein

Erforderlicher Bereich: x > 0
playbook_id
string | null
secret_ids
string[] | null

Liste der zu verwendenden Secret-IDs. Ist der Wert None, werden alle Secrets verwendet. Ist die Liste leer, werden keine Secrets verwendet.

session_secrets
SessionSecretInput · object[] | null

Liste der sitzungsspezifischen Secrets, die verwendet werden sollen. Diese Secrets sind nur in dieser Sitzung verfügbar und werden nicht in den Organisations-Secrets gespeichert.

snapshot_id
string | null
structured_output_schema
Structured Output Schema · object | null

JSON-Schema (Entwurf 7) zur Validierung strukturierter Ausgaben. Max. 64 KB. Muss in sich geschlossen sein (keine externen $ref-Verweise).

tags
string[] | null

Liste der Tags, die der Sitzung hinzugefügt werden sollen.

Maximum array length: 50
title
string | null

Benutzerdefinierter Titel für die Sitzung. Wenn None angegeben ist, wird der Titel automatisch generiert.

unlisted
boolean
Standard:false

Antwort

Erfolgreiche Antwort

Antworttext, der bei erfolgreicher Erstellung einer Sitzung zurückgegeben wird.

session_id
string
erforderlich
url
string
erforderlich
is_new_session
boolean | null