← 返回學習路線

此章節尚未完成繁體中文或英文審核,目前顯示簡體中文原文。

案例 · 已發布

实战:FastAPI 结构化 AI 接口 (原文)

用 Pydantic schema、错误码和人工确认状态搭建可测试的应用接口。

來源: knowledge/p24-c/collection_0587a2bfc47ea3584d1b1c59/cases/structured-ai-api-with-fastapi.mdAI 應用開發
本章閱讀進度 0%學習路線進度 0% · 0/10 已完成章節繼續學習路線 →

问题与边界

一个内部助手需要把用户问题分类并返回结构化结果,但不能直接写入业务系统。先实现本地确定性函数,验证 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)

复现步骤

  1. 安装 fastapi 和 uvicorn,保存上面的 app.py。
  2. 运行 uvicorn app:app --reload,访问 /docs 检查 schema。
  3. 发送正常、空文本和超长文本,确认 422 与结构化响应。
  4. 在业务接入前把所有写操作保持为 needs_human,并加入审计 id。

验证清单

验证超长输入被拒绝、输出字段稳定、客户端不能伪造管理员权限、服务重启后无状态丢失。

常见问题

本地函数是模型吗? 不是,它只用于验证接口契约;接入模型时仍需独立评测。

能把 needs_human 改成自动执行吗? 需要重新完成权限、审计和业务风险评审。

官方参考

FastAPI;Pydantic models。

最后核对日期:2026-11-16。版本、接口和安全边界以链接的官方资料为准;本文不虚构性能或费用结论。

延伸閱讀

知識AI 自動化工作流程設計與實踐知識AI Agent:從基礎概念到實際應用知識大型語言模型 API 串接與成本最佳化
產品中心 Demo · V0.3