问题与边界
一个内部助手需要把用户问题分类并返回结构化结果,但不能直接写入业务系统。先实现本地确定性函数,验证 API 契约和错误边界。
方案
FastAPI 负责 HTTP 和 schema,业务函数只返回 category、priority 和 needs_human。写操作暂存为 needs_human,客户端不能传入权限字段。
最小实现
from fastapi import FastAPI
from pydantic import BaseModel, Field
app = FastAPI()
class Request(BaseModel):
text: str = Field(min_length=1, max_length=4000)
class Decision(BaseModel):
category: str
needs_human: bool
@app.post('/classify', response_model=Decision)
def classify(request: Request) -> Decision:
lower = request.text.lower()
category = 'security' if 'password' in lower else 'general'
return Decision(category=category, needs_human=True)
复现步骤
- 安装 fastapi 和 uvicorn,保存上面的 app.py。
- 运行
uvicorn app:app --reload,访问 /docs 检查 schema。 - 发送正常、空文本和超长文本,确认 422 与结构化响应。
- 在业务接入前把所有写操作保持为 needs_human,并加入审计 id。
验证清单
验证超长输入被拒绝、输出字段稳定、客户端不能伪造管理员权限、服务重启后无状态丢失。
常见问题
本地函数是模型吗? 不是,它只用于验证接口契约;接入模型时仍需独立评测。
能把 needs_human 改成自动执行吗? 需要重新完成权限、审计和业务风险评审。
官方参考
最后核对日期:2026-11-16。版本、接口和安全边界以链接的官方资料为准;本文不虚构性能或费用结论。
