Skip to content

核心模块 ​

一句话理解:把六层架构落到代码层面,个人智能体由九个可独立演进的模块构成——连接器管理器、记忆管理器、触发引擎、规划器、常驻执行沙箱、凭证代理、通知调度器、权限策略引擎、计费与配额;其中记忆与权限两个模块决定了产品的生死。

1. 连接器管理器(Connector Manager) ​

负责个人数据源的接入、授权生命周期与事件流标准化。

python
class ConnectorManager:
    def __init__(self):
        self._connectors = {}

    def register(self, connector):
        # 每个连接器声明: name / scopes / event_kinds / write_actions
        self._connectors[connector.name] = connector

    def poll_all(self):
        events = []
        for conn in self._connectors.values():
            try:
                events.extend(conn.poll())          # 增量事件
            except OAuthExpired:
                self._mark_reconnect_required(conn)  # 感知段第一失败模式
        return events

生产要点:

  • 授权生命周期:OAuth token 会过期、会被用户撤销;连接器管理器必须维护"健康/需重授权/已撤销"三态,并把状态暴露给 Agent(否则 Agent 会对着失效日历做错误推断)。
  • scope 最小化:Google PI 只读 Gmail/Calendar/Docs;Muse 的第三方连接器(Ticketmaster、Spotify、Apple Health)各自独立授权、单点可撤。
  • 写操作注册表:连接器声明自己支持哪些写动作,权限门按动作类型而非连接器整体授权。

2. 记忆管理器(Memory Manager) ​

个人智能体的心脏。接口上需要四条独立路径:

python
class MemoryManager:
    # 写路径
    def add_episode(self, kind, content, source, ts, tags): ...
    def distill_profile(self, episode) -> list[ProfileFact]: ...  # 画像蒸馏,带出处

    # 读路径
    def recall(self, query, limit, filters) -> list[Episode]: ...
    def profile(self) -> dict[str, ProfileFact]: ...

    # 主权路径(个人智能体特有)
    def forget(self, fact_key): ...        # 级联:画像、索引、原始episode
    def export(self) -> PersonalDataDump: ...  # GDPR/个保法数据可携带

设计要点:

  • 出处链不可丢:每个 profile 事实必须能回答"你从哪条记录得出这个结论"(Mini Demo 中 ProfileFact.source 即 episode id)。没有出处的画像在纠错场景下是灾难。
  • 蒸馏是持续过程:不是每天跑一次批处理,而是每次 episode 落库时增量评估"这条信息是否改变了用户画像"(Beyond Static Summarization, arXiv:2601.04463)。
  • 冲突处理:用户说"我不再喝咖啡了"要能让旧的"咖啡偏好"事实失效而不是并存两个值——需要事实的 validity 区间。
  • 被遗忘权的级联:forget("咖啡偏好") 应同时删除画像条目、向量索引条目,并标记来源 episode 为"已匿名化"(原始事件流往往受审计要求保留,但要做去关联化)。

来源:Claude Memory: What It Stores & How to Delete It(2026)、A Survey on the Security of Long-Term Memory in LLM Agents(arXiv:2604.16548)

3. 触发引擎(Trigger Engine) ​

主动性的大脑,回答"该不该动、何时动"。生产实现是 LLM + 规则混合:

python
class TriggerEngine:
    def evaluate(self, event) -> TriggerDecision:
        context = self.memory.recall(event.summary, limit=5)
        decision = self.llm.judge(
            system="你是个人助理的相关性过滤器",
            input={"event": event, "user_context": context,
                   "current_state": self.user_state()},  # 会议中/勿扰/时区
            output_schema=TriggerDecision,  # {action: ignore|defer|act, score, reasons, notify_level}
        )
        return decision

要点:

  • 可解释输出:score + reasons 随通知一起展示("因为发件人是你的重要联系人,且包含紧急词")。
  • 状态感知:勿扰模式、日历忙闲、时区参与决策——同一条消息,开会时是 defer,散会后是 act。
  • 反馈闭环:用户对通知的"以后少发点这个"要直接改写该用户的相关性策略。

4. 规划器(Planner) ​

消费触发引擎的决策与个人上下文,产出可执行计划:

  • 输入注入:profile(偏好、禁忌、重要联系人)+ 近期 episode(进行中的事)+ 当前用户状态。
  • 长任务挂起:在里程碑处 checkpoint,等待 confirm 级通知的批准后继续(Muse 的"应用关闭仍工作,关键节点找用户"模式)。
  • sub-agent 委派:Dots 明确支持主 Dot 委派子任务;拆分时同样要继承权限策略(子 agent 不得拥有比父 agent 更宽的权限)。

参见 Planning 主题 的任务分解算法与 Agent OS 主题 的调度与 checkpoint 机制。

5. 常驻执行沙箱(Persistent Sandbox) ​

个人任务的执行环境,需要四个生产级特性:

特性说明参考实现
强隔离不可信网页/代码在 unprivileged 容器中运行Muse: systemd-nspawn unprivileged 容器
浏览器自动化基于 accessibility tree 快照而非原始 DOM,抗页面噪声、行为更像人Muse Secure VM 内完整 Chromium
状态持久化会话可跨天续跑、可 forkOpenClaw 本地 SQLite;Dots 云电脑持久盘
可中断里程碑挂起 / 用户随时叫停Grok Bot routines 的人工检查点

成本维度:per-user 常驻沙箱是个人智能体最难看的成本项——一台闲置 VM 也是钱。工程上的对策是休眠与快照(空闲时 checkpoint 到磁盘,事件到达时秒级恢复),这与 Agent OS 主题 中 Perplexity SPACE 的 pause/resume/fork 思路一致。

6. 凭证代理(Credential Proxy / authd 模式) ​

个人智能体握着用户的邮箱、支付、日历凭证,凭证管理必须是独立模块:

  • 模型不见明文:LLM 上下文里只有 surrogate credential(一次性、限 scope、限额度)。
  • 单点撤销:用户在控制台一键撤掉"Spotify",authd 立刻让对应代理凭证失效。
  • 滥用检测:authd 记录每个代理凭证的调用模式,异常频率触发降权(与 Sentinel 联动)。

来源:Official Muse Breakdown(Vellum)

7. 通知调度器(Notification Scheduler) ​

把决策翻译成正确的打扰:

  • 投递通道选择:confirm 走强提醒(WhatsApp/锁屏),digest 走邮件/汇总栏。
  • 批处理窗口:digest 级通知按用户作息聚批(早晨通勤时间一次投递)。
  • 退避与熔断:同一任务重复 confirm 未响应时升级通道(邮件 → 短信),连续未响应自动挂起任务并告知。
  • 每条通知可解释、可行动:附"为什么"与"别再提醒我这类事"入口。

8. 权限策略引擎(Policy Engine) ​

三态门(auto/ask/deny)的用户可编程层:

  • 默认拒绝:未声明策略的动作类型一律 ask。
  • 自然语言策略:用户说"订机票不用问我,酒店超过 500 要问"→ 编译为策略规则(这本身就是个小 Agent 任务,且策略变更要进审计日志)。
  • 降级不可逆性:ask 可经多次批准后降为 auto,但降级记录必须在控制台永久可见——"它什么时候获得了自动发邮件的权利"是信任审计的关键问题。
  • 子 agent 继承:委派出去的 sub-agent 权限是父权限的交集,不能扩权。

9. 计费与配额(Metering) ​

消费级产品的隐形战场:

  • 成本归集:每用户沙箱时长、LLM token、连接器调用、网络出口流量分别计量。
  • 套餐设计:Muse 据报道采用基础免费 + 约 20 美元/月与 100 美元/月付费档(国内媒体报道口径;Vellum 的拆解未给出具体数字);Dots 面向 Pro/Business Premium/Enterprise 订阅者推出,会话 reportedly 不计入常规用量。
  • 免费档的经济学:免费用户是成本控制压力测试——休眠/快照、本地小模型预过滤、digest 批处理都是为免费档设计的。

模块依赖关系 ​

本章小结 ​

  • 九大模块中,记忆管理器与权限策略引擎决定产品生死;凭证代理与执行沙箱决定信任上限;通知调度与计费决定商业可持续性。
  • 出处链、级联遗忘、可解释通知、策略降级可见性,是个人智能体模块设计的四个"不做就会出事"的细节。

参考来源

Released under CC-BY-SA-4.0 License.