Skip to main content

构建自定义 API 使用仪表盘

Devin 自带使用仪表盘,但如果你需要自定义指标,或者想将 Devin 数据与其他数据源结合,可以让 Devin 使用 v3 API 帮你构建一个定制化版本。
AuthorCognition
Category数据与分析
FeaturesAPI
1

为 API 访问创建服务用户

v3 API 使用服务用户 token 进行认证,而不是个人 API key。你需要先创建一个服务用户,Devin 才能拉取数据。
  1. 访问 app.devin.ai > Settings > Service Users
  2. 点击 Create Service User,并为其分配带有 ViewAccountMetricsManageBilling 权限的角色——这些权限是读取会话指标和消耗数据所必需的
  3. 复制创建后显示的 API token——它只会显示一次
  4. 将该 token 作为名为 DEVIN_SERVICE_USER_TOKENSecret 存储起来,这样 Devin 就可以在会话中使用它,而无需将其硬编码在代码中
有关服务用户认证的详细信息,请参阅 v3 API Authentication Guide
2

告诉 Devin 要构建什么

Devin 可以通过 Devin docs MCP 原生访问其自身文档——你不需要把 API 参考文档粘贴到提示中。只要把 Devin 指向正确的端点,它就会阅读文档以了解请求格式、查询参数和响应结构。
3

Devin 会构建什么

Devin 通过 docs MCP 阅读 v3 API docs 来了解精确的请求格式,然后搭建应用骨架:
  1. 读取 API 文档——在 Devin docs MCP 中搜索 consumption 和 metrics 端点的 schema,了解 start_dateend_date 等查询参数以及响应结构
  2. 创建 API 路由——构建 Next.js API 路由,将请求代理到 https://api.devin.ai/v3/enterprise/*,并使用来自 DEVIN_SERVICE_USER_TOKEN Secret 的服务用户 token
  3. 构建仪表盘 UI——使用 Recharts 创建响应式仪表盘页面,包括:
    • 展示会话总数、已消耗 ACU 以及每周活跃用户数的 KPI 卡片
    • /consumption/daily/organizations 端点拉取的每日消耗时间序列图
    • 来自 /consumption/daily/users 的按用户拆分数据
    • 从会话列表端点获取的会话表格,包含状态、时长和 ACU 成本
  4. 添加筛选功能——接入日期范围选择器,重新请求所有端点,并使用更新后的 start_dateend_date 参数
  5. 发起一个 PR——推送该应用,并附带一个 README.md,说明环境变量、本地开发设置(npm run dev)以及部署到 Vercel 的方法
4

扩展仪表盘

在基础仪表盘工作正常后,可以在后续对话中让 Devin 添加更多面板: