核心用法
Ragora 是面向企业知识管理的 RAG（检索增强生成）基础设施，提供两种集成方式：
MCP 协议（推荐）：通过 https://mcp.ragora.app/mcp 端点暴露动态工具集，包括 discover_collections()、search()、search_{slug}()、check_balance() 等，支持 IDE/Agent 原生调用。
REST API：https://api.ragora.app/v1 提供完整 HTTP 接口，适用于无 MCP 环境或需要细粒度控制（分页、元数据提取）的场景。
核心数据模型围绕 Collection（知识库）→ Document → Chunk 三级结构，支持语义搜索、版本管理、自定义标签过滤与元数据筛选。检索结果包含相关性评分、源文档溯源与用量计费信息。
显著优点
1. 双模接入灵活：MCP 工具绑定零代码集成，REST API 提供完整编程控制
2. 企业级溯源：每个答案片段附带 collection/document/chunk 三级来源，满足合规审计要求
3. 动态工具生成：根据用户可访问的知识库自动暴露 search_{slug}、get_topic_{slug} 等专用工具
4. 版本与过滤：支持文档版本切换（version）、标签过滤（custom_tags）、键值元数据筛选（filters）
5. 计费透明：自有知识库免费，marketplace 知识库按检索次数计费（美元计价），实时余额查询
潜在缺点与局限性
- 学习曲线：需理解 collection/slug/chunk 等概念，新手易混淆命名规范（slug 使用下划线而非连字符）
- 成本不确定性：marketplace 知识库按使用量计费，高频检索可能产生意外支出
- 速率限制：MCP 60次/分钟、REST 120次/分钟，高并发场景需设计退避策略
- 版本碎片化：多版本文档库需显式指定
version，否则可能检索到非预期版本 - MCP 依赖：首选 MCP 模式，若 MCP 服务不可用需手动降级到 REST，增加实现复杂度
适合人群
- 企业知识管理团队：需将分散的手册、合同、政策文档转化为可查询的知识库
- 合规与尽调分析师：需要源文档支撑的答案合成、跨文档对比与审计追踪
- 开发者/AI 工程师：构建需要 grounding 能力的 Agent 应用，替代纯 LLM 幻觉输出
- 法务与采购：合同条款比对、SLA 差异分析、供应商风险评估
常规风险
| 风险类型 | 说明 | 缓解建议 |
|---------|------|---------|
| 密钥泄露 | API Key 格式为 `sk_live_<uuid>`，创建时仅显示一次 | 存储于密钥管理系统，日志中掩码处理 `sk_live_****...` |
| 权限扩散 | 403 错误表明有密钥但无 collection 访问权 | 定期审计 marketplace 订阅，及时移除未使用权限 |
| 余额耗尽 | 402 错误导致服务中断 | 集成 `check_balance()` 前置检查，设置余额告警 |
| 速率超限 | 429 错误影响用户体验 | 实现指数退避重试，单任务控制查询频次 |
| 幻觉风险 | 低相关性结果（<0.6）被误信 | 强制要求来源引用，低置信度结果需标注 "推断性质疑" |
| 版本错误 | 未指定 version 检索到过期文档 | 关键查询前调用 `list_versions_{slug}()` 确认 |安全认证说明
来源可信度：T2（商业化 SaaS 产品，文档完整但未披露第三方渗透测试报告）
安全等级：S（标准 HTTPS/TLS 传输，API Key 认证，服务端 SHA-256+bcrypt 哈希存储，符合常规企业 SaaS 安全基线）