API 参考已发布
知识库接入架构与 RAG 边界
RailWise 公开知识库独立混合检索与 RAG 服务的后续接入架构，以及当前公开层的使用边界。
API 参考WorkWiseRAILWISE-CLIai-geo-entrypointrag-service
适用场景ai-geo-entrypoint、rag-service
面向产品与 Agent 的检索服务是 RailWise 公开知识库的后续接入方向。该服务使用独立数据库、索引、模型、网络与密钥，不连接 RAILWISE-OS 内部知识库。当前公开站点尚未对外发布 RAG API。
| 层级 | 说明 |
|---|---|
| Source | 标准、项目模板、产品文档、案例复盘、专家笔记 |
| Wiki | Karpathy 式编译层，把原始资料整理为内部可读知识 |
| Public Docs | 审核后发布到 kb.railwise.cn 的公开页面 |
| Vector Index | 按段落、实体、场景和来源建立向量索引 |
| API / MCP | 为产品和 Agent 提供检索、引用和问答能力 |
接口草案，不是公开服务
Section titled “接口草案，不是公开服务”| 接口 | 用途 |
|---|---|
POST /api/v1/search |
关键词与向量混合检索 |
POST /api/v1/answer |
带引用的问答 |
GET /api/v1/doc/{slug} |
获取单篇文档结构化内容 |
GET /api/v1/graph/neighbors/{id} |
获取知识节点邻域 |
这些路由是内部架构草案，不构成对外可调用承诺。公开可用入口以 /llms.txt、/llms-full.txt、/AGENTS.md 与站点地图为准。
检索服务应支持按以下维度过滤：
- 场景：保护区、盾构、深基坑、桥梁、管廊。
- 产品：TSM、OS、CLI、WorkWise。
- 文档类型：标准速览、场景方案、工程方法、案例复盘、API 文档。
- 索引策略：full、metadata_only、excluded。
- 审核状态：published、review、draft。
公开 RAG 只摄取 Release A 校验通过的公开索引。内部 Wiki、客户项目数据和企业私有知识由独立的内部系统管理，公开服务不得连接其网络、目录、数据库、模型、密钥、日志或备份。