Crear una nueva sesión
ManageOrgSessions a nivel de la organización.
| Funcionalidad | Permiso requerido |
|---|---|
advanced_mode | UseDevinExpert |
create_as_user_id | ImpersonateOrgSessions |
advanced_mode habilita comportamientos de sesión especializados para flujos de trabajo de automatización. Cuando está activado, la sesión utiliza el perfil avanzado y el prompt se transforma según el modo seleccionado.
| Mode | Description | Required Parameters |
|---|---|---|
analyze | Analizar sesiones existentes de Devin para obtener información útil | session_links |
create | Crear un nuevo playbook basado en el análisis de sesiones | Ninguno (opcional: session_links) |
improve | Mejorar un playbook existente a partir de comentarios | child_playbook_id |
batch | Iniciar múltiples sesiones de Devin para una lista de tareas | child_playbook_id |
manage | Administrar Knowledge | Ninguno |
batch, puedes, de forma opcional, establecer bypass_approval en true para omitir el paso de aprobación en la creación de sesiones por lotes. Esto es útil para flujos de trabajo totalmente automatizados en los que quieres que las sesiones comiencen de inmediato sin aprobación manual.
create_as_user_id permite crear una sesión en nombre de otro usuario. Esto requiere:
ImpersonateOrgSessionsUseDevinSessionsCredencial de usuario de servicio (prefijo: cog_)
analyze, create, improve, batch, manage 1 - 2083Esquema JSON (Draft 7) para validar la salida estructurada. Máx. 64 KB. Debe ser autocontenido (sin $ref externos).
Respuesta satisfactoria
new, claimed, running, exit, error, suspended, resuming Salida estructurada validada de la sesión. Solo se incluye en endpoints GET/LIST.