OpenAgent OS 开发者文档

软硬件无关的企业级智能体 & 知识库平台。三条铁律: 模型相关代码必经 LLM 网关、云端只认协议帧不认芯片、 协议 v1 冻结后只增不改。

平台全景

设备接入WebSocket 协议 v1.2(17 条控制信令 + 二进制音频帧),一机一码鉴权
开放 APIPOST /open/v1/chat、GET /open/v1/models(X-API-Key,OpenAI 风格)
管理面/api/v1/…(Bearer,RBAC 6 角色 × 12 权限)+ 控制台 /console/
LLM 网关/llm/v1/chat/completions、/llm/v1/models(OpenAI 兼容,failover + 渠道路由)
知识库/rag/v1/search(BM25 + 向量 RRF,引用溯源)
可观测/stats · /healthz

推荐阅读路径

你是谁路径
业务开发者(对接对话能力)快速开始 → 开放 API
硬件工程师(做智能硬件)设备接入 → 协议 v1.2 → C/Python SDK
知识管理(企业语料)知识库 RAG(上传→发布→回滚)
平台运维 / 私有化私有化部署 → LLM 网关

30 秒体验

# 控制台注册 → 「API 密钥」创建密钥后:
curl -s https://openagent-os.com/open/v1/chat \
  -H "X-API-Key: $OA_KEY" -H "Content-Type: application/json" \
  -d '{"message": "你好,介绍一下你自己"}'