2
0

MeAgentThreadController.php 3.0 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889
  1. <?php
  2. namespace App\Http\Controllers\V3;
  3. use App\Http\Controllers\Concerns\ResolvesCurrentUser;
  4. use App\Http\Controllers\Controller;
  5. use App\Http\Requests\V3\IndexMeAgentThreadRequest;
  6. use App\Http\Requests\V3\UpdateMeAgentThreadRequest;
  7. use App\Http\Resources\V3\AgentThreadResource;
  8. use App\Services\V3\AgentThreadService;
  9. use Illuminate\Http\Request;
  10. /**
  11. * 当前登录用户的 AI 对话会话历史(web chat 与 mobile 共用)。
  12. *
  13. * 游客没有历史接口:设备 id 不是秘密,不能凭它读别人的提问。
  14. * `{thread}` 是 AG-UI threadId;别人的会话与不存在的一样回 404。
  15. *
  16. * 新资源,没有 v2 前身(v2 的 `chats` / `chat-messages` 是另一套、未启用的表)。
  17. */
  18. class MeAgentThreadController extends Controller
  19. {
  20. use ResolvesCurrentUser;
  21. public function __construct(private readonly AgentThreadService $threads) {}
  22. /**
  23. * 列出我的会话
  24. *
  25. * 最近提问的在前,不含已删除的。
  26. *
  27. * @queryParam filter[archived] boolean 只看已存档(true)或未存档(false)的;不传则全部
  28. * @queryParam page integer 页码。Default: 1
  29. * @queryParam per_page integer 每页数量,最大 100。Default: 30
  30. */
  31. public function index(IndexMeAgentThreadRequest $request)
  32. {
  33. return AgentThreadResource::collection($this->threads->listForUser(
  34. $this->currentUser($request)['user_uid'],
  35. $request->validated(),
  36. $request->integer('per_page', 30),
  37. ));
  38. }
  39. /**
  40. * 查看一个会话
  41. *
  42. * 带全部可见的问答轮次(runs),按提问先后排;被「重新生成」替换掉的轮次不返回。
  43. *
  44. * @urlParam thread string required AG-UI threadId(uuid)
  45. */
  46. public function show(Request $request, string $thread)
  47. {
  48. return AgentThreadResource::make(
  49. $this->threads->showForUser($this->currentUser($request)['user_uid'], $thread)
  50. );
  51. }
  52. /**
  53. * 修改会话(目前只有标题)
  54. *
  55. * @urlParam thread string required AG-UI threadId(uuid)
  56. *
  57. * @bodyParam title string 会话标题,1–255 字
  58. */
  59. public function update(UpdateMeAgentThreadRequest $request, string $thread)
  60. {
  61. return AgentThreadResource::make($this->threads->update(
  62. $this->currentUser($request)['user_uid'],
  63. $thread,
  64. $request->validated(),
  65. ));
  66. }
  67. /**
  68. * 删除会话
  69. *
  70. * 软删:会话连同它的问答一起从我的历史里消失,之后任何接口都读不到;服务器上的数据永久保留(防滥用、改进回答)。
  71. * 返回软删后的会话本身(200,`deleted_at` 非空),不是 204。
  72. *
  73. * @urlParam thread string required AG-UI threadId(uuid)
  74. */
  75. public function destroy(Request $request, string $thread)
  76. {
  77. return AgentThreadResource::make(
  78. $this->threads->hide($this->currentUser($request)['user_uid'], $thread)
  79. );
  80. }
  81. }