博客

n8n 是一个 Fair-code 工作流自动化平台，原生支持 AI Agent 能力。通过可视化画布结合自定义代码，连接 1500+ 集成，支持自托管或云端部署。本文从源码层面深入分析其架构设计。

1. 版本化节点系统（VersionedNodeType）

n8n 采用版本化节点架构，所有节点（包括 AI Agent）都通过 VersionedNodeType 基类管理多版本。这种设计允许节点在不破坏现有工作流的情况下持续演进。

源码位置: packages/@n8n/nodes-langchain/nodes/agents/Agent/Agent.node.ts

export class Agent extends VersionedNodeType {
    constructor() {
        const baseDescription: INodeTypeBaseDescription = {
            displayName: 'AI Agent',
            name: 'agent',
            icon: 'node:ai-agent',
            iconColor: 'black',
            group: ['transform'],
            description: 'Generates an action plan and executes it. Can use external tools.',
            codex: {
                alias: ['LangChain', 'Chat', 'Conversational', 'Plan and Execute', 'ReAct', 'Tools'],
                categories: ['AI'],
                subcategories: {
                    AI: ['Agents', 'Root Nodes'],
                },
            },
            defaultVersion: 3.1,
        };

        const nodeVersions: IVersionedNodeType['nodeVersions'] = {
            1: new AgentV1(baseDescription),
            1.1: new AgentV1(baseDescription),
            // ... 1.2-1.9 均为 AgentV1
            2: new AgentV2(baseDescription),
            2.1: new AgentV2(baseDescription),
            // ... 2.2-2.3 均为 AgentV2
            3: new AgentV3(baseDescription),
            3.1: new AgentV3(baseDescription),
        };
        super(nodeVersions, baseDescription);
    }
}

架构洞察: 版本映射表将语义版本号映射到具体实现类。V1 系列（1.0-1.9）共享同一实现，V2 和 V3 各有独立实现。defaultVersion: 3.1 表示新建工作流默认使用最新版本。这种设计使得旧工作流可以继续运行，同时新功能只在新版本中提供。

（更多…）

配置文件、网站接口、AI的回复，满世界都是JSON——今天你把它彻底看懂

一、你早就在见它了，只是不知道它叫JSON

先讲一个你肯定遇到过的场景。

你跟AI说：”帮我把这周的菜谱整理一下。”AI回复了一段话，里面是一份结构清晰的清单。你又说：”把这个存到文件里吧。”AI给你存好了。第二天你想让另一个程序读这份菜谱——比如做个采购清单工具——问题来了：

两个程序之间，怎么交接这份数据？

（更多…）

项目: mastra-ai/mastra

语言: TypeScript

许可证: Apache 2.0 + Mastra Enterprise License (ee/ 目录)

定位: 现代 TypeScript AI 应用和 Agent 框架，从原型到生产的一站式解决方案

来源: Y Combinator W25 批次项目

Mastra 是一个面向 TypeScript 生态的 AI Agent 框架，提供 Agent、Workflow、Tool、Memory、MCP Server 等完整能力。其架构以 @mastra/core 为核心，围绕 Agent-Tool-Workflow 三角关系构建，支持 40+ 模型提供商，提供 Human-in-the-loop、RAG、评估和可观测性等生产级特性。

1. Agent 核心架构

Mastra 的 Agent 是框架的中枢，继承自 MastraBase，整合了 LLM 调用、工具执行、记忆管理、信号系统和可观测性。

// packages/core/src/agent/agent.ts
export type MastraLLM = MastraLLMV1 | MastraLLMVNext;

// Agent 配置接口核心字段
export interface AgentConfig {
  id: string;
  name: string;
  instructions: DynamicArgument;  // 支持静态字符串或动态函数
  model: DynamicArgument;
  tools?: DynamicArgument;
  workflows?: DynamicArgument<Record>;
  memory?: AgentMemoryOption;
  voice?: MastraVoice;
  scorers?: DynamicArgument;
  processors?: {
    input?: InputProcessorOrWorkflow[];
    output?: OutputProcessorOrWorkflow[];
    error?: ErrorProcessorOrWorkflow[];
  };
}

Agent 支持两种 LLM 后端：MastraLLMV1（传统 AI SDK v2）和 MastraLLMVNext（AI SDK v5 循环模式），通过统一接口对外暴露 generate() 和 stream() 方法。Agent 内部维护一个 MessageList 管理对话历史，支持 Observational Memory（观察性记忆）让 Agent 行为连贯。

（更多…）

平均值、最大值、分布规律——几百行数据，三秒钟说出它的故事

一、数据搬进来了，然后呢？

上一篇我们干了件大事：把CSV读进了程序，还能把结果写回去。恭喜，你已经是个合格的”数据搬运工”了。

但搬运工之后呢？想象这个场景：

你按上一篇的办法，把三个月的银行账单.csv读进了程序，屏幕上哗啦啦滚过几百行。然后——就没有然后了。你盯着几百行滚动的记录，脑子里还是一团浆糊：

（更多…）

工资条、账单、通讯录、成绩表——程序世界和Excel世界的第一次握手

一、你的数据，大多锁在表格里

先想想你电脑里有多少表格文件：

• 银行卡导出的账单（.csv 或 .xlsx）
• 公司发的工资条
• 通讯录导出的联系人列表
• 上课时的成绩表、考勤表
• 网店后台导出的订单明细

这些数据有个共同的尴尬：Excel能看，但没法”自动化”。想算点东西要手动拉公式，想整理几百行要拖到手酸，想每周重复做一遍——每周都得重来一次。

从今天起不一样了。我们开始爬阶段3的第一个台阶：文件和数据处理。第一站就是CSV——因为它是表格数据里最简单、最通用、最好上手的格式。

（更多…）

学习25分钟、休息5分钟——把第二十一篇的倒计时升级成完整的工作法工具

一、为什么你学不进去，可能不是意志力的问题

你有没有过这种经历：坐下来学习，刚看了两页书，手机亮了；回完消息想继续，脑子里开始想晚饭吃什么；等回过神，半小时没了，书还在第2页。

结论通常是”我意志力太差”。但有个意大利人不同意。

1980年代，Francesco Cirillo发明了一种方法：不要求你学一整天，只要求你专注25分钟。25分钟后休息5分钟，算一个”番茄”。攒够4个番茄，来一次长休息。

（更多…）

项目: stanfordnlp/dspy | Stars: 37.6k | 许可: MIT

定位: “Programming — not prompting — Foundation Models”

全称: Declarative Self-improving Python

DSPy 是 Stanford NLP 团队开发的声明式语言模型编程框架，核心理念是用组合式 Python 代码替代脆弱的 prompt 工程，通过编译器自动优化 LM 的 prompt 和权重。本文从 10 个维度深入分析其架构设计。

1. 核心哲学：从 Prompt 到 Program 的范式转换

DSPy 的根本创新在于将 LM 调用从”手写 prompt 字符串”提升为”声明式 Python 程序”。用户定义输入/输出签名（Signature），编写组合逻辑（Module），框架自动处理 prompt 构造和优化。

README 中明确阐述：

（更多…）

项目: microsoft/semantic-kernel

Stars: 28.5K+ | License: MIT | 语言: Python / .NET / Java

定位: 企业级 AI Agent SDK，模型无关，支持构建、编排和部署 AI Agent 及多 Agent 系统

一、整体架构概览

Semantic Kernel（SK）是微软推出的模型无关 SDK，其核心设计理念是将 LLM 能力与传统代码通过统一的 Kernel（内核） 模式整合。架构分为四层：

┌─────────────────────────────────────────────┐
│            Agent Layer (Agent 抽象)           │
│  ChatCompletionAgent / AzureAIAgent / ...    │
├─────────────────────────────────────────────┤
│          Kernel Layer (核心调度)              │
│  Plugins → Functions → Filters → Services    │
├─────────────────────────────────────────────┤
│        Connector Layer (AI 服务连接器)        │
│  OpenAI / Azure / HuggingFace / ...          │
├─────────────────────────────────────────────┤
│        Content Layer (内容模型)               │
│  ChatMessage / Streaming / FunctionCall       │
└─────────────────────────────────────────────┘

SK 现已演化为 Microsoft Agent Framework (MAF)，作为其企业级后继者，但 SK 本身仍是 MAF 的核心引擎。

二、十个维度深度分析

1. Kernel 核心 —— 组合式设计

Kernel 是整个框架的中枢调度器，通过多重继承组合了四个扩展能力：

（更多…）

项目: deepset-ai/haystack

定位: 开源 AI 编排框架，用于构建生产级 LLM 应用（RAG、Agent、语义搜索、多模态应用）

版本: Haystack 3.0（2024年发布，重大重构版本）

许可证: Apache-2.0

分析时间: 2026-09

1. 核心架构理念：管道（Pipeline）驱动的组件编排

Haystack 的核心思想是将 AI 应用拆解为可组合的组件（Component），通过有向无环图（DAG）管道连接。每个组件有明确的输入/输出接口，管道负责数据流转、调度执行。

1.1 Pipeline 调度引擎

Pipeline 是 Haystack 的心脏，负责根据执行图（graph）调度组件运行。核心运行循环采用优先队列机制：

# haystack/core/pipeline/pipeline.py - Pipeline.run() 核心循环
while True:
    candidate = self._get_next_runnable_component(priority_queue, component_visits)

    # 如果没有可运行的组件，退出循环
    if candidate is None:
        break

    priority, component_name, component = candidate

    # 如果下一个组件被阻塞，检查管道是否可能被卡住
    if priority == ComponentPriority.BLOCKED:
        if self._is_pipeline_possibly_blocked(current_pipeline_outputs=pipeline_outputs):
            self._find_components_blocking_pipeline(
                priority_queue=priority_queue, component_visits=component_visits, inputs=inputs
            )
        # 总是退出循环，因为无法运行下一个组件
        break

    # 如果下一个组件已经调度，等待任务完成以取得进展
    if component_name in scheduled_components:
        async for partial_outputs in self._wait_for_tasks(
            running_tasks, scheduled_components, return_when=asyncio.FIRST_COMPLETED
        ):
            yield partial_outputs
        continue

    # HIGHEST 优先级组件必须单独运行
    if priority == ComponentPriority.HIGHEST:
        async for partial_outputs in self._run_component_in_isolation(...):
            yield partial_outputs
        continue

    # READY 优先级组件可以并发调度
    if priority == ComponentPriority.READY:
        self._schedule_component(...)
        # 尽可能调度更多 READY 任务
        while len(priority_queue) > 0 and not ready_sem.locked():
            peek_priority, peek_name = priority_queue.peek()
            if peek_priority != ComponentPriority.READY:
                break

1.2 组件执行模型

每个组件的运行被封装为独立的执行单元，支持同步和异步两种路径：

（更多…）

证件、账号、联系方式——把这一路学的所有东西，装进一个真正属于你的程序

一、你有多少”重要信息”散落在各处？

先别写代码，盘点一下：

• 身份证号、护照号、驾照号——平时用不到，用到时找不到
• 各种账号：邮箱、视频网站、购物网站、健身房卡号……
• 家人的身份证号（订机票要用）
• 银行卡号、社保号、保单号
• 重要日期：签证过期、证件到期、保修截止

这些信息有个共同点：不用时想不起，要用时找不到。翻聊天记录、翻抽屉、问家人——每次都要折腾半天。

手机备忘录？可以，但查找麻烦、没法分类、明文摆着还不安全。

（更多…）