Day 3：FastAPI 如何把 Python 业务能力封装成可被 Agent 调用的接口

• 能围绕“FastAPI 如何把 Python 业务能力封装成可被 Agent 调用的接口”讲清楚是什么、为什么、怎么用、项目里怎么落地。
• 能完成当天实战任务：合同收款汇总 FastAPI 接口原型。
• 能把当天知识点关联到你的AI应用岗位定位：AI工程师、AI Agent应用工程师、AI解决方案顾问。
• 能用业务场景表达技术，不只背概念。
• 能拿出当天产物 day03_fastapi_contract_api.py 作为面试证据。

如果原视频分P标题变化，请按模块关键词人工定位；不要全刷。

3.1 FastAPI应用实例

AI 工程里为什么必须会：FastAPI应用实例 不是孤立概念，它会影响接口参数、JSON结构、工作流节点、Agent工具、RAG结果或制造业业务数据能否被稳定处理。

项目里怎么用：在“合同收款汇总 FastAPI 接口原型”中，我要用它解决：把Day01合同汇总能力升级成HTTP接口，让悟空/DEAP/Agent可以通过请求获取结果。

面试时怎么说：我会把 FastAPI应用实例 放到业务场景里讲，先说明它解决什么问题，再说明它如何支撑 FastAPI、RAG、Agent、悟空/DEAP 或 AI表格的落地。

面试官追问怎么答：如果被追问，我会补充它的输入、输出、异常情况和工程边界，避免只背定义。

3.2 GET查询接口

AI 工程里为什么必须会：GET查询接口 不是孤立概念，它会影响接口参数、JSON结构、工作流节点、Agent工具、RAG结果或制造业业务数据能否被稳定处理。

项目里怎么用：在“合同收款汇总 FastAPI 接口原型”中，我要用它解决：把Day01合同汇总能力升级成HTTP接口，让悟空/DEAP/Agent可以通过请求获取结果。

面试时怎么说：我会把 GET查询接口 放到业务场景里讲，先说明它解决什么问题，再说明它如何支撑 FastAPI、RAG、Agent、悟空/DEAP 或 AI表格的落地。

面试官追问怎么答：如果被追问，我会补充它的输入、输出、异常情况和工程边界，避免只背定义。

3.3 POST分析接口

AI 工程里为什么必须会：POST分析接口 不是孤立概念，它会影响接口参数、JSON结构、工作流节点、Agent工具、RAG结果或制造业业务数据能否被稳定处理。

项目里怎么用：在“合同收款汇总 FastAPI 接口原型”中，我要用它解决：把Day01合同汇总能力升级成HTTP接口，让悟空/DEAP/Agent可以通过请求获取结果。

面试时怎么说：我会把 POST分析接口 放到业务场景里讲，先说明它解决什么问题，再说明它如何支撑 FastAPI、RAG、Agent、悟空/DEAP 或 AI表格的落地。

面试官追问怎么答：如果被追问，我会补充它的输入、输出、异常情况和工程边界，避免只背定义。

3.4 Swagger接口文档

AI 工程里为什么必须会：Swagger接口文档 不是孤立概念，它会影响接口参数、JSON结构、工作流节点、Agent工具、RAG结果或制造业业务数据能否被稳定处理。

项目里怎么用：在“合同收款汇总 FastAPI 接口原型”中，我要用它解决：把Day01合同汇总能力升级成HTTP接口，让悟空/DEAP/Agent可以通过请求获取结果。

面试时怎么说：我会把 Swagger接口文档 放到业务场景里讲，先说明它解决什么问题，再说明它如何支撑 FastAPI、RAG、Agent、悟空/DEAP 或 AI表格的落地。

面试官追问怎么答：如果被追问，我会补充它的输入、输出、异常情况和工程边界，避免只背定义。

3.5 Agent调用API

AI 工程里为什么必须会：Agent调用API 不是孤立概念，它会影响接口参数、JSON结构、工作流节点、Agent工具、RAG结果或制造业业务数据能否被稳定处理。

项目里怎么用：在“合同收款汇总 FastAPI 接口原型”中，我要用它解决：把Day01合同汇总能力升级成HTTP接口，让悟空/DEAP/Agent可以通过请求获取结果。

面试时怎么说：我会把 Agent调用API 放到业务场景里讲，先说明它解决什么问题，再说明它如何支撑 FastAPI、RAG、Agent、悟空/DEAP 或 AI表格的落地。

面试官追问怎么答：如果被追问，我会补充它的输入、输出、异常情况和工程边界，避免只背定义。

产物目录：/Users/hejunkai/Documents/AI工程师/28天每日背诵文档/Day03_FastAPI接口_实战项目

核心文件：day03_fastapi_contract_api.py

from fastapi import FastAPI
from pydantic import BaseModel

app = FastAPI(title="合同收款汇总API")

class ContractSummaryRequest(BaseModel):
    team_name: str
    month: str

@app.get("/health")
def health():
    return {"status": "ok"}

@app.post("/contracts/summary")
def summarize_contracts(req: ContractSummaryRequest):
    # 演示数据，真实项目可替换为数据库、AI表格或ERP接口
    records = [
        {"team_name": "星辰战队", "month": "2026-04", "contract_amount": 480000, "paid_amount": 320000},
        {"team_name": "星辰战队", "month": "2026-04", "contract_amount": 260000, "paid_amount": 260000},
        {"team_name": "先锋战队", "month": "2026-04", "contract_amount": 390000, "paid_amount": 100000}
    ]
    matched = [r for r in records if r["team_name"] == req.team_name and r["month"] == req.month]
    return {
        "team_name": req.team_name,
        "month": req.month,
        "contract_count": len(matched),
        "total_contract_amount": sum(r["contract_amount"] for r in matched),
        "total_paid_amount": sum(r["paid_amount"] for r in matched),
        "total_unpaid_amount": sum(r["contract_amount"] - r["paid_amount"] for r in matched)
    }

# 运行：uvicorn day03_fastapi_contract_api:app --reload
# 浏览器打开：http://127.0.0.1:8000/docs

验收目标：能打开 /docs，测试 POST /contracts/summary，并解释该接口如何变成Agent工具。

1. 面试官可能问：你怎么理解FastAPI接口在AI工程里的作用？
   候选人现场回答版：我会从业务场景讲：把Day01合同汇总能力升级成HTTP接口，让悟空/DEAP/Agent可以通过请求获取结果。。FastAPI接口的价值是把这个问题变成可执行、可验证的工程流程。
2. 面试官可能问：这个知识点和你的简历项目有什么关系？
   候选人现场回答版：它可以对应我的悟空/DEAP技能、FastAPI接口、RAG知识库、Agent工具或制造业多系统Agent项目。
3. 面试官可能问：你能现场展示什么？
   候选人现场回答版：我可以展示当天产物 day03_fastapi_contract_api.py，说明输入、处理过程、输出和后续升级路径。
4. 面试官可能问：它如何升级成Agent Tool？
   候选人现场回答版：先封装成函数或API，再定义工具名称、描述和参数Schema，让Agent在合适场景调用。
5. 面试官可能问：它如何接入悟空/DEAP？
   候选人现场回答版：通过工作流节点传入参数、调用API或读取AI表格，再把结果交给模型生成回复或报告。
6. 面试官可能问：如果数据错了怎么办？
   候选人现场回答版：先检查字段映射、数据类型、接口返回、日志和测试集，必要时转人工确认。
7. 面试官可能问：如何向非技术客户解释？
   候选人现场回答版：我会用业务语言说它如何减少手工整理、提升响应速度、让数据分析可追溯。
8. 面试官可能问：它和制造业有什么关系？
   候选人现场回答版：制造业ERP/MES/WMS/财务数据都需要通过结构化数据、接口、工具和工作流连接起来。
9. 面试官可能问：你目前做到什么程度？
   候选人现场回答版：我会如实说明是学习验证、原型、联调还是可演示项目，不编造上线效果。
10. 面试官可能问：你如何证明自己掌握了？
    候选人现场回答版：我能讲清原理，完成合同收款汇总 FastAPI 接口原型，并把它映射到真实AI应用场景。