Crea sessione
Crea una nuova sessione.
Autorizzazioni
ManageOrgSessions a livello di organizzazione.
Autorizzazioni aggiuntive per funzionalità avanzate
Modalità Devin
devin_mode controlla quale modalità Agent di Devin viene usata per la sessione:
Impersonazione utente
create_as_user_id consente di creare una sessione per conto di un altro utente. Questo richiede che:
- L’utente di servizio abbia l’autorizzazione
ImpersonateOrgSessions - L’utente di destinazione sia un membro dell’organizzazione
- L’utente di destinazione abbia l’autorizzazione
UseDevinSessions
Autorizzazioni
Credenziale dell'utente del servizio (prefisso: cog_)
Parametri del percorso
ID dell'organizzazione (prefisso: org-)
"org-abc123def456"
Parametri della query
Corpo
1 - 2083Applica un override alla 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. Le modalità in anteprima sono soggette allo stesso flag di funzionalità e alle stesse restrizioni di anteprima dell'agente Enterprise della web app.
normal, fast, lite, ultra, fusion Esegui l'override della piattaforma VM per la sessione (ad es. 'windows'), oppure specifica il nome di un pool outpost (BYOB) su cui eseguire la sessione in una delle tue macchine. Se omesso (o impostato su 'inherit'), una sessione creata da un Devin padre eredita il posizionamento del padre, cioè sia la piattaforma sia il pool outpost; quindi un padre collocato 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); se un nome corrisponde a entrambe, hanno priorità le piattaforme integrate. 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.
Indica se preservare lo stato della VM della sessione dopo la sua interruzione, così da poterla riprendere. Impostare su false per le sessioni temporanee.
Se true (predefinito), l'agente DEVE chiamare provide_structured_output con is_final=true prima della fine del suo turno. Se false, il tool è disponibile ma non obbligatorio: non è garantito che venga chiamato in un determinato turno.
JSON Schema (Draft 7) per la convalida dell’output strutturato. Dimensione massima 64 KB. Deve essere autonomo (nessun $ref esterno).
Risposta
Risposta con esito positivo
new, claimed, running, exit, error, suspended, resuming La categoria del caso d'uso assegnata alla sessione, se la categorizzazione è stata eseguita. Valorizzato solo negli endpoint get/list.
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 L'origine da cui è stata creata la sessione.
webapp, slack, teams, api, linear, jira, automation, cli, desktop, code_scan, other Ulteriore dettaglio 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', 'total_session_limit_exceeded' oppure 'error'. Valorizzato solo negli endpoint get/list.
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 Output strutturato convalidato dalla sessione. Impostato solo sugli endpoint GET/list.
Il nome visualizzato della sottocategoria assegnata alla sessione. 'Other' quando è impostata una categoria ma non è stata assegnata né risolta alcuna sottocategoria. Valorizzato solo negli endpoint get/list.

