获取会话洞察信息

获取特定会话的详细洞察，包括消息数量、会话大小分布以及 AI 生成的分析。

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

获取会话洞察信息

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>"
}

devin_id 是在会话 ID 前添加前缀 devin- 后得到的值 (例如，devin-abc123) 。

​

权限

需要一个在组织级别拥有 ViewOrgSessions 权限的服务用户。

授权

Authorization · string · header · 必填

服务用户凭据（前缀：cog_）

路径参数

devin_id · string | null · 必填

Devin 会话 ID（前缀：devin-）

示例:

"devin-abc123def456"

org_id · string | null · 必填

组织 ID（前缀：org-）

示例:

"org-abc123def456"

响应

200

application/json

成功响应

包含量化指标和 AI 分析的会话详细信息。

在 SessionResponse 的基础上，补充了原本需要通过额外查询才能获取的字段。

acus_consumed · number · 必填

created_at · integer · 必填

num_devin_messages · integer · 必填

会话期间发送的 Devin 消息总数。

num_user_messages · integer · 必填

会话期间发送的用户消息总数。

org_id · string · 必填

pull_requests · SessionPullRequest · object[] · 必填

Show child attributes

session_id · string · 必填

session_size · enum<string> · 必填

基于 ACU 使用量和消息数量对会话规模进行的分类。

可用选项: xs, s, m, l, xl

status · enum<string> · 必填

可用选项: new, creating, claimed, running, exit, error, suspended, resuming

tags · string[] · 必填

updated_at · integer · 必填

url · string · 必填

analysis · SessionInsightsAnalysis · object

AI 生成的会话分析。如果分析尚未完成，则为 None。

Show child attributes

child_session_ids · string[] | null

is_advanced · boolean · 默认值: false

is_archived · boolean · 默认值: false

parent_session_id · string | null

playbook_id · string | null

service_user_id · string | null

status_detail · enum<string> | null

有关 session 当前状态的更多详情。当 status 为“running”时，取值可能为“working”（正在执行）、“waiting_for_user”（需要用户输入）、“waiting_for_approval”（在安全模式下等待操作批准）或“finished”（任务已完成）。当 status 为“suspended”时，表示挂起原因，例如“inactivity”“user_request”“usage_limit_exceeded”“out_of_credits”“out_of_quota”“no_quota_allocation”“payment_declined”“org_usage_limit_exceeded”或“error”。仅在 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, error

structured_output · Structured Output · object

会话中已验证的结构化输出。仅在 GET/列表类端点中返回。

title · string | null

user_id · string | null