1
为 API 访问创建服务用户
v3 API 使用服务用户 token 进行认证,而不是个人 API key。你需要先创建一个服务用户,Devin 才能拉取数据。
- 访问 app.devin.ai > Enterprise settings > Devin API,并打开 Service users 选项卡
- 点击 Provision > Enterprise service user,并为其分配带有
ViewAccountMetrics、ViewAccountConsumption、ViewAccountSessions和ViewAccountMembership权限的企业角色——这些权限是读取企业 metrics、consumption、sessions 和 users 端点所必需的。如果你还想使用下文介绍的组织过滤器,请添加ViewOrganizations - 复制预配后显示的 API token——它只会显示一次
- 将该 token 作为名为
DEVIN_SERVICE_USER_TOKEN的 Secret 存储起来,这样 Devin 就可以在会话中使用它,而无需将其硬编码在代码中
2
告诉 Devin 要构建什么
Devin 可以通过 Devin docs MCP 原生访问其自身文档——你不需要把 API 参考文档粘贴到提示中。只要把 Devin 指向正确的端点,它就会阅读文档以了解请求格式、查询参数和响应结构。
3
Devin 会构建什么
Devin 通过 docs MCP 阅读 v3 API docs 来了解精确的请求格式,然后搭建应用骨架:
- 读取 API 文档——在 Devin docs MCP 中搜索 consumption 和 metrics 端点的 schema,了解
time_after和time_before(Unix 时间戳) 等查询参数以及响应结构 - 创建 API 路由——构建 Next.js API 路由,将请求代理到
https://api.devin.ai/v3/enterprise/*,并使用来自DEVIN_SERVICE_USER_TOKENSecret 的服务用户 token - 构建仪表盘 UI——使用 Recharts 创建响应式仪表盘页面,包括:
- 展示会话总数、已消耗 ACU 以及每周活跃用户数的 KPI 卡片
- 从
/consumption/daily端点拉取的每日消耗时间序列图 - 按用户拆分的数据:分页遍历
/members/users和/members/idp-users,按user_id去重,为每个用户调用/consumption/daily/users/{user_id},再汇总总量 - 从会话列表端点获取的会话表格,包含状态、时长和 ACU 成本
- 添加筛选功能——接入日期范围选择器,使用更新后的时间范围参数重新请求所有端点
- 发起一个 PR——推送该应用,并附带一个
README.md,说明环境变量、本地开发设置 (npm run dev) 以及部署到 Vercel 的方法
4
扩展仪表盘
在基础仪表盘工作正常后,可以在后续对话中让 Devin 添加更多面板:

