ia-agent-dotnet 0.5.2

IA Agent para Generación de Pruebas Unitarias .NET - Sistema multi-agente inteligente

IA Agent para Generación de Pruebas Unitarias .NET

Un sistema multi-agente de IA avanzado con capacidades de memoria y herramientas externas (ReAct) especializado en la generación automática de pruebas unitarias para APIs REST desarrolladas en .NET.

🚀 Características Principales

• 🤖 Sistema Multi-Agente: Colaboración inteligente entre agentes especializados
• 🧠 Memoria Persistente: Recuerda conversaciones y contexto entre sesiones
• 🛠️ Herramientas Externas: Ejecuta código y busca documentación automáticamente
• 🔄 Patrón ReAct: Razonamiento y actuación iterativa para decisiones autónomas
• 🎯 Especialización: Agentes especializados en análisis, generación, validación y optimización
• 📊 Soporte Multi-Framework: xUnit, NUnit, MSTest
• ⚡ Ejecución Windows: CLI optimizada para terminal de comandos

🏗️ Arquitectura

El sistema utiliza LangChain para capacidades ReAct individuales y AutoGen para colaboración entre agentes especializados:

• Agente Analista: Analiza código .NET y extrae información
• Agente Generador: Genera código de pruebas y templates
• Agente Validador: Valida código y ejecuta pruebas
• Agente Optimizador: Optimiza pruebas y sugiere mejoras
• Agente Coordinador: Coordina tareas y gestiona flujos de trabajo

📦 Instalación Rápida

# Crear entorno virtual
python -m venv ia-agent-env
ia-agent-env\Scripts\activate

# Instalar dependencias
pip install -r requirements.txt

# Configurar API keys
ia-agent config --setup

🎯 Uso Básico

Modo Interactivo (Recomendado)

ia-agent interactive

Comandos Directos

# Generar pruebas para un controlador
ia-agent generate --controller "UserController" --output "./Tests"

# Analizar cobertura de pruebas
ia-agent analyze --coverage --report-format html

# Optimizar pruebas existentes
ia-agent optimize --tests "./Tests" --framework xunit

Modo Multi-Agente

# Activar colaboración entre agentes
ia-agent multi-agent --mode collaborative

# Ver colaboración en tiempo real
ia-agent multi-agent --monitor

📋 Requisitos del Sistema

• Sistema Operativo: Windows 10/11 (64-bit)
• Python: 3.11 o superior
• .NET SDK: 8.0 o superior
• Memoria RAM: 8GB mínimo, 16GB recomendado
• Conexión a Internet: Para APIs de IA

🔧 Configuración

Configuración de API Keys

# Opción 1: Configuración interactiva (RECOMENDADO)
ia-agent config

# Opción 2: Configuración manual
copy env.example .env
# Editar .env con tu API key

Proveedores disponibles:

• DeepSeek (Recomendado) - Especializado en programación, más económico
• Gemini - Google AI, bueno para análisis general
• OpenAI - Estándar de la industria, más caro

Archivo de Configuración

# config/agent_configs/default.yaml
agent:
  mode: "multi-agent"
  memory:
    type: "persistent"
    storage_path: "./memory"

ai:
  provider: "deepseek"
  model: "deepseek-coder"
  temperature: 0.1

📚 Documentación

• 📋 Requisitos Funcionales y Técnicos
• 🏗️ Arquitectura del Sistema
• 📖 Guía de Instalación y Uso
• 🎯 Plan de Desarrollo Completo

🛠️ Desarrollo

Estructura del Proyecto

ia-agent-unit-tests/
├── src/
│   ├── agents/                 # Agentes especializados
│   ├── multi_agent/            # Sistema multi-agente
│   ├── langchain_agents/       # Agentes individuales
│   ├── tools/                  # Herramientas del agente
│   └── cli/                    # Interfaz CLI
├── templates/                  # Templates de pruebas
├── memory/                     # Almacenamiento de memoria
├── config/                     # Configuraciones
└── docs/                       # Documentación

Contribuir

1. Fork el repositorio
2. Crear rama de feature (git checkout -b feature/nueva-funcionalidad)
3. Commit cambios (git commit -am 'Agregar nueva funcionalidad')
4. Push a la rama (git push origin feature/nueva-funcionalidad)
5. Crear Pull Request

📊 Estado del Proyecto

✅ Fases Completadas

Fase 1: Análisis y Diseño ✅

• Estructura del proyecto creada
• Dependencias configuradas
• Repositorio Git inicializado
• Archivos de configuración creados
• Requisitos documentados
• Arquitectura diseñada

Fase 2: Desarrollo del Sistema Multi-Agente ✅

• Agentes especializados implementados
• Sistema de memoria vectorial
• Herramientas .NET integradas
• CLI básico funcional
• Sistema de logging implementado

Fase 3: Funcionalidades Avanzadas ✅

• Suite de testing completa
• Mejoras de IA implementadas
• Sistema de monitoreo
• Documentación de API
• Optimizaciones de rendimiento

Fase 4: Optimización y Despliegue ✅

• Sistema de configuración robusto
• Manager de memoria optimizado
• Optimizador de rendimiento
• Manejador de errores avanzado
• Configuración Docker completa
• Scripts de despliegue automatizado
• Validador de producción

Fase 5: Documentación Final y Entrega ✅

• Guía de usuario completa
• Guía de desarrollador
• Guía de despliegue
• Documentación de API
• Guía de solución de problemas
• Changelog del proyecto
• Licencia MIT

🎯 Versión Actual: v0.4.0

• Estado: ✅ COMPLETADO Y LISTO PARA PRODUCCIÓN
• Funcionalidades: 25+ características principales
• Tests: 100% de componentes cubiertos
• Documentación: 5 guías completas
• Despliegue: Docker y scripts automatizados

🤝 Soporte

• GitHub Issues: Para reportar bugs y solicitar features
• Documentación: Wiki completa con ejemplos
• Email: [e-mail]

📄 Licencia

Este proyecto está bajo la Licencia MIT. Ver el archivo LICENSE para más detalles.

🙏 Agradecimientos

• LangChain - Framework para agentes con capacidades ReAct
• AutoGen - Framework para colaboración multi-agente
• OpenAI - APIs de IA para generación de código
• Comunidad .NET por las mejores prácticas de testing

---

Desarrollado con ❤️ para la comunidad .NET