技术科普｜Agent 没有秘密可言

• Agent 不是新宗教。它依然是事件、队列、CRUD 的工程实践，再加一层模型协作。

• 共用一条 EventBus，把 agent.*与 huey.*事件打通；每条事件立即打印；最后用 Cascade 树复盘因果与时间。
• 单文件 Demo，打开即跑：先看事件，后看因果，最后看结果。

• 我不想再讨论"如何画出一个复杂的 Agent 架构图"。我更关心"如何让系统解释得清楚、失败得优雅、复盘得明白"。

• 这篇文章附带一个单文件 Demo：共享总线、严格 ReACT、因果与时间合并呈现、即时可观测。开箱即用。

classEventureMemoryStorage(MemoryStorage):
    def__init__(self, event_bus: EventBus):
        super().__init__("huey")
        self.bus = event_bus

    defenqueue(self, data, priority=None):
        super().enqueue(data, priority=priority)
        self.bus.publish("huey.queue.enqueue", {
            "data": data,
            "priority": priority
        })

Tool with self-description

deftool_echo(params: dict) -> dict:
    """Echo back text. Args: {"text": string} Returns: {"ok": bool, "echo": string}"""
    return {"ok": True, "echo": str(params.get("text", ""))}

ReACT loop（核心思想）

whileTrue:
    resp = client.chat.completions.create(model=model, messages=history)
    assistant = resp.choices[0].message.content or""
    call = extract(assistant)

    if call:
        action_id = uuid4()
        bus.publish("agent.action", {"id": action_id, **call})
        # wait for agent.observation(id==action_id) and append as Observation
        continue

    return assistant

• 先闭环，后花活：先把"事件→队列→状态变化→ReACT"打通，再谈优化。

• 因果与时间是工程的一等公民：tick 表达更新周期；parent-child 表达触发链。

• 可观测性优先：当系统能解释自己，优化才有基础。

• 可替换：总线稳定，后端可换（内存→Redis），模型可换（供应商/版本）。

请点击【阅读原文】跳转：

• agent_has_no_secret.py
• README.md

运行步骤

1. 配置 .env（OpenRouter 推荐；OpenAI 也可）
2. python agent_has_no_secret.py

你将看到什么

• 实时事件流：user.input、agent.thought、agent.action、huey.data.*、agent.observation…
• 绿色的 Final Answer 面板
• 按 tick 分组的树形 Cascade Viewer：在 agent.action下能看到 huey.data.*与 agent.observation 的父子层级

我更钦佩能把东西"说清楚、跑起来"的工程师。Agent 没有秘密可言：

• 先把闭环打通，再考虑花活；
• 先让因果与代价可见，再谈"更聪明"。

星云仔号外：分享最近看到的一则图片，欢迎对号入座（手动狗头）