CircuitManus: универсальная агентная платформа на Python 81

Что такое CircuitManus?

CircuitManus — это платформа, разработанная на Python, предназначенная в первую очередь для проектирования электрических схем, но также расширяемая и на другие области. Она объединяет большие языковые модели и множество инструментов, помогая автоматизировать сложные задачи. Платформа построена на классической модели, включающей этапы восприятия, планирования, действия, наблюдения и реагирования, а также обладает хорошими возможностями обработки ошибок и самокоррекции. Кроме того, она оснащена WebSocket-сервером на FastAPI и современным веб-интерфейсом, что обеспечивает взаимодействие между бэкендом и фронтендом в реальном времени и оптимизирована для работы в среде Windows.

Основные функции CircuitManus

• Универсальная архитектура агента: следует классической модели цикла агента «восприятие -> планирование -> действие -> наблюдение -> генерация ответа», обладает мощными возможностями обработки ошибок и самокоррекции, способна расширять возможности и автоматизировать различные сложные задачи за счёт интеграции большой языковой модели (LLM) и расширяемого набора инструментов.

• Набор инструментов для проектирования схем: первый набор инструментов ориентирован на область проектирования электрических схем и включает 11 инструментов, таких как добавление компонентов, соединение компонентов, описание схемы, очистка схемы и других, позволяющих выполнять операции, связанные с проектированием схем, с помощью команд на естественном языке.

• Веб-интерфейс взаимодействия в реальном времени: интегрированы WebSocket-сервер на FastAPI и современный веб-интерфейс, обеспечивающий полноценный интеллектуальный интерактивный опыт с поддержкой взаимодействия в реальном времени, управления сеансами и динамического отображения состояния.

• Интеллектуальное планирование и перепланирование: использует LLM для понимания сложных команд и генерации структурированных JSON-планов, с возможностью автоматического перепланирования при сбое выполнения инструмента, что повышает成功率 задач.

• Точное выполнение инструментов и обработка ошибок: поддерживает динамическую регистрацию инструментов, асинхронное выполнение инструментов, повторные попытки на уровне инструментов и прерывание при сбоях, что обеспечивает стабильность и надёжность системы.

• Управление состоянием и памятью: использует многоуровневую систему памяти, управляющую краткосрочной историей диалогов и долгосрочными фрагментами знаний, а также способную хранить объекты состояния для конкретных предметных областей, такие как экземпляры схем.

• Преимущества инженерной реализации: применяются такие инженерные практики, как асинхронное ядро в стиле Python, высокомодульная архитектура и подробное многоуровневое логирование, что повышает удобство сопровождения и масштабируемость кода.

Техническая архитектура CircuitManus

• Бэкенд: основан на Python 3.8+, использует FastAPI для построения WebSocket-сервера, интегрирует модель glm-z1-flash от ai Zhipu для взаимодействия с LLM, а для асинхронной обработки применяется asyncio.

• Фронтенд: современный веб-интерфейс построен с использованием HTML5, CSS3 и нативного JavaScript, обеспечивая взаимодействие в реальном времени и динамическое отображение состояния.

• Набор инструментов: инструменты разделены по функциональным областям, что облегчает расширение инструментами для новых областей; в настоящее время включает две основные категории — операции со схемами и поиск в сети.

• Управление памятью: многоуровневая система памяти управляет историей диалогов и состоянием, специфичным для предметной области, поддерживая независимую от предметной области логику базовой оркестровки.

Шаги развёртывания 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-ключа

Добавьте ваш API-ключ Zhipu AI в файл .env:

ZHIPUAI_API_KEY="YOUR_ZHIPU_API_KEY"

Ссылка на проект

https://github.com/singularguy/CircuitManus