阶段 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 文档中有详细说明。