CircuitManus：基于Python的通用智能体平台

CircuitManus是什么？

CircuitManus是一个用Python开发的平台，主要用于电路设计，但也能扩展到其他领域。它结合了大型语言模型和多种工具，有助于自动化复杂任务。平台基于一个经典的模型，包括感知、规划、行动、观察和响应等环节，还具备不错的容错和自我修正功能。此外，它配备了FastAPI WebSocket服务器和现代化的Web界面，确保后端和前端能够实时交互，且在Windows环境下进行了优化。

CircuitManus核心功能

• 通用智能体架构：遵循感知->规划->行动->观察->响应生成的经典智能体循环模型，具备强大的容错和自我修正能力，能够通过集成大语言模型（LLM）和可扩展的工具集来赋能和自动化各类复杂任务。

• 电路设计工具集：首批工具集聚焦于电路设计领域，包含11个工具，如添加元件、连接元件、描述电路、清空电路等，能够通过自然语言指令完成电路设计相关操作。

• 实时交互Web界面：集成FastAPI WebSocket服务器和现代化Web UI，提供完整的智能交互体验，支持实时交互、会话管理、动态状态展示等功能。

• 智能规划与重规划：利用LLM理解复杂指令，生成结构化JSON计划，当工具执行失败时能够自动重规划，提升任务成功率。

• 精确工具执行与容错：支持动态工具注册、异步工具执行、工具级重试和失败中止，确保系统的稳定性和可靠性。

• 状态与记忆管理：采用分层记忆系统，管理短期对话历史、长期知识片段，并可持有特定领域的状态对象，如电路实例。

• 工程实践优势：采用Pythonic异步核心、高度模块化设计、详细分级日志等工程实践，提升代码的可维护性和可扩展性。

CircuitManus技术架构

• 后端：基于Python 3.8+，使用FastAPI构建WebSocket服务器，集成智谱ai的glm-z1-flash模型进行LLM交互，采用asyncio实现异步处理。

• 前端：使用HTML5、CSS3和原生JavaScript构建现代化Web UI，提供实时交互和动态状态展示。

• 工具集：工具按功能领域分离，易于扩展新领域工具，当前包含电路操作和网络搜索两大类工具。

• 记忆管理：分层记忆系统，管理对话历史和领域特定状态，支持领域无关的核心编排逻辑。

CircuitManus部署步骤

1. 克隆仓库

git clone https://github.com/singularguy/CircuitManus
cd IDT_AGENT_NATIVE

2. 创建虚拟环境并激活

python -m venv venv
.\venv\Scripts\activate

3. 安装依赖

pip install -r requirements.txt

4. 配置 API 密钥

将你的智谱 AI API 密钥添加到 .env 文件中：

ZHIPUAI_API_KEY="YOUR_ZHIPU_API_KEY"

项目链接

https://github.com/singularguy/CircuitManus