CircuitManus: una plataforma de agentes通用 basada en Python 83

¿Qué es CircuitManus?

CircuitManus es una plataforma desarrollada en Python, utilizada principalmente para el diseño de circuitos, pero que también puede ampliarse a otros campos. Combina grandes modelos de lenguaje con múltiples herramientas, lo que ayuda a automatizar tareas complejas. La plataforma se basa en un modelo clásico que incluye percepción, planificación, acción, observación y respuesta, y además cuenta con buenas capacidades de tolerancia a fallos y autocorrección. Asimismo, incorpora un servidor FastAPI WebSocket y una interfaz web moderna, lo que garantiza la interacción en tiempo real entre el backend y el frontend, con optimización específica para entornos Windows.

Funciones principales de CircuitManus

• Arquitectura de agente de propósito general: sigue el modelo clásico de bucle de agente de percepción -> planificación -> acción -> observación -> generación de respuesta, con potentes capacidades de tolerancia a fallos y autocorrección, capaz de potenciar y automatizar diversas tareas complejas mediante la integración de grandes modelos de lenguaje (LLM) y un conjunto de herramientas extensible.

• Conjunto de herramientas de diseño de circuitos: el primer conjunto de herramientas se centra en el campo del diseño de circuitos e incluye 11 herramientas, como añadir componentes, conectar componentes, describir circuitos, vaciar circuitos, etc., capaces de realizar operaciones relacionadas con el diseño de circuitos mediante instrucciones en lenguaje natural.

• Interfaz web de interacción en tiempo real: integra un servidor FastAPI WebSocket y una interfaz de usuario web moderna, ofreciendo una experiencia de interacción inteligente completa, compatible con interacción en tiempo real, gestión de sesiones, visualización dinámica del estado y otras funciones.

• Planificación y replanificación inteligente: utiliza LLM para comprender instrucciones complejas y generar planes JSON estructurados, capaz de replanificar automáticamente cuando falla la ejecución de una herramienta, mejorando la tasa de éxito de las tareas.

• Ejecución precisa de herramientas y tolerancia a fallos: admite registro dinámico de herramientas, ejecución asíncrona de herramientas, reintentos a nivel de herramienta y aborto por fallo, garantizando la estabilidad y fiabilidad del sistema.

• Gestión de estado y memoria: adopta un sistema de memoria jerárquico para gestionar el historial de conversaciones a corto plazo y los fragmentos de conocimiento a largo plazo, y puede contener objetos de estado específicos de un dominio, como instancias de circuitos.

• Ventajas de ingeniería: adopta buenas prácticas de ingeniería como un núcleo asíncrono pythonic, un diseño altamente modular y un registro detallado por niveles, lo que mejora la mantenibilidad y escalabilidad del código.

Arquitectura técnica de CircuitManus

• Backend: basado en Python 3.8+, utiliza FastAPI para construir el servidor WebSocket, integra el modelo glm-z1-flash de ai de Zhipu para la interacción con el LLM y emplea asyncio para el procesamiento asíncrono.

• Frontend: utiliza HTML5, CSS3 y JavaScript nativo para construir una interfaz de usuario web moderna, que ofrece interacción en tiempo real y visualización dinámica del estado.

• Conjunto de herramientas: las herramientas se separan por áreas funcionales, lo que facilita la ampliación con herramientas de nuevos campos; actualmente incluye dos grandes categorías: operaciones de circuitos y búsqueda web.

• Gestión de memoria: sistema de memoria jerárquico que gestiona el historial de conversaciones y el estado específico del dominio, compatible con una lógica de orquestación central independiente del dominio.

Pasos para desplegar CircuitManus

1. Clonar el repositorio

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

2. Crear y activar un entorno virtual

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

3. Instalar dependencias

pip install -r requirements.txt

4. Configurar la clave de API

Añade tu clave de API de Zhipu AI al archivo .env:

ZHIPUAI_API_KEY="YOUR_ZHIPU_API_KEY"

Enlace del proyecto

https://github.com/singularguy/CircuitManus