首页 > 产品 > EulerAgent

EulerAgent

确定性 CLI 智能体框架

本地优先的智能体框架，具备 8 步状态机（RUN_CREATED → CONTEXT → PLAN → PROPOSE → APPROVE → EXECUTE → RESULT → FINALIZED）、Pattern/Graph 编排器、RAG 管线、长期记忆（SQLite）、MCP 集成、插件系统，并以人工审批（HITL）为基础。它在以代码（而非 LLM）执行验证的确定性门控节点（kind: shell）之上，提供能自行编写、测试并修复代码的自愈式编码代理（code.dev_loop.v2）。30+ 个 CLI 命令，65 个 fixture。

Open Source

核心功能

8 步状态机、记忆、编排、MCP、插件 -- EulerAgent 的核心支柱

Human-in-the-Loop 安全

  • Deny-All 安全模型：所有工具默认禁用，需明确授权
  • 人类审批必需：高风险操作（文件写入、Shell 执行、外部调用）必须经过人类审批
  • 8 步状态机： RUN_CREATED → CONTEXT → PLAN → PROPOSE → APPROVE → EXECUTE → RESULT → FINALIZED
  • 完整审计追踪：通过 Audit Trail 记录所有操作

长期记忆 & RAG

  • 基于 SQLite：对话历史和向量搜索
  • 自动上下文提取：自动学习用户偏好和项目上下文
  • 混合 RAG：本地知识库 + 网络搜索
  • MCP 搜索提供者：集成 Brave、Tavily 等

工作流编排

  • Pattern Orchestrator：基于 YAML 的工作流 —— LLM · 判定(judge) · 确定性 shell 门控节点（12 个规范模式，5 个内置）
  • 确定性门控节点 NEW：以代码而非 LLM 执行验证 —— 通过 exit_code / success_condition DSL 分支（认知=LLM、确定性=代码 相互分离）
  • 自愈式编码代理 NEW：code.dev_loop.v2 —— explore → plan → write → syntax/symbol 门控 → test → judge → fix 循环自主运行
  • Graph Orchestrator：基于 LangGraph 的并行执行（实验性）

智能体模板

使用适合用途的模板快速创建智能体

模板 用途
personal-assistant 通用个人助理
marketing-expert 营销内容创作
code-assistant 代码编写与调试
ops-assistant 运维与基础设施管理

CLI 快速入门

一条命令即可创建并运行智能体

# 初始化工作区
euleragent init

# 创建智能体
euleragent new my-assistant --template personal-assistant

# Plan 模式运行（先提议后审批）
euleragent run my-assistant --task "撰写项目摘要" --mode plan

# Execute 模式运行（低风险自动执行）
euleragent run my-assistant --task "代码重构" --mode execute

# 审批管理
euleragent approve list
euleragent approve accept <id> --actor "user:name" --execute

# 交互式聊天（启用长期记忆）
euleragent chat my-assistant --project default --continue

CLI 参考

EulerAgent 完整命令体系

核心命令

命令 说明
euleragent init 初始化工作区
euleragent new 从模板创建智能体
euleragent run 运行智能体（plan/execute 模式）
euleragent chat 交互式聊天会话
euleragent logs 查看执行审计日志
euleragent doctor 系统健康检查

审批管理

命令 说明
euleragent approve list 待审批列表
euleragent approve show <id> 审批详情
euleragent approve accept <id> 接受并执行审批
euleragent approve reject <id> 拒绝审批
euleragent approve accept-all 批量审批

知识库 (RAG)

命令 说明
euleragent rag init 初始化知识库
euleragent rag add --path ./docs/ 添加文档
euleragent rag query --q "搜索词" 搜索知识库
euleragent rag status 查看 KB 状态

记忆管理

命令 说明
euleragent memory status 记忆存储统计
euleragent memory search --q "搜索词" 搜索历史对话

工作流 & 模式

命令 说明
euleragent workflow show <run-id> 工作流结构与状态
euleragent workflow resume <run-id> 恢复工作流
euleragent pattern list 列出可用模式
euleragent pattern run <pattern> <agent> 运行基于模式的工作流

MCP 管理

命令 说明
euleragent mcp sync 同步 MCP 服务器目录
euleragent mcp show 当前 MCP 状态

教程

通过分步指南掌握 EulerAgent

韩语版详细教程 | English Tutorials

教程即将公开。

安装与入门

安装 EulerAgent 并运行您的第一个智能体

安装

pip install euleragent

# 下载 Ollama 模型
ollama pull qwen3:32b

# 初始化工作区
euleragent init

系统要求

  • Python 3.11+
  • Ollama（或 OpenAI/Gemini API 密钥）

GitHub

eulerwa/euleragent

配置示例

通过 workspace.yaml 声明式配置智能体环境

workspace.yaml

llm_profiles: local: provider: ollama model: qwen3:32b openai: provider: openai model: gpt-4o-mini is_external: true default_llm_profile: local memory: enabled: true mcp: enabled: true

使用 EulerAgent 开始构建安全的 AI 智能体

开源、基于人类审批、本地优先执行。

在 GitHub 上开始 联系我们