AI Agent人工智能认证鉴权服务注册发现工具调用【免费下载链接】agent-protocolopenJiuwen agent-protocol提供agent通信协议实现包括MCP、A2A协议的C SDK项目地址https://gitcode.com/openJiuwen/agent-protocol点击查看免费下载导读本文以 A2X 版本说明 为骨架系统梳理 openJiuwen/agent-protocol 仓库中 A2X Registry智能体服务发现注册中心从 v0.0.1 首个实验基线到 v0.2.0 发布线统一的完整演进历程。读者将掌握该项目的版本编号规则含重编号前后的对照关系、每一代版本的核心算法变更与评估指标、鉴权 / 心跳 / 集群三大可选模块的引入时点以及如何通过根目录VERSION文件与scripts/bump_version.py理解并校验版本一致性从而在实际部署、二次开发与 Agent Team 集成时准确对齐版本能力。一、版本发布线两套编号的正确读法阅读AgentRegistry/a2x_registry/a2x/VERSION.md前必须先理解一个关键事实该文件记录了两套没有先后关系的编号。v0.2.02026-07-31起A2X Registry 的版本号并入 agent-protocol 仓库的 AgentRegistry 发布线重新从0.2.0编号。此后版本以 根目录 VERSION 文件当前内容为0.2.0为唯一来源。v0.3.3 及更早条目属于重编号之前的独立编号两套编号之间没有数字大小上的先后关系阅读时应按日期而非数字大小排序。因此正确的时间线阅读顺序是v0.0.12026-01-31→ v0.0.2 → v0.0.3 → … → v0.1.7 → v0.2.02026-05-27第一代 0.2.0→ v0.3.0 → v0.3.1 → v0.3.2 → v0.2.02026-07-31重编号后。版本号单一来源机制自 v0.2.0重编号后起版本号以AgentRegistry/VERSION为唯一来源由 scripts/bump_version.py 同步到两个__init__.pyAgentRegistry/a2x_registry/init.py服务端包a2x_registryAgentRegistry/client/a2x_registry_client/init.py客户端 SDK 包a2x_registry_client从源码看bump_version.py提供两个操作# 一键同步三个位置的版本号根 VERSION 两个 __init__.py python scripts/bump_version.py 0.3.1 # 校验三处是否一致不一致时退出码为 1 python scripts/bump_version.py --check其实现要点见 bump_version.pyVERSION_FILE指向AgentRegistry/VERSIONINIT_FILES列表包含服务端与客户端两个__init__.py版本必须匹配^\d\.\d\.\d([abrc].*)?$的 semver 格式否则报错退出退出码 2bump()先写VERSION文件再用正则替换两个__init__.py中的__version__行最后调用check()确认三者一致。这一机制保证同库、同版本号的客户端 / 服务端双发行包永不漂移——各 README 与版本说明文档也不再重复标注版本号避免多处维护导致的失同步。二、早期实验阶段v0.0.1 ~ v0.0.10A2X 核心算法从 0 到 1这一阶段是 A2X 自动化分类构建与递归搜索算法的孕育期每次迭代都有可复现的评估数据ToolRet_middle / ToolRet_clean 数据集。v0.0.12026-01-31首个基线版本建立三步分类构建流程Clustering → Naming → Correcting与 LLM 递归搜索雏形。评估ToolRet_middle500 查询记录了三项已知问题成为后续迭代的改进靶点指标数值Recall0.62862.8%Precision0.10510.5%Hit Rate0.66266.2%平均 LLM 调用87.13 次/查询平均 Token 消耗75,460 tokens/查询三大已知问题分类归类错误 28.6%LLM 选错分支导致正确服务被剪枝、服务未被选中 6%batch 模式多工具查询遗漏、过度检索平均返回 21.52 个服务Precision 仅 10.5%。v0.0.22026-02-03LLM Top-Down 分类构建引入三阶段 LLM Top-Down 构建Phase 1 定义 10 个顶层分类 → Phase 2 为每个顶层定义 3-6 个子分类共 47 个→ Phase 3 基于用户意图分配服务支持多分类。搜索默认使用llm_taxonomy/分类数据。500 查询完整测试Recall 62.8% →72.93%10.1%Hit Rate 66.2% →76.4%10.2%平均 LLM 调用 87.1 →16.05 次-82%平均 Token 消耗 75,460 →28,711-62%。v0.0.32026-02-03清晰边界分类设计核心思想是清晰边界 正向定义 负向定义 判断规则每个分类增加boundary字段负向定义什么不属于此分类与decision_rule字段明确判断规则类比医院分诊系统——每个服务明确知道该去哪个分类。同时优化搜索防重复访问visited_ids追踪已访问分类节点线程安全去重。评估ToolRet_middle500 查询Recall 72.93% →81.33%8.4%Hit Rate 76.4% →88.0%11.6%平均 LLM 调用 53.48 →15.62 次-70.8%平均 Token 消耗 95,248 →23,380-75.5%。v0.0.42026-03-02先验分类保留模式新增迭代构建器的--preserve-reference模式实现人工分类质量 自动化服务分配Recall 从 v0.0.3 纯自动的 77.23% 提升至82.98%1878 查询全量Precision 13.88% →22.71%8.83%平均 LLM 调用 8.16 →2.70-66.9%。v0.0.52026-03-03层次化分类构建器引入build/hierarchical在扁平分类基础上递归细分大分类节点40 服务生成多层分类树24 个节点被细分生成 156 个分类132 叶子最大深度 4 层。同版本完成数据清洗LLM 清洗 query.json1878 → 1714 条与查询重排序按 19 个来源 round-robin 交错前 50 条均匀覆盖。50 查询 6 方法对比显示 hierarchical 方案 Recall 89.27% 显著领先 vector66.67%与 traditional66.67%。v0.0.62026-03-04跨域多归属四项改进缺失服务检测自动检测未被分配服务的 15 个服务放入 root、零低置信度容忍迭代收敛要求n_low_conf 0、放宽同父多归属could reasonably be discovered、新增cross_domain_assigner.py跨域多归属908 个候选中 559 个服务获得 574 条跨域链接。全量 Recall 突破 90% 目标88.08% →90.34%。v0.0.72026-03-05纯自动层次化构建新增build/auto_hierarchical全自动流程关键词提取1839 服务 → 186 个功能关键词→ LLM 分类设计聚合为 15→19 个顶层分类5 轮迭代→ 服务分配 → 递归细分。全量 Recall 达到92.11%超越 v0.0.6 的 90.34%Hit Rate 94.57%。同时新增评估中间结果保存partial_results.jsonl增量检查点支持断点续评与assignments.json置信度数据保存。v0.0.82026-03-06统一 BFS 架构重构消除 Phase A/B 分离统一为 BFS 递归流程taxonomy_builder.pyroot 和 child 使用相同代码路径分类逻辑重构为LLM 自由列出所有相关分类移除截断、confidence 语义改为分类边界清晰度、三类问题服务易混淆 2 类 / 未分配 0 类 / 低置信度 1 类低 conf驱动迭代精炼。v0.0.92026-03-11两阶段搜索此版本未单列条目但在 v0.0.10 的对比中可见基于 confidence 阈值分类 后处理管道merge_small_leaves push-to-leavesRoot 241 服务全量 Recall91.16%该阶段最高值。v0.0.102026-03-11Token 优化重构用generic_ratio默认 1/3替代 confidence 分类规则三类服务判定正常1 ≤ n_cats ≤ N*generic_ratio、泛分类阈值 → 留父节点、未分类0 → 留父节点移除后处理模块optimize_taxonomy.py、leaf_pusher.py、leaf_splitter.py及--post-process参数。效果显著Root 服务 241 →37-85%平均 Token 消耗 14,027 →7,051-50%。新增 CLI 参数--generic-ratio默认 0.333与--delete-threshold默认 2。运行示例构建 评估# 构建默认含 cross-domain同时输出两版本 python -m method.a2x.build \ --service-path database/ToolRet_new/service.json \ --output-dir method/a2x/data/ToolRet_new/auto_hierarchical # 复用已有关键词 python -m method.a2x.build --reuse-keywords # 可选参数 # --generic-ratio 0.333 泛分类阈值 # --delete-threshold 2 超小子分类删除阈值 # --no-cross-domain 禁用跨域分配 # --no-subdivision 仅根分类 # 评估 python -m method.a2x.evaluation \ --data-dir method/a2x/data/ToolRet_new/auto_hierarchical \ --max-queries 50 --workers 20 \ --output results/{timestamp}_50三、正式版本阶段v0.1.0 ~ v0.1.7打包、解耦与能力固化从 v0.1.0 起项目进入正式发布节奏重心从算法迭代转向工程化文档体系、pip 打包、功能解耦、注册模块与前后端能力。v0.1.02026-03-17文档体系重构功能代码与 v0.0.10 一致无算法变更。重点是 README 重写、新增 docs/a2x_design.md 与 docs/build_design.md移除逻辑视图 / 时序图文档内容整合进设计文档并确立每个模块包含流程逻辑、对外接口、逻辑视图、顺序图、类图的设计规范化要求。v0.1.12026-03-23 ~ 03-24搜索模式与流式接口搜索模块新增三种能力get_one每步只选最相关的一个分类/服务精度优先功能精度约 98%、get_important只选确定相关的分类/服务平衡精度与召回、get_onefallback结果为空时自动回退到 get_important。新增search(query, streamTrue)流式接口与交互式 UIpython -m method.ui支持多方法并行对比、D3.js 分类树实时动画、LLM 相关性评判。构建模块支持断点续传build(resumeyes/keyword)。同时完成搜索模块大拆分a2x_search.py→models.py/prompts.py/navigator.py/selector.py/a2x_search.py五个文件编排器 776 → 150 行。v0.1.22026-03-25 ~ 03-27服务注册模块上线新增 SSE 构建日志流GET /api/datasets/{dataset}/build/stream、构建取消DELETE .../build、服务注册模块src/register/支持 generic 与 A2A 两种类型注册/注销、分页服务列表与 AdminPanel。v0.1.32026-03-28数据集 CRUD 与 Per-dataset Embedding新增数据集 CRUDPOST /api/datasets、DELETE /api/datasets/{dataset}、per-dataset Embedding 模型en/zh/multilingual 三选一经vector_config.json持久化切换自动触发索引全量重建、CN 数据集ToolRet_clean_CN、publicMCP_CN、ChromaDB 自动清理、后端 4 路由模块拆分dataset / build / search / provider、API 路径统一/api/registry/*→/api/datasets/*。v0.1.42026-04-01Skill 注册新增第三种服务类型Skill 注册POST /api/datasets/{dataset}/skills上传 ZIP、GET /skills/{name}/download下载、DELETE /skills/{name}删除、启动时自动扫描database/{dataset}/skills/目录。服务查询新增 single 模式。代码层面统一 SearchResult消除 3 份重复定义、迁移 LLMClient 至src.common.llm_client、提取compute_set_metrics到src.common.evaluation。v0.1.52026-04-23pip 打包正式发布包名从src/重命名为a2x_registry/59 处 import 全量迁移新增 6 个 CLI 入口a2x-backend/a2x-build/a2x-register/a2x-evaluate-a2x/a2x-evaluate-vector/a2x-evaluate-traditional客户端 SDKa2x-registry-client独立包A2XRegistryClient/AsyncA2XRegistryClient双入口对称路径抽象A2X_REGISTRY_HOME环境变量 ~/.a2x_registry/默认位置友好错误LLMNotConfiguredError/VectorSearchUnavailableError给出明确修复指引Web UI 迁出 pip 包仓根ui/python ui/launcher.py。v0.1.62026-04-26功能解耦与 Lite 默认安装把重 ML / 索引依赖从默认安装剥离默认pip install仅装 5 个轻量包requests / fastapi / pydantic / python-multipart / uvicorn[standard]增强功能按需安装extras包含启用功能默认上述 5 个包注册中心 SDK A2X 搜索 Traditional 搜索 A2X 分类构建纯 LLM 能力[vector]numpy / sentence-transformers / chromadb向量检索、向量索引同步、嵌入模型预热[evaluation]tqdma2x-evaluate-*进度条[full]上述全部全量功能等价旧版默认安装配套机制是503 契约与 feature_flags.py未装[vector]时/api/search与 build 返回结构化 503body 含{feature, extras, detail}其中 detail 是可直接执行的pip install命令。从源码看has()/require()使用importlib.util.find_spec不缓存探测结果——pip install后重启 backend 立即生效无需改代码。v0.1.7并入 v0.2.0gating 策略修正v0.1.6 把任何辅助搜索/构建统一关在[vector]后面属设计漏洞——A2X 搜索 / Traditional 搜索 / A2X 分类构建实际上是纯 LLM 工作流根本不需要 numpy / chromadb / sentence-transformers。本版本把 gating 改为按真实依赖精确锁定methoda2x_get_one/a2x_get_all/a2x_get_important/traditional与/api/search/judge、POST /api/datasets/{ds}/build、a2x-buildCLI 全部在 lite 安装下可用前提配好 LLM API keyA2X 搜索还需taxonomy.json。__version__升至0.1.7.dev0PEP 440 pre-release 标识区分 develop HEAD 与已发布版本。四、v0.2.02026-05-27鉴权与心跳两大可选模块这是重编号前的功能里程碑内置两大可选模块且默认全部关闭——现有部署与现有客户端零影响鉴权模块a2x_registry/auth/管理员 bootstrap、API Key 创建 / 撤销 / 禁用/api/auth/principalsCRUD、namespace 级auth_required开关POST /api/datasets支持auth_required: true字段、JSONL audit log三档角色admin / provider / user作用域精确到 namespaces 列表。心跳保活模块a2x_registry/heartbeat/per-namespacelease_config.jsonenabled / min_ttl / max_ttl / grace_periodPOST /services/{a2a,generic}支持lease_ttl字段POST/DELETE /services/{sid}/heartbeat端点后台 sweeper 两段式状态机HEALTHY → UNHEALTHY → HARD-DELETED客户端 SDKauto_renewTrue自动续约POST /api/datasets内联lease_config——admin 一次请求即可建 namespace 配置 auth 配置心跳。架构解耦原则关键设计是回调注入而非 import 依赖register/通过set_unhealthy_check(callback)接 heartbeat、通过AuthContext接 authregister/本身对 auth/heartbeat零 import 依赖与后续 v0.3.0 中register/对cluster/零 import 依赖同一模式。同版本还有 CLI 重命名a2x-backend→a2x-registry。测试规模tests/auth/78tests/heartbeat/52 既有24 154 测试全绿客户端 SDK 31 测试全绿。A2X 算法无变更评估指标与 v0.1.5 / v0.1.6 一致。五、v0.3.0 ~ v0.3.2分布式集群能力的三步走v0.3.02026-06-05新增分布式同步模块a2x_registry/cluster/多个注册中心实例在彼此可达时自动同步注册表AP / 最终一致gossip LWW 版本判新查询任一节点即可获得全网可达节点的服务。opt-in默认关闭——未启用时/api/cluster/*返回 404读写行为与单机完全一致。核心能力会话握手 逐 namespace 鉴权 会话令牌本地 CRUD 增量推送 水平分割转发 LWW 版本去重防回音周期反熵兜底 墓碑 GC防删除复活BEACON 存活租约 失活驱逐按来源节点keepalive/HOLD 直链探测。配套接口RESTful/api/cluster/* CLIa2x-registry cluster {init, add-peer, rm-peer, status}。读路径合并GET /services、GET /services/{id}自动合并对端同步来的只读副本命名空间化 idorigin_id:service_idsourcecluster客户端无需改动A2X 搜索与 taxonomy 不受影响foreign 记录不进 hash。重构方面心跳租约状态机提取为共享 common/lease.py泛型LeaseTable[K]heartbeat 与 cluster 复用新增 common/atomic.py跨平台原子写运行时新增 httpx 依赖。v0.3.12026-06-05客户端 SDK 并入主仓仓库结构调整把原独立客户端仓库并入主仓 client/成为第二个独立可安装的发行包与服务端同库、同版本号。两者各自pip install、互不依赖、不互相 importSDK 仍只通过 HTTP 调服务端。新增根VERSIONscripts/bump_version.py即第一节介绍的版本统一机制。安装方式pip install a2x-registry-client githttps://gitcode.com/openJiuwen/agent-protocol.gitfeature/Agentregistry#subdirectoryclientv0.3.22026-06-11声明式成员控制面 全连接规模化~1000 节点这是集群能力的集大成版本也是重编号前最后一个独立版本分两大主题一full-mesh 瘦身cluster/模块瘦身为全连接full-mesh直接广播模型——每个成员与其它每个成员直连记录由来源直发所有 peer、入站不再转发。删除为支持链式/稀疏拓扑而存在的 BEACON 存活泛洪、relay 转发、按来源的租约驱逐三块死代码失活统一到直链HOLD 抑制冷却一条路径。部署契约变化删 relay 后部署必须全连接配置移除beacon_ttl/beacon_grace/beacon_intervaltombstone_retention改为hold_timeout keepalive_interval。二声明式成员控制面cluster/membership.py用户只用cluster set add/remove/show系统据成员名册roster自动维护全连接不再手动逐条add-peer。核心设计每节点一条 origin-only LWW 的MembershipRecord独立 roster 叠加层不碰服务同步/读路径/鉴权门控/掉会话驱逐cluster_id clu-uuidset add含 bootstrap 直推/set remove确定性墓碑用next_version_after保证 LWW 必胜——同毫秒下 node_id tiebreak 曾让墓碑落败/ 退老 cluster主动leave先发后断/ 重启自动重连成员名册增量反熵版本图 本地变更即时推接口POST /api/cluster/set/{add,remove}、GET /api/cluster/set、/join、/evicted、/leave、/set/{digest,pull,sync} CLIcluster set add/remove/showadd-peer/rm-peer降级为内部建连原语持久化cluster_state.json加cluster_id/last_roster/my_membership_version向前兼容旧文件按默认值加载为单机。规模化优化目标 ~1000 节点确定性、无随机并发非阻塞广播broadcast_workers线程池默认 32死节点不拖垮 CRUDHttpTransport连接池 / keep-alive服务面Merkle 反熵merkle_buckets默认 256稳态无变更近零传输可调心跳周期大集群建议keepalive_interval/hold_timeout/anti_entropy_interval调到 30~60s。测试规模tests/cluster100 全绿新增test_membership9 test_scale3 三进程成员集成全量非 query 套件 238 全绿。文档新增 docs/cluster_design.md §5 成员控制面 §6 规模化。六、v0.2.02026-07-31发布线统一与收尾修复重编号后的首个版本标志项目进入 agent-protocol 统一发布线。变化集中在工程与易用性文档易用性修复issue #59修正a2x/与traditional/的[vector]gating 标注、补齐客户端 SDK 方法说明、新增 docs/environment.md 环境变量总表、移除 README 中失效的评估结果链接error_analysis移除硬编码数据集 fallback路径改为必须由config.json提供LLMClient移除 legacy 单 provider 配置格式及其 DeepSeek 默认 URL配置须使用providers数组当前模板见 llm_apikey.example.json四处线程池并发度改为可通过A2X_REGISTRY_*_WORKERS环境变量配置。其中第四点与 docs/environment.md 中的并发度调优表一一对应变量默认值说明A2X_REGISTRY_SEARCH_WORKERS4/api/search请求处理线程池上限A2X_REGISTRY_DATASET_WORKERS2/api/datasetsCRUD / build 请求处理线程池上限A2X_REGISTRY_LLM_WORKERS20A2X 递归导航并发调用 LLM 的线程数受 LLM 供应商速率限制约束免费额度建议调小A2X_REGISTRY_AGENT_CARD_WORKERS10注册时并发抓取 agent card URL 的线程数注意前两个是模块级线程池在 import 时创建必须在启动 server 前设好所有环境变量均在进程启动时读取运行时修改不生效且本项目不使用 dotenv需通过 shellexport、systemdEnvironment或容器编排注入。七、版本历史总表与命名规范全量版本对照表版本日期数据集Recall构建方式主要变更v0.1.32026-03-28ToolRet_clean89.19% (1714q)纯自动后端重构、per-dataset Embedding、数据集 CRUD、CN 评估v0.1.22026-03-27ToolRet_clean89.19% (1714q)纯自动SSE 构建流、构建取消、服务注册模块、AdminPanelv0.1.12026-03-23ToolRet_clean89.19% (1714q)纯自动get_one/get_important 模式、stream 接口、交互式 UIv0.1.02026-03-17ToolRet_clean88.03% (1714q)纯自动文档体系重构正式版本发布v0.0.102026-03-11ToolRet_clean88.03% (1714q)纯自动generic_ratio 分类 移除后处理 Token-50%v0.0.92026-03-11ToolRet_clean91.16%(1714q)纯自动两阶段搜索 参数分离 小分类优化v0.0.82026-03-06ToolRet_clean89.41% (1714q)纯自动统一 BFS 架构 分类逻辑重构v0.0.72026-03-05ToolRet_clean92.11%(1714q)纯自动auto_hierarchical 关键词→分类→分配→细分v0.0.62026-03-04ToolRet_clean90.34% (1714q)半自动跨域多归属 零低置信度 缺失服务检测v0.0.52026-03-03ToolRet_clean89.27% (50q)半自动hierarchical 层次化分类 6 方法全面对比v0.0.42026-03-02ToolRet_clean82.98% (1878q)半自动iterative --preserve-referencev0.0.32026-02-03ToolRet_middle81.33% (500q)纯自动清晰边界分类 防重复访问优化v0.0.32026-02-28ToolRet_clean77.23% (1878q)纯自动llm_taxonomy 三阶段 pipeline已删除被 auto_hierarchical 取代v0.0.22026-02-03ToolRet_middle72.93%纯自动LLM Top-Down 分类构建v0.0.12026-01-31ToolRet_middle62.8%纯自动首个基线版本版本命名规范v0.x实验阶段版本v0.0.10generic_ratio 分类 Token 优化版本每次迭代后更新 VERSION.md 并 git commit历史版本通过 git 管理git show commit:path/to/file。八、从版本史反推的架构主线纵览全部版本可以提炼出三条贯穿始终的设计主线这也是理解 A2X Registry 当前架构v0.2.0 发布线的钥匙算法层持续以可复现评估驱动从 v0.0.1 的 62.8% Recall 到 v0.0.7 的 92.11%每次变更都附带数据集、查询数、指标表与实验目录如results/20260311_a2x_toolretnew_all/保证无算法变更的版本v0.1.0 / v0.1.5 / v0.1.6 等都显式声明评估结果不变杜绝隐性漂移。工程层持续解耦 按需从 v0.1.6 的 lite extras 三段式依赖、v0.1.7 的按真实依赖精确 gating到 v0.2.0 的LLMClient移除 legacy 配置、v0.3.x 中register/对 auth / heartbeat / cluster 全部零 import 依赖回调注入解耦始终追求默认轻量、可选增强、依赖精确。分布式能力持续确定性 无随机v0.3.0 引入 gossip 同步v0.3.2 在 full-mesh 瘦身中删除 relay / BEACON 死代码全部收敛到 HOLD 抑制冷却一条失活路径与 LWW 确定性 tiebreak配合 Merkle 反熵与并发广播撑起 ~1000 节点目标。九、继续深入版本权威来源根目录 VERSION 文件 与 版本同步脚本当前服务端 / 客户端版本号服务端__init__.py、客户端 SDK__init__.py环境变量总表docs/environment.md集群设计含 §5 成员控制面、§6 规模化docs/cluster_design.md整体架构与安装模式README.md 与 docs/architecture_overview.md鉴权 / 心跳设计docs/auth_design.md、docs/heartbeat_design.md。赞分享AI Agent人工智能认证鉴权服务注册发现工具调用【免费下载链接】agent-protocolopenJiuwen agent-protocol提供agent通信协议实现包括MCP、A2A协议的C SDK项目地址https://gitcode.com/openJiuwen/agent-protocol点击查看免费下载相关推荐Recommenders 项目发布史与技术演进从 0.1.0 到 1.2.1 的版本路线图Recommenders 项目发布史与技术演进从 0.1.0 到 1.2.1 的版本路线图 Recommenders曾用名 Microsoft Recomm人工智能机器学习深度学习CoTracker版本演进史从v1到v3的技术路线图CoTracker版本演进史从v1到v3的技术路线图 还在为视频点追踪的精度和效率问题烦恼吗CoTracker系列模型的演进史给你答案从最初的v1版本到如人工智能计算机视觉深度学习UVR 5.6 免费人声分离完整指南三步把歌声和伴奏拆开UVR 5.6 免费人声分离完整指南三步把歌声和伴奏拆开 Ultimate Vocal RemoverUVR5.6 是一款免费开源的图形化人声分离工具用音频处理人工智能上一篇NVIDIA ChronoEdit-14B让AI图像编辑拥有物理常识的革命性突破下一篇5分钟快速上手LangManus从安装到运行的完整指南创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考