用途:为基于该模板构建的项目定义统一的代码结构与执行规则,把领域化 FastAPI、检索增强生成(RAG)与 Agentic AI 合并为一个后端应用,而非多个独立服务。
主要能力与规则:只有一个 src/ 包、一个 FastAPI 入口 src/main.py 和一套共享基础设施层;禁止创建第二个入口或额外 FastAPI() 实例。所有路由通过 src/api/v1/router.py 统一挂载。业务代码放在各自领域包内,共享层不重复定义:模型客户端在 src/llm/,内容安全在 src/guardrails/,外部服务客户端在 src/providers/。命名按职责而非厂商。agents/ 负责定义、cognition/ 负责思考、execution/ 负责执行与调度。测试镜像 src/,离线质量评估放在顶层 evaluation/,src/evaluation/ 只保留框架无关契约与适配器。
配套参考文档:写代码前需阅读 ASYNC_EXECUTION.md、PYDANTIC_STANDARDS.md、API_CONVENTIONS.md、GUARDRAILS.md、AI_EVALUATION.md、API_SECURITY.md、AGENT_SECURITY.md,分别覆盖异步执行、Pydantic 标准、API 约定、护栏、AI 评估与 API/Agent 安全。
状态标签:🟢 表示默认遵循的约定;🟡 表示需团队批准,须向用户呈现选项,不得静默选择。
限制:该规则不选择 Agent 框架、LLM 提供商、模型、向量存储或队列实现;若规则不符合实际需求,应向用户提出而非绕过。资料未提供安装命令、收费、价格、平台与具体使用步骤。