Vai al contenuto principale
POST
/
v3beta1
/
organizations
/
{org_id}
/
sessions
Create Session
curl --request POST \
  --url https://api.devin.ai/v3beta1/organizations/{org_id}/sessions \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "prompt": "<string>",
  "advanced_mode": "analyze",
  "bypass_approval": true,
  "child_playbook_id": "<string>",
  "create_as_user_id": "<string>",
  "knowledge_ids": [
    "<string>"
  ],
  "max_acu_limit": 123,
  "playbook_id": "<string>",
  "repos": [
    "<string>"
  ],
  "secret_ids": [
    "<string>"
  ],
  "session_links": [
    "<string>"
  ],
  "tags": [
    "<string>"
  ],
  "title": "<string>"
}
'
{
  "acus_consumed": 123,
  "created_at": 123,
  "org_id": "<string>",
  "pull_requests": [
    {
      "pr_state": "<string>",
      "pr_url": "<string>"
    }
  ],
  "session_id": "<string>",
  "status": "new",
  "tags": [
    "<string>"
  ],
  "updated_at": 123,
  "url": "<string>",
  "child_session_ids": [
    "<string>"
  ],
  "is_advanced": false,
  "is_archived": false,
  "parent_session_id": "<string>",
  "title": "<string>",
  "user_id": "<string>"
}

Autorizzazioni

Richiede un utente di servizio con l’autorizzazione ManageOrgSessions a livello di organizzazione.

Autorizzazioni aggiuntive per funzionalità avanzate

FunzionalitàAutorizzazione richiesta
advanced_modeUseDevinExpert
create_as_user_idImpersonateOrgSessions

Modalità avanzata

Il parametro advanced_mode abilita comportamenti di sessione specializzati per i flussi di lavoro di automazione. Quando è attivato, la sessione utilizza la persona avanzata e il prompt viene trasformato in base alla modalità selezionata.

Modalità disponibili

ModeDescriptionRequired Parameters
analyzeAnalizza le sessioni di Devin esistenti per estrarre informazioni utilisession_links
createCrea un nuovo playbook basato sull’analisi delle sessioniNessuno (facoltativo: session_links)
improveMigliora un playbook esistente in base al feedbackchild_playbook_id
batchAvvia più sessioni di Devin per un elenco di attivitàchild_playbook_id
manageGestisci KnowledgeNessuno

Opzioni della modalità batch

Quando usi la modalità batch, puoi opzionalmente impostare bypass_approval su true per saltare il passaggio di approvazione per la creazione delle sessioni batch. Questo è utile per i flussi di lavoro completamente automatizzati in cui vuoi che le sessioni inizino immediatamente senza approvazione manuale.

Impersonazione utente

Il parametro create_as_user_id consente di creare una sessione per conto di un altro utente. Questo richiede:
  1. L’utente di servizio deve avere l’autorizzazione ImpersonateOrgSessions
  2. L’utente di destinazione deve essere membro dell’organizzazione
  3. L’utente di destinazione deve avere l’autorizzazione UseDevinSessions

Autorizzazioni

Authorization
string
header
obbligatorio

Service User credential (prefix: cog_)

Corpo

application/json
prompt
string
obbligatorio
advanced_mode
enum<string> | null
Opzioni disponibili:
analyze,
create,
improve,
batch,
manage
bypass_approval
boolean | null
child_playbook_id
string | null
create_as_user_id
string | null
knowledge_ids
string[] | null
max_acu_limit
integer | null
playbook_id
string | null
repos
string[] | null
secret_ids
string[] | null
tags
string[] | null
title
string | null

Risposta

Successful Response

acus_consumed
number
obbligatorio
created_at
integer
obbligatorio
org_id
string
obbligatorio
pull_requests
SessionPullRequest · object[]
obbligatorio
session_id
string
obbligatorio
status
enum<string>
obbligatorio
Opzioni disponibili:
new,
claimed,
running,
exit,
error,
suspended,
resuming
tags
string[]
obbligatorio
updated_at
integer
obbligatorio
url
string
obbligatorio
child_session_ids
string[] | null
is_advanced
boolean
predefinito:false
is_archived
boolean
predefinito:false
parent_session_id
string | null
title
string | null
user_id
string | null