Obter dados analíticos da sessão

Obtém informações detalhadas de uma sessão específica, incluindo contagens de mensagens, categoria de tamanho da sessão e análise gerada por IA.

GET /v3/organizations/{org_id}/sessions/{devin_id}/insights

Obter dados analíticos da sessão

cURL

curl --request GET \
  --url https://api.devin.ai/v3/organizations/{org_id}/sessions/{devin_id}/insights \
  --header 'Authorization: Bearer <token>'

200

{
  "acus_consumed": 123,
  "created_at": 123,
  "num_devin_messages": 123,
  "num_user_messages": 123,
  "org_id": "<string>",
  "pull_requests": [
    {
      "pr_state": "<string>",
      "pr_url": "<string>"
    }
  ],
  "session_id": "<string>",
  "session_size": "xs",
  "status": "new",
  "tags": [
    "<string>"
  ],
  "updated_at": 123,
  "url": "<string>",
  "analysis": {
    "action_items": [],
    "classification": {
      "category": "<string>",
      "confidence": 123,
      "programming_languages": [],
      "tools_and_frameworks": []
    },
    "issues": [],
    "note_usage": {
      "bad_usages": [],
      "good_usages": []
    },
    "suggested_prompt": {
      "original_prompt": "<string>",
      "suggested_prompt": "<string>",
      "feedback_items": []
    },
    "timeline": []
  },
  "child_session_ids": [
    "<string>"
  ],
  "is_advanced": false,
  "is_archived": false,
  "parent_session_id": "<string>",
  "playbook_id": "<string>",
  "service_user_id": "<string>",
  "status_detail": "working",
  "structured_output": {},
  "title": "<string>",
  "user_id": "<string>"
}

O devin_id é o ID da sessão com o prefixo devin- (por exemplo, devin-abc123).

​

Permissões

Requer um usuário de serviço com a permissão ViewOrgSessions no nível da organização.

Autorizações

Authorization · string · header · obrigatório

Credencial de usuário de serviço (prefixo: cog_)

Parâmetros de caminho

devin_id · string | null · obrigatório

ID da sessão do Devin (prefixo: devin-)

Exemplo:

"devin-abc123def456"

org_id · string | null · obrigatório

ID da organização (prefixo: org-)

Exemplo:

"org-abc123def456"

Resposta

200

application/json

Sucesso

Detalhes da sessão, enriquecidos com métricas quantitativas e análise gerada por IA.

Estende SessionResponse com campos adicionais que exigem consultas adicionais.

acus_consumed · number · obrigatório

created_at · integer · obrigatório

num_devin_messages · integer · obrigatório

Número de mensagens do Devin enviadas durante a sessão.

num_user_messages · integer · obrigatório

Número de mensagens do usuário enviadas durante a sessão.

org_id · string · obrigatório

pull_requests · SessionPullRequest · object[] · obrigatório

Show child attributes

session_id · string · obrigatório

session_size · enum<string> · obrigatório

Classificação do tamanho da sessão com base no consumo de ACU e na quantidade de mensagens.

Opções disponíveis: xs, s, m, l, xl

status · enum<string> · obrigatório

Opções disponíveis: new, creating, claimed, running, exit, error, suspended, resuming

tags · string[] · obrigatório

updated_at · integer · obrigatório

url · string · obrigatório

analysis · SessionInsightsAnalysis · object

Análise da sessão gerada por IA. None se a análise não tiver sido concluída.

Show child attributes

child_session_ids · string[] | null

is_advanced · boolean · padrão: false

is_archived · boolean · padrão: false

parent_session_id · string | null

playbook_id · string | null

service_user_id · string | null

status_detail · enum<string> | null

Detalhes adicionais sobre o status atual da sessão. Quando o status for 'running': 'working' (trabalhando ativamente), 'waiting_for_user' (requer entrada do usuário), 'waiting_for_approval' (aguardando aprovação da ação no modo seguro) ou 'finished' (tarefa concluída). Quando o status for 'suspended': o motivo da suspensão, como 'inactivity', 'user_request', 'usage_limit_exceeded', 'out_of_credits', 'out_of_quota', 'no_quota_allocation', 'payment_declined', 'org_usage_limit_exceeded' ou 'error'. Preenchido apenas nos endpoints get/list.

Opções disponíveis: 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, error

structured_output · Structured Output · object

Saída estruturada validada da sessão. Só é preenchida em endpoints de GET/list.

title · string | null

user_id · string | null