Marivo 0.4.3
Marivo 0.4.3 让固定结构的语义模型可以连接参数化 JSON API,为事件 耗时分析加入受治理的队列轴,并让面向智能体的分析失败 提供更可执行的修复路径。
md.json(...)现在支持从嵌套响应中选取记录数组、固定与运行时绑定的查询 参数、JSONPOST请求体,以及用md.source_param(...)声明的参数值。物理 结构仍须显式定义,并在语义加载前完成校验。Session.source_bindings(...)在一次动态分析范围内提供必需的非敏感 API 参数, 无需改变observe(...)等操作的签名。检查也可以通过inspection.sample(..., source_params=...)显式提供同一组参数。- DuckDB 连接只会在声明的
http_scope内附加来自环境变量的 Bearer 令牌或 自定义请求头,使凭证留在项目元数据之外,并避免发送到无关 URL。 session.events.time_to_event(...)支持受治理的主体axes,耗时结果 可以保留确定性的队列进入维度,并同步进入血缘、质量检查和持久化的 分析范围。
- JSON API 获取支持带查询字符串的
GET与 JSON 对象POST,同时保持 数据源检查和分析执行的惰性边界。参数缺失或多余、包装记录 路径无效、请求形状不支持时,都会通过类型化指引失败即停止。 - 分析帮助现在会为所有在运行时强制单指标输入的 MetricFrame 操作一致地 声明该约束。
- 证据摘要与存储失败现在包含类型化修复建议操作和规范帮助目标,使 阻塞问题能指向有效的下一步。
- 项目 README 与文档站点更新了双语导航、产品定位和 Marivo 品牌素材。
- 派生指标组件比较与归因在时间连接遇到
NaT时不再 崩溃;无法匹配的行会被丢弃,无法形成完整分解时返回类型化的ComponentDecompositionError。 time_to_event会拒绝与路径或结果保留列冲突的受治理的轴,并在持久化 元数据中校验轴唯一性。- 指标选择的证据修复建议现在解析到公开的
MetricFrame.metric帮助接口, 不再指向无效的内部目标。
- 扩展语义层指南与数据源规范,补充 wrapped JSON、参数化请求、 限定范围的身份验证、检查和分析的完整示例。
- 进一步说明检索导向的知识库可以补充,但不能替代可执行的语义 契约。
pip install marivo请为计划使用的数据源安装对应后端扩展。Marivo 0.4.3 要求 Python 3.12 或更高版本。