ZUAEF

ENGINEERING RESEARCH

研究是允许证据推翻设计的过程。

ZUAEF 的很多重要变化不是“又增加一个功能”,而是发现某个合理设计没有改善结果,于是把它删除、降级或重新定义。

Research 保存这条演化链,包括负面结果、开放问题与明确标记的历史架构。

项目围绕可证伪的问题推进。

Agent Loop

  • 模型应该决定什么?Host 应该确定性决定什么?
  • 一次有效 Run 到底需要多少次 Model Request?
  • Tool Use 在什么时候形成有价值的 Agent Loop,什么时候只带来串行延迟?

Context Delivery

  • 哪些信息应该进入第一轮 Request?
  • 哪些应该按需 Retrieve?
  • Durable Business State 和上一轮 Agent Trajectory 应该如何区分?
  • Memory 在什么时候修复真实 Failure,什么时候只是让 Context 变得更不可归因?

Capability Engineering

  • 一个 Technique 应该被 Host 注入、让模型自己选择,还是最终变成 Capability 本身的代码变化?
  • Engineering Agent 能不能在两次 Fresh Run 之间修改 Capability,再由 Human Reward 决定 Patch 去留,而不是让 Production Run 自我热修改?

Evidence & Observability

  • 解释一次慢 Run / 低质量 Run,到底需要哪些事实?
  • 能不能看到 Request Latency、Tool Latency、Context Growth、Artifact / Effect History,而不再造 Telemetry Platform?

Human-Agent Work

  • 人的纠正应该落在哪里?
  • Conversation、Case、Artifact、Annotation、Run Trajectory 与 Engineering Handoff 如何进入同一个真正有用的 Workbench?
ARCHITECTURE EVOLUTION

从 Multi-Agent 架构回到一个 FDE Agent

早期 ZUAEF 探索过 Supervisor、Domain Agents、ToolRegistry / ToolManager、agent.md Auto-discovery 与更大的 Platform Abstraction。这些实验解决了一部分代码组织问题,但也让我们更容易把“架构完整”误认为“智能更强”。

当前系统使用更严格的问题:这一层有没有改善模型的 Context、Decision、Action 或 Verifiable Outcome?如果没有,就不应该因为它看起来像 Enterprise Platform 而保留。

Planned note

《我们删掉了“虚拟组织”:为什么 ZUAEF 回到一个 Outcome Owner》

解释为什么多个 Agent Identity、Registry 与 Orchestration Layer 最终收敛成一个 FDE Agent + Explicit Capability Composition。

CONTEXT DELIVERY

Context 是 Causal Variable

Agent Quality 经常被描述成“模型够不够强”的问题。但真实 Run 可能被 Host 预选材料、隐藏 Policy、大型 Tool Result、上一轮残留历史主导。ZUAEF 正在把 Context Construction 当成必须测量的 Causal Variable。

  • 哪些材料在模型看到任务之前就被选好了?
  • Evidence 是模型自己 Retrieve 的,还是 Host 强行投影的?
  • 最大一次 Request 到底有多大?
  • 哪些 Prior History 进入了下一轮?
  • 哪个 Tool Result 触发了新的 Model Turn?

Planned note

《模型并不是“自己知道”的:Host Context Selection 如何改变 Agent 行为》

CAPABILITY EVOLUTION

写作质量,不再靠堆 Prompt

写作实验已经说明:增加更多 Editorial Technique Text,并不会单调提升质量。Host-selected Technique 可能一轮获胜、下一轮失败;Model 也可能完全不选择 Technique Catalog;一份技术上“都对”的 Prompt 仍然可能写出总结欲过强、AI 味明显的文章。

baseline → engineering patch → fresh run → blind/human reward → keep or revert

Human Reward 决定 Patch 是否留下。同一次 Production Run 不热修改自己。

Planned note

《别再教 Prompt 了:什么时候应该直接修改 Writing Capability》

WORKBENCH · 开发中

Run Analysis

Agent Console 能展示 Run。Run Analysis 应该解释 Run。

  • 能不能快速识别支配 Wall-clock Time 的少数 Model Request?
  • 能不能展示“某次 Tool Call 为什么导致下一次 Model Turn”的因果链?
  • 能不能识别 Context Accumulation,又不新增 Telemetry Framework?
  • Analysis 能不能直接指向最可能改善下一轮的 Capability Code?

Planned note

《Timeline 不是解释:为 Engineering Agent 构建 Run Analysis》

旧架构继续公开,但必须带日期,也必须带警告。

Legacy Topics 包括:

  • LangGraph / PydanticAI 两层架构
  • Supervisor Orchestration
  • Domain Agents
  • ToolRegistry / ToolManager
  • agent.md Auto-discovery 作为中央 Extension Model
  • Team Topologies Runtime Mapping
  • 旧 ReAct / Graph 实验
历史研究

Z-UAEF V3.0 架构深度解析:两层智能体协同模型

深入探讨 Z-UAEF V3.0 的两层架构设计:LangGraph Supervisor 作为战略层,PydanticAI Agents 作为战术层。了解如何通过 Command + Skill 双轨模型实现确定性与智能性的完美平衡。

历史研究

agent.md 蓝图:声明式智能体开发的最佳实践

探索 agent.md 如何成为智能体的声明式契约。从 YAML frontmatter 到工具规范,从依赖注入到自动化发现,全面了解声明式智能体开发的核心理念。

历史研究

Finance Agent V2:领域驱动设计在智能体中的实践

详细介绍 finance_agent_v2 的 DDD 重构过程:Domain 层的计算器、Application 层的服务编排、Infrastructure 层的数据加载。学习如何通过分层架构提升代码质量和可维护性。

历史研究

ToolRegistry 自动发现机制:零配置智能体集成

深入了解 ToolRegistry 如何通过扫描 agent.md 实现智能体的自动发现和注册。新智能体实现零配置自动集成,无需手动修改编排代码,大幅提升开发效率。

历史研究

Team Topologies 在 Z-UAEF 中的应用:组织架构与系统架构的一致性

探讨如何将 Team Topologies 的理念应用到 Z-UAEF 架构中。Platform Team、Enabling Team、Stream-Aligned Teams 的映射与协作模式。

历史研究

ReAct Loop:Skill 内部的智能编排引擎

了解 Skill 如何使用内部 LangGraph ReAct Loop 实现 Thought-Action-Observation 循环。通过多轮推理和命令调用,Skill 能够自主完成复杂的目标导向任务。

历史研究

RunContext 依赖注入:构建可测试的智能体系统

深入探讨 RunContext 如何通过依赖注入模式提供 trace_id、配置、LLM 客户端等上下文信息。学习如何通过 DI 实现智能体的可测试性和可维护性。

历史研究

Graphiti 知识图谱集成:赋能 Knowledge Agent 的智能记忆

介绍如何将 Graphiti 知识图谱集成到 knowledge_agent 中。通过 add_episode 和 search 接口,实现知识资产的结构化存储和智能检索,构建组织级知识记忆。

历史研究

两阶段分析模式:Pre-computation + LLM Insight 的最佳实践

探索两阶段分析模式如何平衡性能和智能性。第一阶段使用 pandas/duckdb 进行确定性预计算,第二阶段使用单次 LLM 调用生成洞察报告。

历史研究——不是当前 ZUAEF 架构。本页记录早期设计阶段。请查看 Current Architecture 了解现在实际存在的系统。

为什么保留?

因为路径本身就是研究结果。一个有价值的工程项目应该公开“哪些想法被删除、为什么”,而不是每次改架构之后悄悄重写历史。

Negative Result 也是 Result。

Research Note 完全可以得出:

  • 没有测到质量提升
  • 增加 Latency 但没有增加 Outcome Quality
  • 某 Capability 暂时不需要
  • Human Reviewer 更喜欢 Baseline
  • Host Preselection 影响了实验结果
  • 新架构降低了 Attribution
  • 还需要 Fresh Run 才能升级成 Product Claim

只有保持这个标准,Research 才能继续和 Field Proofs 相连,而不是重新滑回 Marketing。

跟着证据走,包括证据要求我们往回走的时候。