Passer au contenu principal
GET
/
v3
/
organizations
/
{org_id}
/
sessions
/
{devin_id}
/
insights
Récupérer les analyses de session (GET)
curl --request GET \
  --url https://api.devin.ai/v3/organizations/{org_id}/sessions/{devin_id}/insights \
  --header 'Authorization: Bearer <token>'
{
  "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>"
}
Le devin_id est l’identifiant de session préfixé par devin- (par exemple : devin-abc123).

​
Autorisations

Nécessite un compte de service disposant de la permission ViewOrgSessions au niveau de l’organisation.

Autorisations

​
Authorization
string
header
requis

Identifiant de compte de service (préfixe : cog_)

Paramètres de chemin

​
devin_id
string | null
requis
​
org_id
string | null
requis

Réponse

Réponse réussie

Détails de session complétés par des métriques quantitatives et une analyse par IA.

Étend SessionResponse avec des champs supplémentaires qui nécessitent des requêtes supplémentaires.

​
acus_consumed
number
requis
​
created_at
integer
requis
​
num_devin_messages
integer
requis

Nombre de messages Devin envoyés pendant la session.

​
num_user_messages
integer
requis

Nombre de messages utilisateur envoyés pendant la session.

​
org_id
string
requis
​
pull_requests
SessionPullRequest · object[]
requis
​
session_id
string
requis
​
session_size
enum<string>
requis

Catégorisation de la taille de la session, basée sur l’utilisation d’ACU et le nombre de messages.

Options disponibles:
xs,
s,
m,
l,
xl
​
status
enum<string>
requis
Options disponibles:
new,
claimed,
running,
exit,
error,
suspended,
resuming
​
tags
string[]
requis
​
updated_at
integer
requis
​
url
string
requis
​
analysis
SessionInsightsAnalysis · object

Analyse de session générée par l’IA. Null si l’analyse n’a pas été déclenchée. L’analyse doit être déclenchée par l’utilisateur, soit via l’interface de Devin, soit en appelant l’endpoint de génération des analyses de session.

​
child_session_ids
string[] | null
​
is_advanced
boolean
défaut:false
​
is_archived
boolean
défaut:false
​
parent_session_id
string | null
​
playbook_id
string | null
​
service_user_id
string | null
​
status_detail
enum<string> | null

Informations complémentaires sur l’état actuel de la session. Lorsque le status est « running » : « working » (travail en cours), « waiting_for_user » (en attente d’une intervention de l’utilisateur), « waiting_for_approval » (en attente de l’approbation d’une action en mode sécurisé) ou « finished » (tâche terminée). Lorsque le status est « suspended » : la raison de la suspension, par exemple « inactivity », « user_request », « usage_limit_exceeded », « out_of_credits », « payment_declined », « org_usage_limit_exceeded » ou « error ». Renseigné uniquement pour les endpoints GET/list.

Options disponibles:
working,
waiting_for_user,
waiting_for_approval,
finished,
inactivity,
user_request,
usage_limit_exceeded,
out_of_credits,
payment_declined,
org_usage_limit_exceeded,
error
​
structured_output
Structured Output · object

Sortie structurée validée de la session. Renseignée uniquement pour les points de terminaison GET/LIST.

​
title
string | null
​
user_id
string | null