2
0

AgentChargeController.php 2.6 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061
  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\StoreAgentChargeRequest;
  6. use App\Http\Resources\V3\AgentChargeResource;
  7. use App\Services\V3\AgentAccountService;
  8. use App\Services\V3\CreditService;
  9. /**
  10. * AI 对话的提问扣费。只给 agent 服务调(`auth.agent-service`),不对客户端开放。
  11. *
  12. * 新资源,没有 v2 前身。
  13. */
  14. class AgentChargeController extends Controller
  15. {
  16. use ResolvesCurrentUser;
  17. public function __construct(
  18. private readonly AgentAccountService $accounts,
  19. private readonly CreditService $credits,
  20. ) {}
  21. /**
  22. * 为一次提问扣费(幂等)
  23. *
  24. * 一次提问开始前由 agent 服务调用。先扣今日赠送,不够再扣积分余额;合计不够返回 402
  25. * (`type` 为 quota-exceeded,扩展字段 `reason`:insufficient 积分不足 / ip_cap 游客同 IP 超上限,
  26. * 另带 `cost`、`free_remaining`、`earned_balance`)。
  27. *
  28. * 账号口径与 `POST /v3/agent-traces` 相同:Bearer 是透传的终端用户 token,
  29. * 无效或缺省按游客算,此时 `device_id` 必填。按 run_id 幂等:首次 201,重复 200。
  30. * 服务端出错、回答没生成时,写研究过程那一步会自动退回。
  31. *
  32. * @responseStatus 201 首次扣费。响应体与 200 同形
  33. * @responseStatus 402 额度不足或游客同 IP 超上限
  34. * @responseStatus 403 thread_id 已经属于别的账号
  35. *
  36. * @bodyParam run_id string required AG-UI runId(uuid)
  37. * @bodyParam thread_id string AG-UI threadId(uuid)。已经属于别的账号时 403,不扣费
  38. * @bodyParam deep boolean 是否深度思考(价格不同)。Default: false
  39. * @bodyParam device_id string 设备匿名 id(uuid)。游客必填
  40. * @bodyParam client_ip string 客户端 IP(runtime 写入)。游客必填,没有就 422;只对游客用于同 IP 上限
  41. */
  42. public function store(StoreAgentChargeRequest $request)
  43. {
  44. $data = $request->validated();
  45. $account = $this->accounts->resolve($this->currentUserUid($request), $data['device_id'] ?? null);
  46. $this->accounts->assertThreadOwnable($account, $data['thread_id'] ?? null);
  47. $charge = $this->credits->charge(
  48. $account,
  49. $data['run_id'],
  50. (bool) ($data['deep'] ?? false),
  51. $data['client_ip'] ?? null,
  52. );
  53. return AgentChargeResource::make($charge)->response()->setStatusCode($charge['created'] ? 201 : 200);
  54. }
  55. }