openbkn skillA
openbkn is agent-read markdown (skill) from openbkn-ai/bkn-sdk: 操作 BKN（Business Knowledge Network）平台的统一 CLI `openbkn` —— 知识网络 构建/查询（Schema：对象/关系/行动类型、指标、概念组；实例与语义搜索； push/pull/validate；从 Vega Catalog 建网）、资源、Vega Catalog 与 索引构建任务、Context Loader（MCP 检索）、模型工厂（大模型/小模型 CRUD、OpenAI 兼容对话/embedding/ rerank）、Skill 注册（zip 注册/下载/安装 + 生命周期）、Toolbox/Tool（上传、 导入导出、调用）、BKN Trace（第三方 Agent 受管 Conversation / Interaction / Operation、拉取 spans、用符号 规则 + LLM rubric 判定诊断一条 trace、scan、eval-set 构建、schema 校验）、 以及运营面（`openbkn admin`：组织/用户/角色 CRUD、审计、模型管理）与认证 （token + OAuth 密码/浏览器）。 当用.
Indexed from public GitHub and served as immutable, content-addressed versions. Install it pinned to an exact SHA-256 with the mdr CLI, and every file is verified against the hash recorded here before it reaches your agent. The deterministic audit below grades the latest version, and the same file always earns the same grade.
What the file says
# openbkn CLI
BKN 平台的统一命令行工具 —— 一个二进制，运维面收进 `openbkn admin` 子命令。
纯后端，无 Web UI。
## 第三方 Agent 业务问答硬门禁
- **业务问答必须受管**：每轮先调用 `bkn_start_interaction`，必传 `question`、`agent_name`（每轮同一名称）和 `conversation_mode`：首轮用 `new` 且不传 `conversation_id`，后续轮次用 `continue` 并传上一轮返回的 `conversation_id`。
- **只用权威 ID**：业务工具逐字使用 start 返回的 `conversation_id` 和 `interaction_id`，不得虚构、猜测或沿用示例值。
- **业务调用保持受管**：只通过携带上述 ID 的 Context Loader 工具访问 OpenBKN，Operation、重试和证据闭包由平台管理。
- **提交本轮结果**：回答生成后调用 `bkn_finish_interaction`；它只提交当前 Interaction 的结果，不关闭 Conversation。
- **错误即停止**：返回原始错误并遵循 `required_action`，不得降级到 CLI、Vega、ontology-query 或无受管上下文的调用。
详细合同见 [context.md](references/context.md)。
## 安装
```bash
npm install -g @openbkn/bkn-sdk # 提供 `openbkn` 命令
```
需 Node.js 22.19.0+。也可用 `npx @openbkn/bkn-sdk` 临时运行。
## 使用方式
```bash
openbkn [--base-url <url>] [--token <tok>] [--user <id|name>] \
[--json | --compact] [-k|--insecure] <group> <sub> [options]
```
- 默认输出为**人类可读表格**；`--json`（或 `--compact`）输出可被脚本解析的精确 JSON。
- `-k/--insecure` 关闭 TLS 校验（自签名平台）。`auth login -k` 会按平台记住，之后该平台的命令无需再带；免校验只作用于该平台的请求，不碰进程全局，无需 `NODE_TLS_REJECT_UNAUTHORIZED`。
…Read the whole file at its exact version.
How to install
mdr add openbkn-ai/bkn-sdk/openbkn@git:20260918.d7f989amdr add openbkn-ai/bkn-sdk/openbkn@sha256:829ca2ddd4612030Pin to a label to follow the author's releases, or to a sha256 to freeze the exact bytes forever. Either way the resolved hash is written to mdr.lock, and mdr install reproduces it on any machine.
[](https://markdownregistry.com/a/art_w4qucpcy234uewwc)
1 badge views in 30 days
Versions
| version | committed | commit | size | audit | |
|---|---|---|---|---|---|
| git:20260918.d7f989a latest | 2026-09-18 | d7f989a | 14,322 B | A | view · diff |
| git:20260917.2bcf0e9 | 2026-09-17 | 2bcf0e9 | 13,846 B | A | view · diff |
| git:20260917.a132d44 | 2026-09-17 | a132d44 | 12,736 B | A | view · diff |
| git:20260917.cdc4c16 | 2026-09-17 | cdc4c16 | 12,646 B | A | view · diff |
| git:20260914.822ed20 | 2026-09-14 | 822ed20 | 12,442 B | A | view |
Audit of the latest version
- pass: Frontmatter block present
- pass: Frontmatter declares a name
- pass: Frontmatter declares a description
- pass: Size between 200 bytes and 200 KB (14322 bytes)
- pass: No zero-width or bidi control characters
- pass: No instruction hidden inside an HTML comment
- pass: No link to an exfiltration or paste host
- pass: No credential-shaped string
- pass: No instruction to send local credentials anywhere
- pass: No text hidden with inline styles
- pass: No prompt-injection phrasing
- pass: No curl or wget piped into a shell
- pass: No recursive delete of root, home or parent
- pass: No instruction to read or print local credentials
- pass: No base64 blob over 200 characters
- pass: No link to a raw IP address
- pass: No script tag
Source
openbkn-ai/bkn-sdk · 17 stars · license Apache-2.0 · pushed 2026-09-23 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_w4qucpcy234uewwc GET https://markdownregistry.com/api/v1/resolve?ref=openbkn-ai/bkn-sdk/openbkn GET https://markdownregistry.com/api/v1/blob/829ca2ddd461203041523b8bed26556ace2301464af302252f3ec3787268fdd4
Your agent does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.