构建自定义 API 使用仪表盘
Devin 自带使用仪表盘,但如果你需要自定义指标,或者想将 Devin 数据与其他数据源结合,可以让 Devin 使用 v3 API 帮你构建一个定制化版本。为 API 访问创建服务用户
v3 API 使用服务用户 token 进行认证,而不是个人 API key。你需要先创建一个服务用户,Devin 才能拉取数据。
- 访问 app.devin.ai > Settings > Service Users
- 点击 Create Service User,并为其分配带有
ViewAccountMetrics和ManageBilling权限的角色——这些权限是读取会话指标和消耗数据所必需的 - 复制创建后显示的 API token——它只会显示一次
- 将该 token 作为名为
DEVIN_SERVICE_USER_TOKEN的 Secret 存储起来,这样 Devin 就可以在会话中使用它,而无需将其硬编码在代码中
告诉 Devin 要构建什么
Devin 可以通过 Devin docs MCP 原生访问其自身文档——你不需要把 API 参考文档粘贴到提示中。只要把 Devin 指向正确的端点,它就会阅读文档以了解请求格式、查询参数和响应结构。
Devin 会构建什么
Devin 通过 docs MCP 阅读 v3 API docs 来了解精确的请求格式,然后搭建应用骨架:
- 读取 API 文档——在 Devin docs MCP 中搜索 consumption 和 metrics 端点的 schema,了解
start_date、end_date等查询参数以及响应结构 - 创建 API 路由——构建 Next.js API 路由,将请求代理到
https://api.devin.ai/v3/enterprise/*,并使用来自DEVIN_SERVICE_USER_TOKENSecret 的服务用户 token - 构建仪表盘 UI——使用 Recharts 创建响应式仪表盘页面,包括:
- 展示会话总数、已消耗 ACU 以及每周活跃用户数的 KPI 卡片
- 从
/consumption/daily/organizations端点拉取的每日消耗时间序列图 - 来自
/consumption/daily/users的按用户拆分数据 - 从会话列表端点获取的会话表格,包含状态、时长和 ACU 成本
- 添加筛选功能——接入日期范围选择器,重新请求所有端点,并使用更新后的
start_date和end_date参数 - 发起一个 PR——推送该应用,并附带一个
README.md,说明环境变量、本地开发设置(npm run dev)以及部署到 Vercel 的方法
