Skip to content

阶段 7 实践代码示例

本目录包含阶段 7(工程化、评估与安全)的实践代码示例。

包含的项目

API 服务化

Agent API (agent_api.py) - FastAPI 实现 - RESTful 接口 - 认证中间件 - CORS 配置

日志和监控

结构化日志 (logging_config.py) - 日志配置 - 请求/响应记录 - 错误追踪

性能优化

性能工具 (performance.py) - 缓存机制 - 批量处理 - 速率限制

安全

安全验证器 (security.py) - 输入验证 - 输出清理 - 提示词注入检测

访问控制 (access_control.py) - API Key 管理 - 速率限制 - 权限控制

测试

单元测试 (test_agent.py) - Agent 测试 - Mock 使用 - 断言验证

性能测试 (performance_test.py) - 延迟测试 - 负载测试 - 性能指标

运行环境要求

pip install fastapi uvicorn
pip install python-dotenv
pip install pytest pytest-asyncio

使用方法

# 启动 API 服务
python agent_api.py

# 运行测试
pytest test_agent.py

# 性能测试
python performance_test.py

Docker 部署

# 构建镜像
docker build -t agent-api .

# 运行容器
docker run -p 8000:8000 agent-api

# 使用 docker-compose
docker-compose up

学习重点

  • API 设计
  • 安全防护
  • 性能优化
  • 测试策略
  • 部署方案

提示:这些示例代码在 阶段 7:工程化、评估与安全.md 文档中有详细说明。

附件下载:stage7_engineering_practice.ipynb