新增的 OpenAPI 在线文档不需要额外的编译期工具,启动 Langhuan 后即可查看接口合同、认证方式和请求示例。开发者可以先在浏览器里理解资源边界,再把同一份合同带回自己的代码中。
从合同开始集成
Scalar 浏览器展示了真实运行时生成的 OpenAPI 文档,避免“文档写了一套、接口实现另一套”。文档里包含:
- workspace、knowledge base、document、job 等资源的请求与响应结构。
- Bearer 认证示例,以及与 API Key 页面对应的调用入口。
- 文档导入、状态查询、检索和删除等核心流程的参数说明。
- 错误响应和 workspace 隔离约束,减少把底层实现细节当成公共合同的风险。
管理能力开始成形
这一阶段也补齐了更多管理 API,收敛了对外暴露的接口范围,并把文档状态、删除行为和资源隔离统一到同一个 HTTP 边界里。API Key 页面现在可以直接跳转到在线文档,第一次接入不需要在仓库里来回寻找入口。
给自动化客户端的入口
REST API 适合脚本、后台服务和管理台;MCP over HTTP 继续提供面向工具调用的同一套知识库能力。两者共享 workspace 合同,方便把试验性的请求逐步升级成稳定的自动化流程。