FastAPI 是目前 Python 最流行的做 API 的框架，特点正好命中我们前两天学的：

• 快、天生异步：底层就是 Day 08 的 async，扛并发强；
• 自带数据校验：靠 pydantic 自动检查请求数据对不对（L04）；
• 自动生成文档：白送一个交互式接口文档页 /docs（L06）；
• Agent 生态标配：后面你把 Agent 部署上线，几乎都是包成 FastAPI 服务。

# 存成 main.py
from fastapi import FastAPI

app = FastAPI()                       # 造一个应用，就是“这家店”本体

@app.get("/")                         # 有人 GET 访问根路径 "/" 就跑下面这个函数
def home():
    return {"message": "你好，这是我的第一个服务"}   # 返回字典，FastAPI 自动转成 JSON

@app.get("/hello/{name}")             # {name} 是路径参数，会自动接住
def hello(name: str):                 # name: str 声明类型，FastAPI 据此校验
    return {"greeting": f"你好，{name}"}

# 在 main.py 所在目录运行：
uvicorn main:app --reload
#        └────┬───┘ └──┬───┘
#         文件名:变量名  --reload=你改代码后自动重启(开发期很爽)

# 看到这行就成功了：
# Uvicorn running on http://127.0.0.1:8000

现在服务在跑了。用昨天学的 requests 或浏览器都能访问——你昨天当"顾客"调的接口，今天变成了你自己"开的店"：

from pydantic import BaseModel

class AskRequest(BaseModel):          # 继承 BaseModel，就成了一个“数据模型”
    question: str                     # 必填，字符串
    max_words: int = 100              # 可选，整数，不填默认 100
    # 客户端发来的 JSON 会被自动校验并转成这个对象

from fastapi import FastAPI
from pydantic import BaseModel

app = FastAPI()

class AskRequest(BaseModel):
    question: str
    max_words: int = 100

@app.post("/ask")                     # 有人 POST /ask 就跑这个
def ask(req: AskRequest):             # 参数类型写成模型，FastAPI 自动解析+校验请求体
    # 这里将来会换成“调大模型”，现在先用假逻辑演示
    answer = f"（示例回答）你问的是：{req.question}，限 {req.max_words} 字"
    return {"answer": answer, "length": len(answer)}   # 返回字典 → 自动转 JSON

用 Day 07 的 requests 来调自己刚开的这家"店"，闭环就成了：

import requests

resp = requests.post("http://127.0.0.1:8000/ask",
                     json={"question": "什么是 Agent？", "max_words": 30},
                     timeout=10)
print(resp.status_code)               # 200
print(resp.json()["answer"])          # （示例回答）你问的是：什么是 Agent？，限 30 字

它解决了真实开发里一个大痛点：前端/同事不用问你"这接口咋调"，打开 /docs 自己就看明白了。这也是把 Agent 交付给别人时最省事的"说明书"。

✋ 动手：15 行代码开一家自己的"店"

# 1. 安装（含 uvicorn）
pip install "fastapi[standard]"

# 2. 存成 main.py
from fastapi import FastAPI
from pydantic import BaseModel

app = FastAPI()

class AskRequest(BaseModel):
    question: str
    max_words: int = 100

@app.get("/")
def home():
    return {"status": "ok", "hint": "打开 /docs 试试"}

@app.post("/ask")
def ask(req: AskRequest):
    return {"answer": f"你问了：{req.question}", "limit": req.max_words}

# 3. 启动服务
uvicorn main:app --reload

# 4. 浏览器打开这个地址，直接在网页上点 Try it out 调你的接口：
#    http://127.0.0.1:8000/docs

进阶挑战：再加一个 @app.get("/health") 返回 {"ok": True}（真实线上服务几乎都有这么个"健康检查"接口，供监控探活）。刷新 /docs 看它自动出现在文档里。