补刊说明:本文补齐原定学习日;资料与题目于 2026-11-21 检索核验。
前两周分别定义了 Runtime、ModelClient、检索、路由、预算和模型注册表。第 15 天把这些契约放进一个真的 HTTP 入口。目标不是再画一张“平台分层图”,而是让两个租户用同一句问题请求服务时,能看见各自的证据与 trace,并且无权访问另一方数据。
本文的代码使用本地假模型和假检索器,不需要 API Key;它验证的是服务控制流。真正的身份系统、并发预算和持久化任务会在接下来的文章补上。
一、先确定一条请求的责任边界
1 | HTTP 请求 |
熟悉 Spring Boot 的读者可以把 FastAPI 的依赖函数理解为请求级注入入口,把 Pydantic 请求模型理解为 DTO,把业务用例保留在路由函数外。FastAPI 官方文档说明请求体可由 Pydantic 模型验证,依赖函数可复用请求上下文;这两点是本文选择它做短练习的依据。FastAPI Request Body、Dependencies(检索日期:2026-11-21)
租户 ID 不从请求体读取。 请求体里的 tenant_id 是用户可改的输入;生产服务应从认证票据和授权服务得到租户范围,并在检索、缓存、预算、日志查询中传递同一上下文。
二、一个可以本地运行的最小服务
将下面内容保存为 app.py,在 Python 3.11+ 环境安装 fastapi 与 uvicorn,运行 uvicorn app:app --reload。这段代码故意只演示内存夹具,不能直接部署到生产。
1 | from typing import Annotated, Optional |
1 | python3 -m venv .venv |
把 demo-a 换成 demo-b,应得到 b-policy-v2,而不是 a-policy-v3。去掉授权头应返回 401。question 暂时只触发输入校验;假模型没有语义理解能力,不能把这次演练称为真实 RAG 质量评测。
三、让夹具逐步变成服务
| 当前夹具 | 下一步生产边界 |
|---|---|
| 内存 token 映射 | 验签、失效与租户成员授权;不能让客户端声明租户 |
| 内存文档列表 | 文档 ACL、知识快照、检索前过滤与引用复核 |
| 只看一个能力标志 | 模型注册表、端点参数、账号可用性和发布版本 |
| 内存预算减法 | 数据库原子预留、每次 attempt 结算与对账 |
| 一个响应里的 trace_id | 可查询的脱敏 span、版本和错误分类 |
尤其不能把 Python 模块级字典当作跨进程的共享账本:多 worker 会有多份状态,进程重启会丢失预算,两个并发请求也可能同时通过余额检查。第 17 天会用数据库事务替换这一层。若服务要执行数十秒任务,入口应只提交任务并返回任务 ID;HTTP 202 的含义是“已接收但尚未完成”,并不保证后来一定成功。RFC 9110 §15.3.3(检索日期:2026-11-21)
四、今天的实践与验收
- 跑通 A、B 两租户同 Query,记录响应中的引用 ID 和 trace ID。
- 注入第三个没有凭据的请求,确认无检索或模型调用。
- 把 A 的预算降到 0,确认拒绝发生在调用前;再写出为什么这个内存实现仍无法保证并发安全。
- 画出 Java 版 Controller、Service、Repository 与 Python 版 API、用例、适配器的对应关系;指出哪个层负责授权、哪个层负责引用复核。
提交证据应包含请求与响应、至少一条跨租户拒绝夹具、以及一页“生产缺口”清单。不要只截 Swagger 页面。
五、今日面试题(检索日期:2026-11-21)
题面来自可直接查看正文的牛客公开内容。公司归属仅为发帖者自述,未获企业官方核验;下述答案和追问是本文的工程整理。
1. 一个 Query 从进入 Agent 服务到输出结果,完整链路怎样讲?
- 方向 / 难度:AI 应用后端、系统设计 / 中高。
- 参考答案:从认证身份和租户开始,依次说明意图与任务创建、授权检索、能力路由、预算和限流、模型或工具调用、输出校验、事件和 trace。每层给出输入、输出与失败状态,不能只罗列框架名。
- 追问:模型输出了别的租户的证据 ID,在哪两层拦截?检索前授权和响应引用复核都要做。
- 来源:牛客“快手 AI 全栈开发一面”用户自述,原帖直接列出该题;企业归属未获官方核验。
2. FastAPI 接口和数据库层如何分工?为何不能把同步数据库调用直接塞进 async 路由?
- 方向 / 难度:Python 服务、数据库连接 / 中高。
- 参考答案:API 解析和鉴权,业务层决定状态,用请求级数据库会话完成事务;同步驱动会阻塞事件循环,选同步路由配线程池,或全链路异步驱动与独立 AsyncSession。模型网络调用不应占着数据库事务。
- 追问:多个并发子任务能共享一个 AsyncSession 吗?不能,共享有状态会话会让事务和连接使用混乱。
- 来源:牛客“美团 AI Agent 一面”社区模拟整理帖,标题明确为“三年面试五年模拟”,不是可核验的美团原题。
3. 多 Agent 之间的上下文如何隔离?
- 方向 / 难度:多租户 Agent、上下文安全 / 难。
- 参考答案:为每次任务传显式
tenant_id / principal_id / task_id,子 Agent 仅拿完成当前步骤需要的授权证据与工具,持久化记录按租户和任务分区;缓存键带权限和版本,不能共享可变全局上下文。模型不能自行提升权限。 - 追问:同一用户同时在两个租户工作,如何保证切换后旧任务仍按原租户审计?任务创建时固定授权上下文版本,并在敏感操作前重新验证。
- 来源:牛客“快手 AI 全栈一面”用户自述,正文列出“多 Agent 之间上下文怎么隔离”;企业归属未获官方核验。
资料与下一步
- FastAPI 请求体与依赖注入:输入模型、请求级依赖。
- RFC 9110 HTTP 202:异步任务接收语义。资料检索日期均为 2026-11-21。
第 16 天把这个同步夹具的入口收敛成可长期维护的任务 API:状态码、幂等键、错误契约和取消语义。