Gesgocom.NeuraNetGes 1.5.8

🧠 NeuraNetGes v1.5.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.5.0 (docs)

  • Documentación /docs completamente actualizada a v1.5.0: versiones SDK, Azure migration (Azure.AI.Extensions.OpenAI), Spark/BGE-M3, Extended Thinking GA, streaming Anthropic, AzureContentSafetyGuard, CountTokensAsync y tabla de compatibilidad ampliada.

Novedades v1.5.0

  • Anthropic streaming real: ChatCompletionStreamAsync usa ahora CreateStreaming() del SDK 12.10+ para emitir tokens en tiempo real (antes usaba un fallback síncrono). Los ThinkingDelta se filtran automáticamente.
  • Extended Thinking GA en Claude: Soporte completo de NivelDePensamiento con ThinkingConfigEnabled (Mínimo=1024t, Medio=8000t, Máximo=20000t) y ThinkingConfigAdaptive. Ya en la API estable del SDK (sin .Beta).
  • Tokenizador Claude nativo: CountTokensAsync usa el tokenizador oficial de Claude de SharpToken 2.0.6 (encoding "claude") en lugar de la estimación length/3.5.
  • Gemini server-side tool invocations: Activado IncludeServerSideToolInvocations para recibir resultados de tools MCP server-side, Google Search y Code Execution.
  • Actualización SDK Azure Foundry: Migrado de Azure.AI.Projects.OpenAI (deprecado) a Azure.AI.Extensions.OpenAI 2.0.0 GA. Método GetProjectOpenAIClient() → propiedad ProjectOpenAIClient.
  • Todos los SDKs de proveedores actualizados a sus últimas versiones estables (OpenAI 2.10.0, Google.GenAI 1.6.1, Anthropic 12.11.0, Azure.AI.Projects 2.0.0).

Novedades v1.4.0

  • Spark BGE-M3 como proveedor RAG: Nuevo RagEmbeddingProvider.Spark que 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:

  1. Arquitectura General: Visión de alto nivel y diseño del sistema.
  2. Módulo LLM: Cómo conectar con OpenAI, Gemini, Anthropic, Grok y Azure Foundry.
  3. Seguridad y Guardrails: Blindaje de prompts y validación de salidas.
  4. Gestión de Contexto: Persistencia en DB y optimización de memoria.
  5. Motor de Herramientas (Tools): Ejecución de funciones C# y Tool Calling.
  6. Sistema RAG (Vectorial): Embeddings, pgvector y recuperación semántica.
  7. Guía de Integración RAG: Manual paso a paso para configurar tu Base de Conocimientos.
  8. Multi-Agent SDK (Swarm): Cómo crear enjambres de agentes colaborativos.
  9. Posibilidades del RAG: Casos de uso avanzados y estrategias de recuperación.
  10. SparkClient: Cliente .NET para los 5 servicios del Nvidia Spark: Chat RAG (Qwen3.5-122B), Embeddings (BGE-M3), Reranker, NER y Chatbot multimodal (Gemma 4 E2B).

🖥️ Gesgocom.SparkClient — Hardware Local (Nvidia Spark)

Gesgocom.SparkClient es el cliente .NET para los cinco servicios de IA desplegados en hardware propio (Nvidia Spark vía Tailscale). Disponible como NuGet independiente:

dotnet add package Gesgocom.SparkClient
Servicio Modelo Puerto Uso
Chat RAG Qwen3.5-122B-A10B-GPTQ-Int4 8000 Completions + streaming + tool calling
Embedding BGE-M3 (1024 dims) 8001 Vectores semánticos, coste cero
Reranker BGE-Reranker-v2-m3 8002 Reordenación por relevancia
NER BSC-LT RoBERTa 8003 Extracción PER, LOC, ORG
Chatbot Gemma 4 E2B 8004 Conversacional + multimodal (texto, imagen) 
// Sin DI — todos los servicios de un golpe
var spark = new SparkClient();  // host por defecto: http://spark-a4ce

var reply  = await spark.Chat.CompleteAsync([SparkChatMessage.User("Explica el RGPD")]);
var vecs   = await spark.Embedding.EmbedBatchAsync(["texto1", "texto2"]);
var ranked = await spark.Reranker.RerankAsync("contrato menor", docs, topN: 5);
var ents   = await spark.Ner.AnalyzeAsync("Ana García trabaja en Madrid.");
var vision = await spark.Chatbot.CompleteAsync([SparkChatMessage.UserWithImage("¿Qué ves?", imageUrl)]);

Consulta la guía completa del SparkClient para uso con DI, timeouts, streaming, tool calling y mensajes multimodales.

🛠️ 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

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