搜索你想找的开源项目

输入名称、用途或关键词,也可粘贴 GitHub 仓库链接

分享到微信

当前解读页的微信分享二维码

用微信扫一扫打开,点击右上角「···」分享给朋友或朋友圈。

手机上可截屏后,在微信扫一扫中从相册识别二维码。

openbkn-ai/bkn-foundry

AI 工程

把业务语义建模为本体,并为 AI 智能体提供受治理的上下文与可执行动作的开源后端。

1,399
139
Go
NOASSERTION
创建于 5 个月前

项目介绍

BKN Foundry 是 OpenBKN 的后端基础。它用基于 Markdown 的 BKN 语言把企业业务描述为数据、逻辑、风险和动作四类本体定义,再把这些定义变成智能体可用的运行时服务。适合要把内部系统和文档接入大模型、同时又要求权限与执行可控的团队。项目只有后端,没有自带 Web 控制台,所有操作都通过 CLI、SDK 或 API 完成。

后端由几个部分组成:Context Loader 负责召回和排序上下文,VEGA 负责屏蔽多源异构数据的差异,Exec Factory 编排工具、MCP 和技能,BKN Safe 把身份、权限和策略控制落到业务对象和动作级别,BKN Trace 支持从动作回溯到知识节点、数据源和工具。整体关系可参考参考架构。

README 给出了基于 145 条 HR 场景样本的对比测试,BKN Foundry 准确率为 99.31%,高于 Dify 和 RAGFlow 基线,并附有 schema 预加载、工具筛选等消融实验表。这些是作者在特定数据集上使用 DeepSeek V3.2 和 BGE M3-Embedding 报告的测量结果,不是独立评测;同一张表里它的平均延迟和 token 消耗也高于 BiSheng 基线。

快速使用

完整部署面向 Linux,通过独立仓库 openbkn-deploy 的脚本在 Kubernetes 上安装。在目标机器上克隆该仓库,先运行预检,再执行安装:

git clone https://github.com/openbkn-ai/openbkn-deploy.git
cd openbkn-deploy
chmod +x preflight.sh deploy.sh onboard.sh

sudo bash ./preflight.sh          # 仅检查;退出码 0 表示通过,1 表示失败,2 表示仅有警告
./deploy.sh openbkn install       # 或传入 --access_address 和 --api_server_address

预检脚本会检查内核、sysctl、containerd、kubectl、helm、Node 和 BKN CLI,可用 --fix 启动修复。安装脚本的 --access_address 是客户端访问地址,--api_server_address 是 Kubernetes API server 绑定的真实网卡 IP。安装后用 kubectl get nodes、kubectl get pods -A 和 ./deploy.sh openbkn status 验证。

安装完成后在同一台机器上运行引导脚本,注册 LLM 和 embedding 模型;完整安装还会创建测试业务用户并分配角色:

sudo bash ./onboard.sh

接着从 bkn-sdk 安装客户端 CLI 并登录:

npm install -g @openbkn/bkn-sdk
openbkn auth login https://<node-ip> -u test -p '<password>' -k
openbkn bkn list

-k 用于跳过新部署环境自签名证书的校验。onboard.sh 需要 sudo,因为它读取的是 sudo deploy.sh 写入 /root/.openbkn-ai/ 的配置;重复执行是安全的。可直接运行的端到端示例在 bkn-samples。

SDK 与 CLI

openbkn CLI 是主要入口:openbkn bkn list 列出知识网络,openbkn bkn search <kn-id> "query" 做语义检索,openbkn admin 管理用户、组织、角色、模型和审计日志。程序化接入可使用 TypeScript 客户端:

import { createClient } from "@openbkn/bkn-sdk";
const bkn = createClient({ baseUrl: "https://your-openbkn.com", token: process.env.BKN_TOKEN });
const networks = await bkn.kn.list({ limit: 10 });

在 SSH、CI 或容器环境中,CLI 支持 -u/-p 密码登录、从有浏览器的机器导出凭据后重放,以及 --no-browser 方式粘贴回调 URL 或授权码。还可以用 npx skills add https://github.com/openbkn-ai/bkn-sdk --skill openbkn 给兼容的智能体安装 openbkn 技能,之后由智能体代为操作平台。

使用约束

  • 完整安装面向 Linux;macOS 仅支持通过 kind 做本地开发。
  • 安装需要 Kubernetes 集群、containerd、kubectl、helm 和 Node,预检脚本会逐项检查。
  • 认证与授权始终开启;内置账号 system、admin、security、audit 遵循职责分离,运维人员应使用个人账号。
  • 新建用户会获得一次性返回的初始密码,首次登录必须修改。
  • 仓库按组件分别授权:部分文件使用 Apache 2.0,OpenBKN 新增文件使用附加条件的修改版 Apache 2.0,以 NOTICE 为准。

HotRepo 点评

在 2026-11-16 的 Go 日榜记录中,该项目为 1,398 Star(当天新增 48)、138 Fork,最好名次为第 9。这只是单日单榜的一次快照,说明当天进入了 Go 日榜前列,不能据此判断趋势。值得留意的是它自己的测试表:准确率超过 99%,但平均延迟和 token 消耗都高于 BiSheng 基线,说明架构在检索质量与推理成本之间做了取舍。对评估智能体本体后端的团队来说,这些基准和消融数据更适合作为在自己的数据上复现的起点,而不是直接采信的结论。

本文由 AI 根据项目 README 生成,更新于 ,以项目官方文档为准。

相关推荐

  1. NVIDIA/auto-ontology为企业数据库构建可人工认证的语义本体,让 LLM 智能体生成可校验的 SQL 并给出来源。Python12,983
  2. gogoymh/auto-ontology-mcp把数据库语义层和个人知识库封装成 MCP 服务器,让 AI 客户端用经过校验的 SQL 回答问题。Python105