tool-sdk

一句话

让 AI 多一件能直接调的工具——查你家 ERP、调内部 BOM 计算 API、控制实验室设备等等。平台在调用时自动注入凭据、做参数校验、记审计日志，你只写"这个工具调起来时怎么干活"。

安装

发邮件要包

info@nox-lumen.com 申请 ragbase-tool-sdk。

pip install ragbase-tool-sdk

五分钟例子

ragbase-cli init tool my-erp-query
cd my-erp-query
vi src/my_erp_query/main.py

from ragbase.tool_sdk import Tool, tool_action
 
class ErpQueryTool(Tool):
    @tool_action(
        name="query_inventory",
        description="按物料号查库存",
        params={"material_code": "str, 物料号"},
    )
    def query_inventory(self, ctx, material_code: str):
        token = ctx.credentials["erp_api_key"]   # 平台运行时注入
        resp = ctx.http.get(
            f"https://erp.internal/inv/{material_code}",
            headers={"Authorization": f"Bearer {token}"},
        )
        return {"qty": resp.json()["available"]}

@tool_action 把 description / params 直接转成 LLM 能看见的工具描述——AI 就能学会自己调。

为什么要走 SDK 而不是让 AI 直接写 HTTP 调用

能力	直接 LLM 写 HTTP	tool-sdk
凭据注入	token 进 prompt（泄漏风险）	运行时注入，token 不进 LLM 上下文
参数校验	靠 LLM 自觉	Pydantic 校验，错就 reject
审计	没记录	每次调用进 ledger
重试 / 超时 / 限流	自己写	框架自带
租户隔离	自己管	平台帮你隔

行业例子

行业	工具点子
汽车	调内部 ASIL 评估 API；接 Vector vTESTstudio 查测试结果
制造	ERP 查库存 / BOM；MES 派工单；SCADA 查实时数据
办公	接内部审批 / HR / 财务系统 API

tool-sdk

一句话

安装

五分钟例子

为什么要走 SDK 而不是让 AI 直接写 HTTP 调用

行业例子

相关

On this page