> ## Documentation Index
> Fetch the complete documentation index at: https://docs.profy.cn/llms.txt
> Use this file to discover all available pages before exploring further.

# Platform Console

> 开发者控制台功能概览

[Platform Console](https://platform.profy.cn) 是袋袋的开发者控制台，提供 API Key 管理、调用统计、日志查询等功能。

## 访问方式

Platform Console 部署在 `platform.profy.cn`，与主站 `app.profy.cn` 共享登录态（跨子域 Cookie）。你只需在主站登录一次，即可直接访问 Platform Console。

访问入口：

* 直接访问 [platform.profy.cn](https://platform.profy.cn)
* 在主站头像菜单中点击「开发者平台」

<Note>
  如果你尚未登录，Platform Console 会自动重定向到 `app.profy.cn/sign-in` 进行登录。
</Note>

## Dashboard

Dashboard 是你进入控制台的第一个页面，提供 API 使用的整体概览。

### KPI 卡片

Dashboard 顶部展示关键指标卡片：

| 指标         | 说明                |
| ---------- | ----------------- |
| **总调用次数**  | 选定时间范围内的 API 总调用数 |
| **成功率**    | 成功调用占总调用的百分比      |
| **平均响应时间** | API 调用的平均耗时（毫秒）   |
| **积分消耗**   | 选定时间范围内消耗的积分总量    |

### 调用趋势图

Dashboard 中央展示 API 调用量的趋势图，支持切换时间范围：

* **今天**：按小时展示
* **近 7 天**：按天展示（默认）
* **近 30 天**：按天展示

## API Keys

API Keys 页面用于管理你的 API 密钥。

### 功能

* **创建 Key**：指定名称、权限范围和过期时间
* **查看列表**：展示所有 Key 的状态、创建时间和过期信息
* **吊销 Key**：永久禁用不再需要的 Key

### Key 信息

| 列      | 说明                     |
| ------ | ---------------------- |
| 名称     | Key 的描述性名称             |
| Key 前缀 | `sk-pro-xxxx...`（安全遮掩） |
| 权限范围   | Key 可访问的端点             |
| 创建时间   | Key 的创建日期              |
| 过期时间   | Key 的过期日期              |
| 状态     | 活跃 / 已过期 / 已吊销         |

<Tip>
  API Key 在创建时仅展示一次完整内容。如果你忘记保存，需要创建一个新的 Key。
</Tip>

详细管理指南请参阅 [API Key 管理](/zh/developers/api-key-management)。

## Usage Stats

Usage Stats 页面提供 API 调用量的详细分析。

### 端点分布

按端点查看调用量分布：

| 端点                     | 典型占比  |
| ---------------------- | ----- |
| `/v1/agents/run`       | 专家调用  |
| `/v1/chat/completions` | 对话补全  |
| `/v1/events`           | 自定义事件 |
| `/v1/models`           | 模型列表  |

### 时间范围

所有统计支持三个时间维度：

* **今天**：查看实时数据
* **近 7 天**：查看近一周趋势
* **近 30 天**：查看月度概况

### 分析维度

* **按端点**：哪些 API 调用最多
* **按状态码**：成功与错误的比例
* **按 API Key**：不同 Key 的调用分布

## Call Logs

Call Logs 页面记录每一次 API 调用的详细信息，支持搜索和筛选。

### 日志列表

每条日志包含：

| 字段      | 说明            |
| ------- | ------------- |
| 时间      | 调用发生的时间       |
| 端点      | 调用的 API 端点    |
| 方法      | HTTP 方法       |
| 状态码     | HTTP 响应状态码    |
| 耗时      | 请求处理时间（毫秒）    |
| 积分      | 本次调用消耗的积分（如有） |
| API Key | 使用的 Key 名称    |

### 筛选条件

| 筛选项     | 说明           |
| ------- | ------------ |
| 端点      | 按 API 端点筛选   |
| 状态码     | 按 HTTP 状态码筛选 |
| API Key | 按使用的 Key 筛选  |
| 时间范围    | 按开始/结束时间筛选   |

### 详情展开

点击某条日志可展开查看详细信息：

* **请求摘要**：请求的关键参数（如模型名、专家标识符、消息数量）
* **响应摘要**：响应的关键信息（如 token 用量、上游状态码）
* **积分消耗**：本次调用扣除的积分数

<Note>
  出于安全考虑，日志中不记录完整的请求体和响应体，仅保留关键摘要信息。
</Note>

### 调试用途

Call Logs 在调试时非常有用：

1. **定位失败请求**：按状态码筛选 4xx/5xx 错误
2. **分析延迟**：按耗时排序找到最慢的请求
3. **追踪积分消耗**：查看哪些调用消耗了最多积分
4. **审计 Key 使用**：检查特定 Key 的调用记录

## Playground（即将推出）

Playground 是一个在线的 API 测试沙盒，让你无需编写代码即可测试 API。

计划支持的功能：

* **可视化请求构建**：通过表单配置请求参数
* **实时响应预览**：查看 API 响应（支持 SSE 流预览）
* **代码片段生成**：自动生成 Python / TypeScript / curl 代码
* **保存和分享**：保存测试用例供团队参考

## 技术架构

Platform Console 是一个独立的 Next.js 应用：

* **部署**：`platform.profy.cn`（独立的 Kubernetes Deployment）
* **认证**：跨子域 Cookie（`AUTH_COOKIE_DOMAIN=.profy.cn`），直读 session 表验证登录态
* **数据**：所有数据通过 Core API 获取，Platform 自身不运行业务逻辑

## 下一步

<CardGroup cols={2}>
  <Card title="API Key 管理" icon="key" href="/zh/developers/api-key-management">
    创建和管理 API Key
  </Card>

  <Card title="快速开始" icon="rocket" href="/zh/developers/quickstart">
    发起你的第一次 API 调用
  </Card>
</CardGroup>