Vai al contenuto principale
POST
Crea una sessione

Autorizzazioni

Richiede un utente di servizio o un token di accesso personale con l’autorizzazione UseDevinSessions (org.devins.use) a livello di organizzazione.

Autorizzazioni aggiuntive per funzionalità avanzate

Modalità Devin

Il parametro devin_mode controlla quale modalità Agent di Devin viene usata per la sessione: Se omesso, la sessione usa la modalità predefinita dell’organizzazione. Le modalità in anteprima sono soggette alle stesse restrizioni del feature flag e dell’anteprima degli agent Enterprise previste per l’app web.

Impersonazione utente

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

Autorizzazioni

Authorization
string
header
obbligatorio

Credenziale utente di servizio (prefisso: cog_)

Parametri del percorso

org_id
string | null
obbligatorio

ID organizzazione (prefisso: org-)

Esempio:

"org-abc123def456"

Parametri della query

devin_id
string | null

Corpo

application/json
prompt
string
obbligatorio
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

Associa un profilo di sicurezza a questa sessione; se omesso, si applicano le regole predefinite (il profilo di sicurezza del playbook, se associato, altrimenti quello predefinito dell'org/account Enterprise). Richiede l'autorizzazione per la gestione dei profili di sicurezza.

structured_output_schema
Structured Output Schema · object | null

Schema JSON (Draft 7) per convalidare l'output strutturato. Max 64 KB. Deve essere autonomo (nessun $ref esterno).

structured_output_required
boolean | null

Quando è true (impostazione predefinita), l'Agent DEVE chiamare provide_structured_output con is_final=true prima della fine del proprio turno. Quando è false, lo strumento è disponibile ma non obbligatorio: non è garantito che venga chiamato in un determinato turno.

resumable
boolean
predefinito:true

Se mantenere lo stato della VM della sessione dopo l'arresto, in modo da poter riprendere la sessione. Impostare su false per le sessioni temporanee.

memory_enabled
boolean | null

Imposta il campo su false per mantenere disattivata la memoria per questa sessione e le sue sessioni figlie: la sessione non legge né scrive nella memoria e la memoria non apprende dalla sua trascrizione. Ometti il campo o impostalo su true per rispettare le impostazioni della memoria del proprietario; true non attiva la memoria se tali impostazioni la mantengono disattivata.

platform
string | null

Override della piattaforma VM per la sessione (ad es. 'windows'), oppure il nome di un pool outpost (BYOB) su cui eseguire la sessione su una delle tue macchine. Se omesso (o impostato su 'inherit'), una sessione creata da un Devin padre eredita la destinazione del padre — sia la piattaforma sia il pool outpost, quindi un padre eseguito su un outpost genera sessioni figlie nello stesso pool; altrimenti viene usato il valore predefinito dell'organizzazione. Qualsiasi valore deve corrispondere a una piattaforma configurata per la tua organizzazione oppure al nome di un pool outpost (senza distinzione tra maiuscole e minuscole) — le piattaforme built-in hanno la priorità quando un nome corrisponde a entrambe, e un pool outpost personale di proprietà del chiamante ha la priorità su un pool a livello di account con lo stesso nome. I valori non riconosciuti vengono rifiutati con un errore 400 il cui corpo elenca le etichette delle piattaforme disponibili e i nomi dei pool outpost per l'org.

devin_mode
enum<string> | null

Esegue l'override della modalità Agent di Devin per la sessione. 'normal' usa la modalità Agent predefinita, 'fast' usa la modalità Fast, 'lite' usa Devin Lite, 'ultra' usa Devin Ultra e 'fusion' usa Fusion. Gli altri valori selezionano la modalità agente omonima nell'app web. Le modalità di anteprima sono soggette alla stessa feature flag e alle stesse restrizioni di anteprima dell'agente Enterprise dell'app web.

Opzioni disponibili:
normal,
fast,
fusion,
lite,
ultra,
fast-ultra,
swe-2-medium,
swe-2-high,
swe-2-max

Risposta

Risposta riuscita

session_id
string
obbligatorio
url
string
obbligatorio
status
enum<string>
obbligatorio
Opzioni disponibili:
new,
claimed,
running,
exit,
error,
suspended,
resuming
tags
string[]
obbligatorio
org_id
string | null
obbligatorio

Organizzazione proprietaria. Null per le sessioni scollegate, che appartengono all'account del loro creatore anziché a un'organizzazione.

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

La categoria di caso d'uso assegnata alla sessione, se la categorizzazione è stata eseguita. Valorizzata solo negli endpoint GET/di elenco.

Opzioni disponibili:
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

Il nome visualizzato della sottocategoria assegnata alla sessione. 'Other' quando è impostata una categoria ma non è stata assegnata o determinata alcuna sottocategoria. Valorizzata solo negli endpoint GET/di elenco.

origin
enum<string> | null

L'origine da cui è stata creata la sessione.

Opzioni disponibili:
webapp,
slack,
teams,
api,
linear,
jira,
automation,
cli,
desktop,
code_scan,
other
automation_id
string | null

ID dell'automazione che ha creato questa sessione, se presente.

structured_output
Structured Output · object | null

Structured Output validato della sessione. Valorizzato solo negli endpoint GET/di elenco.

devin_mode
enum<string> | null

La modalità Agent di Devin con cui è stata creata la sessione, dopo aver risolto le impostazioni predefinite dell'org/dell'utente e l'ereditarietà dalla sessione padre. None quando la sessione esegue un'anteprima dell'agente che non ha una modalità equivalente.

Opzioni disponibili:
normal,
fast,
fusion,
lite,
ultra,
fast-ultra,
swe-2-medium,
swe-2-high,
swe-2-max
status_detail
enum<string> | null

Dettagli aggiuntivi sullo stato corrente della sessione. Quando status è 'running': 'working' (sta lavorando attivamente), 'waiting_for_user' (richiede input dell'utente), 'waiting_for_approval' (in attesa dell'approvazione di un'azione in modalità sicura) oppure 'finished' (attività completata). Quando status è 'suspended': il motivo della sospensione, ad esempio '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' oppure 'error'. Valorizzato solo negli endpoint GET/di elenco.

Opzioni disponibili:
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

Spesa a consumo (utilizzo eccedente) in USD per questa sessione, escluse le sessioni figlie. Il campo è valorizzato solo per i piani Teams; vale 0 quando la sessione è stata interamente coperta dalla quota. È omesso per gli altri piani ed è valorizzato solo negli endpoint get/list.

security_profile
SessionSecurityProfileResponse · object | null

L'associazione al profilo di sicurezza specifica della sessione. Valorizzata solo negli endpoint GET/di elenco.