Gesgocom.NeuraNetGes 1.4.0
🧠 NeuraNetGes v1.4.0
Librería .NET empresarial para la orquestación unificada de Large Language Models (LLM), Agentic RAG y Sistemas de Enjambres Multi-Agente.
Diseñada para entornos de alta carga con soporte nativo de seguridad (Guardrails), persistencia en PostgreSQL y gestión asíncrona de contexto.
Novedades v1.4.0
- Spark BGE-M3 como proveedor RAG: Nuevo
RagEmbeddingProvider.Sparkque integra BGE-M3 (1024 dims) en el pipeline RAG a coste cero via hardware local. - Agentic RAG: Búsqueda vectorial activa donde el LLM decide qué investigar.
- Multi-Agent SDK: Crea enjambres donde un LLM puede delegar tareas a otros sub-LLMs especializados.
- Guardrails de Seguridad: Protección contra inyecciones de prompt, PII y fugas de secretos.
- Memory 3.0: Condensación asíncrona de contexto para mantener costes bajos en chats largos.
🚀 ¿Qué es NeuraNetGes?
NeuraNetGes es más que un simple cliente para APIs de IA. Es un Framework de Orquestación que permite construir aplicaciones inteligentes, seguras y escalables utilizando los mejores proveedores del mercado (OpenAI, Gemini, Anthropic, Grok, Groq, Azure Foundry y Spark) bajo una única interfaz unificada.
Proveedores de Embeddings RAG
| Proveedor | Modelo | Dimensiones | Coste |
|---|---|---|---|
| Spark | BGE-M3 | 1024 | Cero (hardware local) |
| Azure Foundry | text-embedding-3-large | 3072 | Por uso |
| OpenAI | text-embedding-3-small/large | 1536/3072 | Por uso |
| Google Gemini | gemini-embedding-001 | 768/1536/3072 | Por uso |
📖 Índice de Documentación Técnica
Para profundizar en cada módulo, consulta nuestras guías detalladas en el directorio /docs:
- Arquitectura General: Visión de alto nivel y diseño del sistema.
- Módulo LLM: Cómo conectar con OpenAI, Gemini, Anthropic, Grok y Azure Foundry.
- Seguridad y Guardrails: Blindaje de prompts y validación de salidas.
- Gestión de Contexto: Persistencia en DB y optimización de memoria.
- Motor de Herramientas (Tools): Ejecución de funciones C# y Tool Calling.
- Sistema RAG (Vectorial): Embeddings, pgvector y recuperación semántica.
- Guía de Integración RAG: Manual paso a paso para configurar tu Base de Conocimientos.
- Multi-Agent SDK (Swarm): Cómo crear enjambres de agentes colaborativos.
- Posibilidades del RAG: Casos de uso avanzados y estrategias de recuperación.
🛠️ Inicio Rápido
1. Instalación
dotnet add package Gesgocom.NeuraNetGes
2. Configuración Mínima
builder.Services.AddNeuraNetGes(options => {
options.OpenAIApiKey = "tu_clave";
options.AnthropicApiKey = "tu_clave";
options.AzureFoundryEndpoint = "https://tu-endpoint.models.ai.azure.com";
// (Opcional) Extracción avanzada de PDFs con Azure Document Intelligence
options.AzureDocumentIntelligenceEndpoint = "https://tu-document-intelligence.cognitiveservices.azure.com";
});
3. Tu primer Agente con Herramientas
var request = new GenericRequest {
Model = "gpt-5-mini",
Prompt = "¿Qué hora es en Madrid?",
ToolsEnabled = true
};
// Registro automático de herramientas estándar (Reloj, Disco Duro, etc.)
_toolRegistry.RegisterStandardTools();
var response = await _llmService.ChatCompletionAsync(request);
Console.WriteLine(response.Content);
🎯 ¿Por qué elegir NeuraNetGes?
| Beneficio | NeuraNetGes | Otros Wrappers |
|---|---|---|
| Agnóstico al Proveedor | ✅ | ❌ |
| Seguridad Nativa | ✅ | ❌ |
| Gestión de Memoria en DB | ✅ | ❌ |
| Orquestación Multi-Agente | ✅ | ❌ |
| RAG Correctivo (C-RAG) | ✅ | ❌ |
📄 Licencia y Contribución
Este proyecto es propiedad de Gescom. Para más detalles sobre cambios recientes, consulta el CHANGELOG.md.
"Construyendo el futuro de la IA agéntica en .NET"
No packages depend on Gesgocom.NeuraNetGes.
.NET 10.0
- Gesgocom.SparkClient (>= 1.0.0)
- SharpToken (>= 2.0.4)
- ReverseMarkdown (>= 5.2.0)
- PdfPig (>= 0.1.13)
- OpenAI (>= 2.9.1)
- Npgsql (>= 10.0.2)
- Newtonsoft.Json (>= 13.0.4)
- Microsoft.ML.Tokenizers.Data.O200kBase (>= 2.0.0)
- Microsoft.ML.Tokenizers.Data.Cl100kBase (>= 2.0.0)
- Microsoft.ML.Tokenizers (>= 2.0.0)
- Microsoft.Extensions.Options (>= 10.0.5)
- Microsoft.Extensions.Logging.Abstractions (>= 10.0.5)
- Microsoft.Extensions.Hosting.Abstractions (>= 10.0.5)
- Microsoft.Extensions.DependencyInjection.Abstractions (>= 10.0.5)
- Microsoft.Extensions.DependencyInjection (>= 10.0.5)
- Microsoft.Bcl.Memory (>= 10.0.5)
- Markdig (>= 1.1.1)
- Google.GenAI (>= 1.4.0)
- Gesgocom.MicroOrmGesg (>= 1.2.5)
- DocumentFormat.OpenXml (>= 3.4.1)
- Dapper (>= 2.1.72)
- Azure.Identity (>= 1.19.0)
- Azure.AI.Projects.OpenAI (>= 2.0.0-beta.1)
- Azure.AI.Projects (>= 2.0.0-beta.1)
- Azure.AI.DocumentIntelligence (>= 1.0.0)
- Azure.AI.ContentSafety (>= 1.0.0)
- Anthropic (>= 12.8.0)
- AngleSharp (>= 1.4.0)
- Microsoft.Extensions.Caching.Memory (>= 10.0.5)
| Version | Downloads | Last updated |
|---|---|---|
| 1.5.8 | 9 | 04/15/2026 |
| 1.5.7 | 9 | 04/15/2026 |
| 1.5.6 | 3 | 04/15/2026 |
| 1.5.5 | 1 | 04/15/2026 |
| 1.5.4 | 14 | 04/13/2026 |
| 1.5.3 | 5 | 04/13/2026 |
| 1.5.2 | 2 | 04/13/2026 |
| 1.5.1 | 5 | 04/10/2026 |
| 1.4.6 | 14 | 04/03/2026 |
| 1.4.5 | 3 | 04/03/2026 |
| 1.4.4 | 20 | 03/17/2026 |
| 1.4.3 | 7 | 03/16/2026 |
| 1.4.1 | 11 | 03/15/2026 |
| 1.4.0 | 2 | 03/15/2026 |
| 1.3.10 | 30 | 03/14/2026 |
| 1.3.9 | 4 | 03/14/2026 |
| 1.3.7 | 2 | 03/14/2026 |
| 1.3.6 | 28 | 03/03/2026 |
| 1.3.5 | 2 | 03/03/2026 |
| 1.3.4 | 2 | 03/03/2026 |
| 1.3.3 | 2 | 03/03/2026 |
| 1.3.2 | 1 | 03/03/2026 |
| 1.3.1 | 3 | 02/23/2026 |
| 1.2.1 | 1 | 02/22/2026 |
| 1.1.1 | 1 | 02/22/2026 |
| 1.0.49 | 1 | 02/22/2026 |
| 1.0.47 | 1 | 02/22/2026 |
| 1.0.46 | 4 | 02/09/2026 |
| 1.0.45 | 1 | 02/09/2026 |