TReg 零配置分布式工具注册表与协议网关

TReg 零配置分布式工具注册表与协议网关

@superdesigndev/treg·v1.0.5·tools

面向异构微服务工具集成的零配置注册表与网关。支持动态 RPC 接口挂载、JSON Schema 自动类型反射、命名空间冲突仲裁与工具级安全速率熔断。

工具注册表 · 微服务网关 · Schema反射 · 熔断限流

GitHubNPM
快速安装与集成
bash
manager:
$ pnpm add @superdesigndev/treg

架构解析

「TReg Tool Registry」让海量微服务接口无缝化身为智能体的可用工具。在大型分布式系统中,各个团队使用不同语言开发业务服务,手动为每个端点手写繁琐的工具描述(Tool Definitions)费时费力且极易出错。 本插件通过在 Cordis 总线上暴露自适应服务发现通道,支持远程 gRPC、REST 或 GraphQL 端点主动注册并上报能力清单。系统会自动将函数入参反射为严格符合大模型 Tool Call 规范的 JSON Schema,并提供多租户命名空间隔离与异常降级策略,大幅降低智能体接入企业后端的能力门槛。

核心特性

01

零配置自动反射契约:支持从 TypeScript 接口或 OpenAPI 文档一键推导工具参数

02

跨语言异构服务畅联:无论是 Go、Java、Python 还是 Node.js 后端均可无感挂载

03

细粒度速率与配额管控:支持按具体工具维度单独限制每秒并发(QPS)与调用预算

04

多环境动态路由切换:支持根据会话标签自由切换调用本地、测试或生产环境服务

核心机制

01

远程端点自注册

微服务通过 HTTP/gRPC 心跳上报自身可用函数签名与访问凭证要求。

02

Schema 自动反射编译

动态将方法参数反射为无歧义的严格 JSON Schema 与提示词描述。

03

命名空间路由与隔离

对同名函数添加租户与团队前缀修饰,杜绝工具集重叠冲突。

04

调用代理与熔断保护

代理执行模型下发的工具请求,遇服务端故障时自动触发平滑熔断降级。

配置参数参考 (YAML / JSON)

参数名类型默认值说明
registryPortnumber9090工具注册中心服务监听端口
defaultQPSLimitnumber20单工具默认允许的最大每秒请求并发(QPS)
strictTypeCheckbooleantrue调用前是否强制使用 Zod 严格校验入参数据类型