规则校验（Beta）

把协议、代码规范等材料中的强约束批量编译为 Rule，再让 Agent 根据具体任务召回规则、核对证据并调整行动。本教程以用户提供的开源许可证要求为例。

OpenViking 负责规则编译和适用性召回。是否满足或违反规则由 Agent 判断，搜索接口本身不返回合规结论。概念和生命周期见规则（Beta）。

前置条件

• 运行包含 Rule 功能的 OpenViking Server，配置可用的 Compiler 模型和 Embedding 模型。Compiler 默认复用服务端 VLM，也可以通过 rules.compiler 指定。
• 使用包含 rule_compile() 和 rule_search() 的 Python HTTP SDK，并配置当前用户的认证身份。编译和搜索应使用同一用户。
• 准备用户确认的强约束材料，保留原文的条件、例外和阈值。不要把普通建议或偏好当作规则。

模型配置见服务端 Rules 配置，连接约定见API 总览。以下代码按顺序运行，URL 和 API Key 替换为自己的配置。

第一步：提交规则材料

from openviking_sdk import SyncHTTPClient

client = SyncHTTPClient(url="http://localhost:1933", api_key="your-key")
task = client.rule_compile(
    instruction=(
        "仓库声明自己是开源项目时，"
        "必须提供明确、完整且可定位的项目许可证文本。"
    ),
)
print(task["task_id"])

批量导入文件或目录时，将上面的调用替换为：

task = client.rule_compile(options={"sources": ["./compliance-rules/"]})

SDK 会上传本地来源。已导入的资源可以直接使用 {"sources": ["viking://resources/compliance-rules"]}，避免重复导入。HTTP 来源格式见规则 API。

第二步：等待完成并检查产物

import time


def wait_for_task(task_id, timeout=300):
    deadline = time.monotonic() + timeout
    while time.monotonic() < deadline:
        current = client.get_task(task_id)
        if current is None:
            raise RuntimeError(f"Task not found: {task_id}")
        if current["status"] == "completed":
            return current
        if current["status"] in {"failed", "cancelled"}:
            raise RuntimeError(current)
        time.sleep(1)
    raise TimeoutError(f"Task still running: {task_id}")


completed = wait_for_task(task["task_id"])
result = completed["result"]
print(result["operations"])
print(result["written_uris"])

# 编译完成与写入后的索引处理可能属于不同任务。
write_task_id = result.get("write_result", {}).get("task_id")
if write_task_id:
    wait_for_task(write_task_id)

for uri in result["written_uris"]:
    print(client.read(uri))

检查生成规则是否保留了主体、义务、条件和例外，以及原文证据。UNCERTAIN 和 REJECT 只记录原因；NOOP 表示已有规则覆盖输入。超时只停止本地等待，不取消服务端任务。

第三步：按具体任务搜索

先读取审查对象，再把目标、对象、计划动作和已有证据组织为 task_context。以下内容是示例事实，使用时替换为实际读取的内容：

matches = client.rule_search(
    task_context=(
        "只读检查一个仓库的开源许可证。"
        "已读取 README.md，其中声明项目开源；"
        "根目录存在 LICENSE，尚未检查其正文。"
        "接下来计划读取许可证文本并核对完整性。"
    ),
)
print(matches["rendered"])
print(matches.get("warning"))

把完整的 rendered 交给 Agent；直接对接 API 的应用还应检查 judge、warning 和 scenario_selection。Jev 不可用时可能放行候选，不能把放行分数当作已确认适用的概率。

第四步：Agent 逐条核验

Agent 对每条返回规则执行以下步骤：

1. 用当前任务证据检查 applies_when，不推断缺失的事实；空条件表示除例外外均适用。
2. 检查明确例外，再对照 content 核验拟执行动作或回答。
3. 对于审查任务，记录规则标识、来源与对象证据，区分已满足、违反和证据不足。规则已满足也应纳入适用规则。
4. 新事实实质改变适用场景时，再次搜索。

本例中，README 的声明触发规则；LICENSE 文件存在还不足以确认文本完整，应继续读取。空结果不代表没有相关规则，也不构成“校验通过”。

接入已有 Agent

VikingBot 已提供 openviking_rule_search 工具（Beta），连接 OpenViking 后可按需调用。

其他 Agent 可以使用 Python HTTP SDK 或 HTTP API，并安装配套 Skill。将完整目录放入 Agent 配置的 Skills 目录，再让 Agent 加载：

任务	配套 Skill
准备来源、编译并检查结果	add-rules
组织任务上下文、召回并核验规则	openviking-rule-search

Skill 提供操作与行为要求；Agent 仍需具备可调用的接口。当前 Beta 通过用户或 Agent 主动调用使用。

相关文档

• 规则（Beta）
• 规则 API（Beta）
• 后台任务
• 应用开发路径