AxisVela 生态集成¶

PRAXO-CORE 是 AxisVela Agent 共享的框架层。它暴露中立的契约，使生态组件能够在不修改 Agent 循环的情况下提供适配器。大多数 AxisVela 公开仓库通过四种方式之一集成：核心运行时接缝、工具或网关、事件/协调协议，或产品运行时适配器。

核心集成映射¶

生态组件	PRAXO-CORE 接缝	典型适配器
模型与推理路由	`pkg/model`（`Model`、`Provider`、`ModelRouter`、`ProviderProfile`）	NOETIVELA / PRAXOVELA 提供商路由器
记忆	`pkg/memory`（`Store`、`ContextAssembler`）	Mnemovela
事件	`pkg/event`（`Sink`、`PublisherSink`）	Harmovela / Argus Trace
检索	`pkg/retriever`（`Retriever`、`Document`）	GNOSIVELA / Mnemovela
策略	`pkg/policy`（`Hook`、`PathChecker`）	AEGIVELA / Archon Guard
沙箱	`pkg/sandbox`（`Sandbox`、`Interpreter`）	Vulcan Forge
工具	`pkg/tool`（`Tool`、`Gateway`）	Janus Gateway / LIMENORA
图执行	`pkg/agent`、`pkg/agent/stream`	RHEOVELA
产品运行时	所有接口	PRAXOVELA

适配器骨架：examples/ecosystem。

adapters/openaicompat 是仅使用标准库的 OpenAI 兼容模型适配器，适用于 Ollama、vLLM 和支持 OpenAI 兼容接口的服务。
adapters/mcp 是可选的 MCP 模块，支持工具、 resources 和 prompts。它是独立的 Go 模块，因此核心框架不依赖 MCP SDK。
adapters/otel 是可选的 OpenTelemetry 事件 Sink，将生命周期事件映射为 span，且不会把 OpenTelemetry 加入核心模块。
adapters/anthropic 是原生 Anthropic Messages 适配器，支持工具调用、usage 和 SSE 流式输出。

可以。NOETIVELA 是 AxisVela 的推理基础设施（inference fabric），可以接入模型接缝。

将 NOETIVELA 的受治理 Chat API 包装为 model.Model 或 model.Provider； model.ChatModel 可以把 Provider 适配为 Model。
在适配器内将中立的 model.Request 映射为 NOETIVELA Inference Contract。 task、modality、region、数据分类等契约字段属于适配器或产品配置；核心请求不会新增 NOETIVELA 专用字段。Agent 不会填充 model.Request.Model，因此应从适配器状态、运行上下文或消息中推导契约，而不是假设模型名。
需要按端点描述上下文、输出、工具、流或缓存能力时，使用 model.ProviderProfile。
框架不内置 NOETIVELA Go SDK 或提供商凭据。noetivela-open 采用 Apache-2.0，可由适配器或产品导入。
examples/ecosystem-sdk 模块直接使用真实的 NOETIVELA、Mnemovela 和 GNOSIVELA Go SDK。它是独立模块，因此核心框架模块不依赖产品 SDK。
ecosystem.Noetivela 骨架展示了契约映射形态；ecosystem.Model 和 ecosystem.Provider 覆盖通用回调形态。
可运行示例将 NOETIVELA、记忆、事件、策略和工具网关适配器接入 Agent。
NOETIVELA SDK 的 ChatResponse 只暴露文本内容，不暴露工具调用。若需要 Agent 工具调用，应使用保留 tool-call 字段的自定义 HTTP 适配器，或把工具执行留在产品运行时。

这些组件不是核心 Agent 循环的基础能力，但可以通过工具、事件、策略输入或产品运行时适配器接入。可浏览当前公开仓库列表。

组件	公开仓库	集成方式
EIDOVELA	eidovela-open	Agent 身份；产品运行时或策略输入
NOMIVELA	NOMIVELA-open	Agent 注册表与命名空间；产品运行时或工具发现
SYMBIVELA	symbivela-open	人工审批与干预；HITL 决策或产品 UI
TEKMOVELA	tekmovela-open	验证与保障；工具或发布门禁
MODUREGIS	moduregis-open	能力注册表；`tool.Registry` 或 `tool.Gateway`
SYNDOVELA	SYNDOVELA-open	技能组合；产品加载的工具或技能
ONTOVELA	ontovela-open	数字孪生与世界模型；工具或检索
ORCHADYN	orchadyn-open	能力规划；工具或产品编排
COORDIVELA	coordivela-open	开发协调；事件、工具或产品集成
KINETOVELA	kinetovela-open	机器人集群执行；工具、沙箱或产品集成
PEIRAVELA	peiravela-open	实验控制；工具或产品集成

模型。 实现 model.Model，或适配现有的提供商路由器。 model.ProviderProfile 按模型前缀描述上下文、输出、工具、流和缓存能力。
记忆。 实现 memory.Store 以支持会话、工作区或长期记忆。
事件。 实现 event.Sink，将生命周期事实发布到 Harmovela。相同事件也可以持久化到 Argus Trace。
检索。 实现 retriever.Retriever；GNOSIVELA 和 Mnemovela 可以提供文档、语义依据和上下文。
策略。 实现 policy.Hook 进行授权；AEGIVELA 和 Archon Guard 在此接入。policy.PathChecker 提供内置路径约束。
沙箱。 实现 sandbox.Sandbox 以隔离命令执行；Vulcan Forge 提供产品侧隔离实现。
工具。 注册 tool.Tool。Janus Gateway 和 LIMENORA 通过 tool.Gateway 暴露产品拥有的外部工具。
图执行。 RHEOVELA 拥有图与子图执行。PRAXO-CORE 暴露 Agent 节点、会话和流边界。
插件。 pkg/plugin/bridge 将运行时插件宿主映射到工具、模型、策略、记忆和沙箱契约。