AdminAgentStatsController.php 1.3 KB

12345678910111213141516171819202122232425262728293031323334
  1. <?php
  2. namespace App\Http\Controllers\V3;
  3. use App\Http\Controllers\Controller;
  4. use App\Http\Requests\V3\ShowAdminStatsRequest;
  5. use App\Http\Resources\V3\AdminAgentStatsResource;
  6. use App\Services\V3\AgentStatsService;
  7. use App\Services\V3\StatsRange;
  8. /**
  9. * 管理后台 AI 对话统计(单例资源,仅 root / administrator)。新资源,没有 v2 前身。
  10. */
  11. class AdminAgentStatsController extends Controller
  12. {
  13. public function __construct(private readonly AgentStatsService $stats) {}
  14. /**
  15. * AI 对话统计
  16. *
  17. * 一次返回整页:指标(含上一同长区间作对比)、每日按研究路径的提问数与耗时分位数、
  18. * 客户端分布、工具调用 Top、积分流水。结果缓存 10 分钟。
  19. *
  20. * @queryParam from string 起始日(UTC,Y-m-d)。Default: 今天往前 29 天
  21. * @queryParam to string 结束日(UTC,Y-m-d,含当天)。Default: 今天
  22. * @queryParam account_type string 账号类型。Enum: all,user,guest。Default: all
  23. */
  24. public function __invoke(ShowAdminStatsRequest $request)
  25. {
  26. [$from, $to] = StatsRange::resolve($request->validated());
  27. return AdminAgentStatsResource::make($this->stats->stats($from, $to, $request->validated('account_type', 'all')));
  28. }
  29. }