高效后端接口企业知识库问答提示词

角色定义与任务定位

请以「后端系统架构师」或「高级后端开发者」的身份，运用本方案。你的核心目标是：设计并实现一个用于企业内部知识库的高效、稳定、易维护的问答接口。这不仅仅是编写一个API，更是构建一个能理解复杂查询、精准检索知识、并结构化返回答案的智能服务流程。

适用场景

• 为企业内部Wiki、文档中心或项目知识库添加智能问答功能。
• 开发支持自然语言查询的API，供内部工具（如聊天机器人、IDE插件）调用。
• 优化现有搜索接口，提升其语义理解能力和答案的精准度。
• 设计技术支撑平台的用户自助服务接口。

核心提示词

以下提示词组合可直接用于定义接口行为或与大语言模型交互以生成代码逻辑：

• 流程控制指令：“请按以下步骤处理用户问题：1. 意图识别（判断为概念查询、操作指南、错误排查等）。2. 关键词提取与同义词扩展。3. 在[指定知识库索引]中进行多维度检索。4. 对检索结果进行相关性排序与置信度评分。5. 组织答案结构：直接答案+来源片段+相关链接。”
• 接口契约定义：“设计一个RESTful API端点 `/api/v1/knowledge/query`，请求体需包含 `query` (字符串)、`user_context` (可选，对象) 字段；响应体必须结构化，包含 `answer` (字符串)、`confidence` (浮点数)、`sources` (数组)、`suggested_questions` (数组)。”
• 错误处理逻辑：“当知识库中无确切答案时，接口不应返回404，而应提供：1. 基于知识库的近似答案提示。2. 建议的查询重构方式。3. 转接人工服务的入口或提示。”

风格方向

• 技术风格：严谨、模块化、面向日志与监控。代码与文档应体现清晰的输入、处理、输出三阶段。
• 响应风格：答案应直接、结构化、避免歧义。优先返回列表、步骤代码块或参数表格，而非长段描述。
• 交互风格：接口设计应具备引导性，例如通过 `suggested_questions` 引导用户深入提问。

构图建议（逻辑架构）

• 分层架构图：在设计中构想“用户层 - API网关层 - 意图处理层 - 检索层 - 知识源层”的清晰分层。
• 数据流图：明确数据从原始查询到结构化响应的流转路径，标注关键处理节点（如分词、向量化、排序）。
• 状态转换图：为复杂会话式问答设计查询状态（如澄清、确认、扩展）的转换逻辑。

细节强化

• 性能细节：引入“缓存策略”（对高频问题缓存答案）、“超时控制”（对长尾查询设置超时并返回已处理部分结果）。
• 安全与权限细节：在提示词中强调“接口需验证用户令牌，并根据权限过滤知识库中受控文档的内容”。
• 可观测性细节：设计提示词时需包含“记录每次查询的意图分类、检索耗时、置信度，用于后续分析与优化”。
• 扩展词：在核心逻辑外，可考虑“答案摘要生成”、“多轮对话上下文管理”、“答案时效性校验（基于文档更新时间）”等扩展点。

使用建议

• 将“核心提示词”中的流程指令作为接口核心处理逻辑的伪代码或需求描述直接使用。
• “风格方向”与“构图建议”用于撰写技术设计文档或绘制系统架构图时的核心思路。
• “细节强化”列表可作为代码审查清单或迭代优化时的功能备选，根据项目阶段优先级进行植入。
• 实际开发时，可将本方案整体作为需求输入给大语言模型，以生成更具体的某框架（如Spring Boot, FastAPI）下的代码骨架。