AgentX 生态详细架构

AgentX 生态详细架构 由 Archify 生成的架构图。 ax-spec · 规范 / 兼容矩阵 / 索引 · 规范、契约与 ax-gRPC wire layer · governance ax-spec 规范 / 兼容矩阵 / 索引 governance ax-contracts · Schema / digest / fixtures · 规范、契约与 ax-gRPC wire layer · machine contracts ax-contracts Schema / digest / fixtures machine contracts AgentXBridge crate · Push / Ack / Query / Subscribe · 规范、契约与 ax-gRPC wire layer · data plane AgentXBridge crate Push / Ack / Query / Subscribe data plane AgentXRegistry crate · Register / KeepAlive / Watch · 规范、契约与 ax-gRPC wire layer · control plane AgentXRegistry crate Register / KeepAlive / Watch control plane AgentXTelemetry crate · Ingest / live Subscribe · 规范、契约与 ax-gRPC wire layer · telemetry plane AgentXTelemetry crate Ingest / live Subscribe telemetry plane Node Doctor contract · describe / offline / admission · 规范、契约与 ax-gRPC wire layer · SPEC-0019 Node Doctor contract describe / offline / admission SPEC-0019 ax-runtime · identity / config / TLS / logs · Runtime admission + control / telemetry · shared runtime ax-runtime identity / config / TLS / logs shared runtime ax-registry / axreg · lease / Discover / Get / Watch :50052 · Runtime admission + control / telemetry · control plane ax-registry / axreg lease / Discover / Get / Watch :50052 control plane ax-telemetry / axtel · live Ingest / broadcast :50051 · Runtime admission + control / telemetry · live-only ax-telemetry / axtel live Ingest / broadcast :50051 live-only Release / Deploy contracts · Manifest / Report / digest · 架构组件 · agentx.*.v1 Release / Deploy contracts Manifest / Report / digest agentx.*.v1 ax-toolbox / axtoolbox · contract / release / deploy / doctor · 治理、运维与用户侧 · maintenance ax-toolbox / axtoolbox contract / release / deploy / doctor maintenance agentx-bee · raw-ingest producer · AgentX 业务数据平面 · agent agentx-bee raw-ingest producer agent Bee collectors · WeChat / email adapters · AgentX 业务数据平面 · input boundary Bee collectors WeChat / email adapters input boundary agentx-core · Session / Turn / memory / facts · AgentX 业务数据平面 · agent agentx-core Session / Turn / memory / facts agent Qdrant · indexed memory / collections · AgentX 业务数据平面 · Core storage Qdrant indexed memory / collections Core storage Temporal Frontend · mTLS :7233 / namespace default · AgentX 业务数据平面 · durable workflow Temporal Frontend mTLS :7233 / namespace default durable workflow agentx-taskbook · Query consumer / taskbook job · AgentX 业务数据平面 · agent agentx-taskbook Query consumer / taskbook job agent agentx-pulse · health observer / morning report · 治理、运维与用户侧 · incubating agentx-pulse health observer / morning report incubating agentx-specdog · source / build / runtime audit · 治理、运维与用户侧 · compliance agentx-specdog source / build / runtime audit compliance ax-ecosystem-test · matrix runner / evidence report · 治理、运维与用户侧 · ORCHESTRATOR ax-ecosystem-test matrix runner / evidence report ORCHESTRATOR agentx-live · Web / desktop client · 治理、运维与用户侧 · client agentx-live Web / desktop client client LiveKit · WebRTC room / media relay · 治理、运维与用户侧 · external LiveKit WebRTC room / media relay external Object data plane · agentx.object.v1 / attachments · AgentX 业务数据平面 · large payload Object data plane agentx.object.v1 / attachments large payload Project logs · JSONL history / rotation · 治理、运维与用户侧 · not axtel storage Project logs JSONL history / rotation not axtel storage governs / pins schema + digest shared gRPC / identity tonic / protobuf machine operation contract release / deploy schemas implements RPC implements RPC RegistryLifecycle / TLS sampler / exporter Telemetry-first admission axtoolbox contract validate WeChat / email normalized raw indexed memory workflow / activities durable job AgentXBridge Query agentx.object.v1 Register / Discover current snapshot launch / Watch / recovery Ingest / Subscribe observe / audit live samples health observation WebRTC audio voice session structured logs audit history 规范、契约与 ax-gRPC wire layer Runtime admission + control / telemetry AgentX 业务数据平面 治理、运维与用户侧 图例 前端 后端 数据库 云服务 安全 消息总线 外部系统

协议与身份边界

  • • Bridge 传业务消息；Registry 只负责注册/发现/租约/Watch；Telemetry 只广播 live 当前样本
  • • 所有 gRPC 请求传播 agent_id + instance_id + runtime_id + version + protocol_version

运行与验证闭环

  • • axtel :50051 先准入再监听；axreg :50052 依赖 axtel，客户端由 RegistryLifecycle 自动续租/重注册
  • • ax-ecosystem-test 启动真实跨仓闭环并保存 Doctor、进程日志与 Telemetry 证据；历史事实只进项目日志

业务数据路径

  • • Bee collectors → agentx-bee → agentx-core → agentx-taskbook
  • • Qdrant 承载 Core 索引记忆，Temporal 承载可恢复工作流，大正文走 agentx.object.v1