POST /api/openai/v1/chat/completions
POST /api/open/v1/runs已有系统,
不必推倒重来。
从智能体调用、员工身份或企业能力交付中选择起点。
理解接口契约,也理解谁负责业务权限与执行结果。
OIDC + PKCE S256
POST /identity/introspectSKILL.md / scripts / references
window.hivePanel.getSystemContext(...)把身份带过去,
把业务权限留在业务系统。
系统资格、资源分配和业务权限分别检查。开放API Key留在服务端;短期业务身份不写入对话、日志或持久文件。网站上的示例地址和参数只用于说明协议。
REFERENCE & GUIDES从接口到实现,
从接口到实现,
按主题查阅。
示例说明前提、结果与错误处理,
不依赖内部联调环境。
开发对接4分钟
开发者接入总览
根据任务入口、业务身份和交付方式,选择适合自己的蜂巢接入路径。
阅读全文开发对接5分钟调用蜂巢开放API
用服务端Key提交智能体任务,正确读取普通回答和SSE流式结果。
阅读全文开发对接5分钟提交和管理异步长任务
提交后保存任务标识,通过轮询读取结果,并明确处理取消与HTTP等待超时。
阅读全文开发对接6分钟接入业务系统与统一身份
用OIDC确认网页登录身份,用短期业务Token和在线核验保护每次业务调用。
阅读全文开发对接5分钟编写和分发Skill
把工作说明、脚本和模板整理成Skill,并正确处理个人草稿、企业资源和市场版本。
阅读全文开发对接4分钟将MCP工具接入蜂巢
通过只读Streamable HTTP服务提供工具,选择认证方式并验证员工实际调用。
阅读全文开发对接7分钟开发业务面板
用HTML或ZIP交付业务页面,通过异步上下文接口和浏览器直连业务API。
阅读全文开发对接5分钟接入错误与排查
从HTTP状态、任务状态和业务身份逐步定位失败,避免重复执行与错误放行。
阅读全文