Récupérer les analyses de la session

Obtenir des informations détaillées pour une session spécifique, notamment le nombre de messages, la catégorie de taille de la session et une analyse générée par l’IA.

GET /v3/enterprise/sessions/{devin_id}/insights

Récupérer les analyses de la session

cURL

curl --request GET \
  --url https://api.devin.ai/v3/enterprise/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": []
  },
  "category": "bug_fixing",
  "child_session_ids": [
    "<string>"
  ],
  "is_archived": false,
  "origin": "webapp",
  "parent_session_id": "<string>",
  "playbook_id": "<string>",
  "service_user_id": "<string>",
  "status_detail": "working",
  "structured_output": {},
  "subcategory": "<string>",
  "title": "<string>",
  "user_id": "<string>"
}

Le devin_id correspond à l’identifiant de session préfixé par devin- (par exemple, devin-abc123).

​

Autorisations

Nécessite un compte de service disposant de l’autorisation ViewAccountSessions au niveau entreprise.

Autorisations

Authorization · string · header · requis

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

Paramètres de chemin

devin_id · string | null · requis

ID de session Devin (préfixe : devin-)

Exemple:

"devin-abc123def456"

Paramètres de requête

org_id · string | null

Réponse

200

application/json

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

Show child attributes

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. Aucune si l’analyse n’est pas terminée.

Show child attributes

category · enum<string> | null

Catégorie de cas d’usage attribuée à la session, si la catégorisation a été effectuée. Renseigné uniquement sur les endpoints get/list.

Options disponibles: bug_fixing, ci_cd_and_devops, code_quality_and_security, code_review_and_analysis, data_and_automation, documentation_and_content, feature_development, migrations_and_upgrades, other, refactoring_and_optimization, research_and_exploration, unit_test_generation

child_session_ids · string[] | null

is_archived · boolean · défaut: false

origin · enum<string> | null

Origine depuis laquelle la session a été créée.

Options disponibles: webapp, slack, teams, api, linear, jira, automation, cli, desktop, other

parent_session_id · string | null

playbook_id · string | null

service_user_id · string | null

status_detail · enum<string> | null

Informations supplémentaires sur le statut actuel de la session. Lorsque status vaut 'running' : 'working' (travaille activement), 'waiting_for_user' (nécessite une saisie de l’utilisateur), 'waiting_for_approval' (en attente d’approbation d’une action en mode sécurisé) ou 'finished' (tâche terminée). Lorsque status vaut 'suspended' : le motif de la suspension, par exemple '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' ou 'error'. Renseigné uniquement sur les endpoints get/list.

Options disponibles: 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

structured_output · Structured Output · object

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

subcategory · string | null

Nom d’affichage de la sous-catégorie attribuée à la session. 'Other' lorsqu’une catégorie est définie, mais qu’aucune sous-catégorie n’a été attribuée ou résolue. Renseigné uniquement sur les endpoints get/list.

title · string | null

user_id · string | null