Agentic Architectures（智能体架构库）

涵盖 35 种生产级智能体 AI 模式，端到端实现。

这是一个集代码库与实战教材于一体的项目，包含真实的 LLM 输出、多模型服务提供商支持、贯穿始终的“确定性选择器”（deterministic-picker）规范，以及一个将每种架构与相关任务进行排名的对比基准测试排行榜。

  35  种架构   283  个测试用例   17  个基准测试任务   9  个 LLM 提供商   0  个模拟运行

---

概述

这是一个单一的 Python 库，它将文献中所有主流的智能体 AI 模式封装为具有统一契约的 Architecture 类。每种模式都附带了一个完整的 Jupyter Notebook，其理论基于实际运行的捕捉结果而非模拟示例。该库支持多种 LLM 提供商（Nebius、OpenAI、Anthropic、Groq、Ollama、Together、Fireworks、Mistral、Google），并构建在 LangGraph 状态机之上。

本项目的核心技术规范是 “确定性选择器”（deterministic-picker）模式 —— 每个作为评分器的 LLM 接口都会强制要求 LLM 输出分类特征（布尔值、枚举值），并由 Python 代码来决定最终决策信号。这是规避“LLM 作为评分器”时常见平庸反馈病理的通用方法，该模式被应用于 35 种架构中的 13 种，另有 9 种从架构设计层面天然具备免疫力。

---

快速入门

pip install "agentic-architectures[nebius,faiss,tavily]"

from agentic_architectures import get_llm
from agentic_architectures.architectures import Reflection

arch = Reflection(llm=get_llm(), max_iterations=2, target_score=8)
result = arch.run("Write a haiku about a glacier.")

print(result.output)
print("score:", result.metadata["final_score"], "/ 10")

所有 35 种架构都使用相同的 .run(task) 接口，并返回统一的 ArchitectureResult 格式。只需更换类名即可切换模式，无需修改下游代码。

从克隆项目开始设置虚拟环境：

git clone https://github.com/FareedKhan-dev/all-agentic-architectures
cd all-agentic-architectures

python -m venv .venv
.venv\Scripts\activate              # Windows
source .venv/bin/activate           # macOS / Linux

pip install -e ".[dev,test,docs,nebius,faiss,tavily,networkx]"
cp .env.example .env                # 然后填写 NEBIUS_API_KEY 等配置

pytest -q                           # 约 30 秒内完成 283 个测试

---

架构分类

推理与反思 (Reasoning & Reflection)

通过迭代进行自我批判，从而提升回答质量。 Reflection · Reflexion · Chain-of-Verification · Self-Discover · Constitutional AI

采样与搜索 (Sampling & Search)

对多条路径进行采样或通过奖励机制构建决策树。 Self-Consistency · Tree of Thoughts · LATS · Mental Loop · Ensemble

检索 (Retrieval / RAG)

为每个论点提供依据——涵盖五种检索形式。 Agentic RAG · Corrective RAG · Self-RAG · Adaptive RAG · GraphRAG

记忆 (Memory)

跨调用学习——支持多种存储方式。 Episodic + Semantic · Graph Memory · MemGPT · Voyager · Agent Workflow Memory

工具与行动 (Tools & Actions)

从单一搜索工具到真实的 Chromium 浏览器操作。 Tool Use · ReAct · Planning · PEV · SWE-Agent · BrowserAgent

多智能体 (Multi-Agent)

专家协作、辩论、多视角研究。 Multi-Agent · Blackboard · Debate · STORM · Meta-Controller

安全与路由 (Safety & Routing)

通过确定性 Python 门控实现分类行动。 Dry-Run · Reflexive Metacognitive · Computer Use

特定领域 (Specialty)

具有独特形态的模式。 RLHF Self-Improvement · Cellular Automata

交叉领域 (Cross-cutting)

在不同分类中反复出现的模式。 Deterministic-picker · Memory variants

---

35 种架构列表

推理与反思

架构	模式	参考