EulerAgent – 本地优先 CLI 智能体框架

核心功能

安全性、记忆、编排 -- EulerAgent 的三大支柱

Human-in-the-Loop 安全

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

长期记忆 & RAG

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

工作流编排

Pattern Orchestrator：基于 YAML 的工作流（12 个标准模式）
Graph Orchestrator：基于 LangGraph 的并行执行（实验性）
动态任务分解： --dynamic 选项
判定节点与质量循环：自动输出质量评估与迭代

智能体模板

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

模板	用途
`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 上开始联系我们