AdminAgentRunController.php 3.7 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283
  1. <?php
  2. namespace App\Http\Controllers\V3;
  3. use App\Http\Controllers\Controller;
  4. use App\Http\Requests\V3\IndexAdminAgentDigestRequest;
  5. use App\Http\Requests\V3\IndexAdminAgentRunRequest;
  6. use App\Http\Resources\V3\AdminAgentRunResource;
  7. use App\Http\Resources\V3\BaseResource;
  8. use App\Services\V3\AgentStatsService;
  9. use App\Services\V3\StatsRange;
  10. /**
  11. * 管理员查阅 AI 对话的提问与研究过程(仅 root / administrator)。新资源,没有 v2 前身。
  12. *
  13. * 也是评测脚本从库里抽题的读接口(只抽 improve=true 的)。
  14. */
  15. class AdminAgentRunController extends Controller
  16. {
  17. public function __construct(private readonly AgentStatsService $stats) {}
  18. /**
  19. * 列出提问
  20. *
  21. * 最新的在前。提问原文对管理员可见;游客只显示设备匿名 id 与 IP。
  22. *
  23. * @queryParam filter[status] string 运行结果。Enum: ok,error,cancelled,denied
  24. * @queryParam filter[route] string 研究路径:question 一般问题 / term 术语与词 / passage 阅读页提问 / chat 闲聊。Enum: question,term,passage,chat
  25. * @queryParam filter[account_type] string 账号类型。Enum: user,guest
  26. * @queryParam filter[client] string 客户端。Enum: mobile,web
  27. * @queryParam filter[improve] boolean 是否允许用于改进回答
  28. * @queryParam filter[q] string 按提问原文模糊搜索
  29. * @queryParam page integer 页码。Default: 1
  30. * @queryParam per_page integer 每页数量,最大 100。Default: 20
  31. */
  32. public function index(IndexAdminAgentRunRequest $request)
  33. {
  34. return AdminAgentRunResource::collection(
  35. $this->stats->listRuns($request->validated(), $request->integer('per_page', 20))
  36. );
  37. }
  38. /**
  39. * 分析用的精简导出
  40. *
  41. * 区间内允许用于改进回答(improve=true)的提问,最早的在前。不带任何身份(账号、设备、IP)。
  42. * 每条给:问题、路由与把握度、检索词、状态与耗时、工具调用序列、用户评价、隐式信号计数、
  43. * 同一会话里下一次提问隔了几秒;`full=true` 时再带回答、证据全文与引用,供 agent 评估回答质量
  44. * (服务端不做质量评估)。给 wikipali 插件的 `admin digest` 与分析技能用。
  45. *
  46. * @queryParam from string 起始日(UTC,Y-m-d)。Default: 今天往前 29 天
  47. * @queryParam to string 结束日(UTC,Y-m-d,含当天)。Default: 今天
  48. * @queryParam full boolean 是否带回答、证据全文与引用(此时 limit 最大 200)。Default: false
  49. * @queryParam limit integer 最多多少条,最大 2000(full 时 200)。Default: 500(full 时 100)
  50. *
  51. * @meta has_more boolean 区间内是否还有更多(超出 limit)
  52. */
  53. public function digest(IndexAdminAgentDigestRequest $request)
  54. {
  55. [$from, $to] = StatsRange::resolve($request->validated());
  56. $full = $request->boolean('full');
  57. $digest = $this->stats->digest($from, $to, $request->integer('limit', $full ? 100 : 500), $full);
  58. return BaseResource::collection($digest['items'])->additional(['meta' => [
  59. 'from' => $from->toDateString(),
  60. 'to' => $to->toDateString(),
  61. 'count' => count($digest['items']),
  62. 'has_more' => $digest['has_more'],
  63. ]]);
  64. }
  65. /**
  66. * 查看一次提问的研究过程
  67. *
  68. * 带回答、给作答 LLM 的证据全文、计划、引用与全部步骤(LLM / 工具调用、节点事件)。
  69. *
  70. * @urlParam run string required AG-UI runId(uuid)
  71. */
  72. public function show(string $run)
  73. {
  74. return AdminAgentRunResource::make($this->stats->showRun($run));
  75. }
  76. }