Skip to main content

​
认证

所有管理 API 需要在请求头中携带管理令牌： 
X-Admin-Token: your-admin-token
令牌通过环境变量 ADMIN_TOKEN 配置。未设置时返回 403，令牌错误返回 401。 Base URL: /api/admin/v1

​
仪表盘

方法路径说明
GET/dashboard总览统计（用户数、DAU、消息数、Token 用量）
GET/conversations/stats会话活跃度趋势
/dashboard 查询参数：
参数默认值说明
days30统计时间窗口（1-120 天）
返回字段： total_users, new_users_today, dau_today, total_messages, window_messages, token_summary (prompts/completions/total), users_per_day 图表数据

​
用户管理

方法路径说明
GET/users分页用户列表
GET/users/{user_id}用户详情（含记忆、会话、账单、工具使用）
PATCH/users/{user_id}/block封禁/解封用户
PATCH/users/{user_id}/quota设置消息配额
/users 查询参数：
参数默认值说明
page1页码
size20每页条数（1-200）
/users/{user_id}/block 请求体： 
{
  "is_blocked": true,
  "reason": "违规操作"
}
/users/{user_id}/quota 请求体： 
{
  "daily_message_limit": 100,
  "monthly_message_limit": 3000
}

​
记忆管理

方法路径说明
POST/users/{user_id}/memories/consolidate清洗单用户记忆
POST/memories/consolidate批量清洗记忆
DELETE/users/{user_id}/memories清空单用户记忆
POST/memories/purge批量清空记忆
清洗（consolidate）：LLM 审查记忆，决策保留/删除/合并，去除过时和重复条目。 单用户清洗参数：
参数默认值说明
max_scan200扫描上限（10-2000）
批量清洗请求体： 
{
  "limit_users": 50,
  "max_scan": 200
}

​
会话管理

方法路径说明
GET/conversations分页会话列表
GET/conversations/{id}/messages会话消息回放

​
技能管理

方法路径说明
GET/skills全部技能列表
GET/skills/{skill_id}/versions技能版本历史
POST/skills/{skill_id}/disable全局禁用技能

​
工具管理

方法路径说明
GET/tools工具列表 + 使用统计
PATCH/tools/{source}/{name}启用/禁用工具
启用/禁用请求体： 
{
  "enabled": false
}
source 为 builtin 或 mcp，name 为工具名称。

​
日程管理

方法路径说明
GET/schedules分页日程列表
GET/schedules/delivery提醒投递统计

​
审计日志

方法路径说明
GET/audit分页审计日志（user_id, action, platform, details, timestamp）

​
反馈管理

方法路径说明
GET/feedbacks分页用户反馈列表

​
小程序配置

方法路径说明
GET/miniapp/home-popup获取首页弹窗配置
PUT/miniapp/home-popup更新首页弹窗
弹窗配置请求体： 
{
  "enabled": true,
  "title": "系统公告",
  "content": "新功能上线...",
  "show_mode": "once",
  "start_at": "2026-03-29T00:00:00",
  "end_at": "2026-04-05T00:00:00",
  "version": "1.0",
  "primary_button_text": "知道了"
}