YACHAQ.DEV/Arquitectura
Arquitectura

Sistema
completo

Un agente empresarial es un sistema con partes que puedes reemplazar. El Asistente Yachaq separa ejecución, razonamiento y memoria en tres servicios con un contrato de datos explícito.

El principio

Por qué tres
servicios

Escala independiente

La memoria crece con el uso; el orquestador escala con la carga. Sepáralos y escala solo lo que lo necesita.

Reemplazable

La generación de lenguaje es una pieza más. Cambia de proveedor manteniendo intactas la memoria y la orquestación.

Auditable

Cada servicio es un repositorio Apache 2.0 con su propia API documentada y sus propias pruebas.

Los tres componentes

Ejecución.
Razonamiento.
Recuerdo.

01 · Orquestación y ejecución

SomaAgent01

El orquestador. Recibe una petición, la descompone, decide qué herramientas invocar y coordina especialistas. Es la capa que convierte intención en acciones dentro de entornos multi-tenant.

somaagent01 ↗
BackendDjango 5.1 + Django Ninja
FrontendLit 3.x (Web Components)
DatosPostgreSQL 16 · Redis 7
EventosKafka 3.7 (KRaft)
VectoresMilvus 2.3
IdentidadKeycloak 24 · SpiceDB · OPA
API:20020 (Standalone)
DespliegueStandalone · clúster soma-stack-net · Kubernetes
02 · Procesamiento y razonamiento

SomaBrain

El cerebro. Mantiene la memoria de trabajo, consolida lo aprendido y modula la atención. Usa representaciones hiperdimensionales (HRR/BHDC) de 8.192 dimensiones para recuperar contexto en O(1).

somabrain ↗
RuntimePython 3.12
Núcleo cognitivoHRR / BHDC · 8192 dimensiones
RecuperaciónO(1) por índice algebraico
Núcleo nativoRust · somabrain_rs
SecretosVault · gestionados en Vault
API:30101
Rango de puertos30100–30111
03 · Almacenamiento y recuerdo

SomaFractalMemory

La memoria de largo plazo. Persiste recuerdos episódicos y semánticos en Milvus, los busca por similitud y expone un grafo fractal de relaciones para el recuerdo asociativo.

somafractalmemory ↗
RuntimePython 3.12
VectoresMilvus · 768 dimensiones
MetadatosPostgreSQL · Redis
AuthBearer SOMA_API_TOKEN + X-Soma-Tenant
API:10101
Rango de puertos10xxx
El punto de unión

768 dimensiones

El vector de embeddings es el contrato entre razonamiento y memoria. Los tres servicios comparten la misma dimensión.

Configúralo idéntico en todo el sistema para que el recuerdo semántico sea preciso. La dimensión compartida es la pieza clave de la integración, y vive en un solo valor.

VariableMEM_EMBED_DIM · EMBED_DIM · SOMA_VECTOR_DIM
Valor768
Debe coincidir enSomaAgent01 · SomaBrain · SomaFractalMemory
.env — punto de unión
# SomaAgent01
MEM_EMBED_DIM=768

# SomaBrain
EMBED_DIM=768

# SomaFractalMemory
SOMA_VECTOR_DIM=768
SOMA_API_TOKEN=your-token
Un ciclo completo

El viaje
de una pregunta

1

Entrada

SomaAgent01 recibe la petición del usuario y el contexto de sesión.

2

Plan

Descompone la tarea y decide herramientas y especialistas.

3

Recuerdo

SomaFractalMemory devuelve memorias por similitud semántica de 768 dims.

4

Razonamiento

SomaBrain consolida el contexto en su memoria de trabajo hiperdimensional.

5

Respuesta

El LLM redacta con el contexto recuperado y el ciclo se persiste para la próxima vez.

Preguntas frecuentes

Dudas
comunes

¿Necesito un modelo de lenguaje concreto?

El asistente es agnóstico de modelo. SomaAgent01 conecta cualquier modelo con una interfaz estándar: el asistente aporta ejecución, razonamiento y memoria.

¿Puedo auto-alojar el asistente?

Sí. Los tres repositorios son Apache 2.0 y se despliegan con Docker Compose en tu propia infraestructura, con control total de tu stack.

¿Qué une a SomaBrain y SomaFractalMemory?

El vector de embeddings de 768 dimensiones. SomaBrain razona sobre él y SomaFractalMemory lo persiste y lo busca por similitud. Debe configurarse idéntico en ambos.

¿Los repositorios deben estar uno al lado del otro?

Sí. El arranque integrado resuelve los servicios por ruta relativa y los une por la red soma-stack-net, así que clona los tres repositorios en el mismo directorio padre y ejecuta ./up-cluster.sh desde somaagent01/infra/standalone.

Quickstart Despliegue API Repositorios