选择部署路径
如果你只需要使用别人提供的服务地址和 API Key，直接连接 CLI或接入 Agent。下面的路径面向服务部署与运维人员。
| 部署目标 | 阅读顺序 | 完成标准 |
|---|---|---|
| 本地体验 | 快速开始 | 导入一份文档，检索并读取其中的内容 |
| 自建共享服务 | 自建服务 → 身份认证 → 公网访问 | 验证持久化、授权访问、未授权拒绝和首次数据处理 |
| 企业私有化交付 | 部署前检查 → 安装与验收 → 升级与排障 | 按交付物清单与安装指南逐项验收 |
企业私有化路径依赖交付物、镜像和环境条件，先核对清单。
配置模型与访问控制
首次设置模型，使用配置模型与服务；查某个字段，使用服务端配置字段。服务端 ov.conf 与客户端 ovcli.conf 的职责不同，客户端字段见客户端配置。
开放远程访问前完成身份认证和反向代理配置。需要 OAuth 的 MCP 客户端继续阅读 OAuth 2.1。多用户共享时，理解多租户身份和 ACL 继承；需要静态数据加密时，按加密指南配置。
运行后如何检查
先从观测与排障入口选择工具。单次请求看操作遥测，时间趋势看 Prometheus / Grafana，指标含义查指标口径。常见问题见FAQ。