architecturereferencegemini

Архитектура из 6 модулей

Из артефакта Gemini который Дима привёз 29.06. Общий ориентир, не финал. Полный текст: ../reference/gemini-artifact-original.

Модули

┌────────────────────────────────────────────────────────────┐
│  1. Ingestion-адаптеры                                     │
│     Zoom/Jira API (SaaS) | local folder/S3 (On-Prem)       │
└─────────────────────────────────┬──────────────────────────┘
                                  ▼
┌────────────────────────────────────────────────────────────┐
│  2. Слой предобработки                                     │
│     • Парсеры документов (Pandas, OpenPyXL)                │
│     • Аудио + diarization (WhisperX/Deepgram)              │
└─────────────────────────────────┬──────────────────────────┘
                                  ▼
┌────────────────────────────────────────────────────────────┐
│  3. Inference Gateway (LLM абстракция)                     │
│     LiteLLM-style: Claude/GPT (SaaS) | vLLM/Ollama (Prem)  │
└─────────────────────────────────┬──────────────────────────┘
                                  ▼
┌────────────────────────────────────────────────────────────┐
│  4. Core Graph Engine                                      │
│     LangGraph: detеrministic nodes + conditional edges     │
│     Hard `max_loops` лимит чтобы не было tool storms       │
│     Агенты проверяют друг друга и синтезируют              │
└─────────────────────────────────┬──────────────────────────┘
                                  ▼
┌────────────────────────────────────────────────────────────┐
│  5. Storage & Persistence                                  │
│     Postgres + pgvector + LangGraph Checkpointer           │
└─────────────────────────────────┬──────────────────────────┘
                                  ▼
┌────────────────────────────────────────────────────────────┐
│  6. Observability & Security                               │
│     Phoenix (local dev) | Langfuse (production)            │
│     Полностью в контуре клиента                            │
└────────────────────────────────────────────────────────────┘

Что зафиксировано

Python + LangGraph — основной runtime
PostgreSQL + pgvector — единое хранилище state + векторов
LiteLLM-style abstraction для LLM
Two-deployment через .env (two-deployment-pattern)
Hard max_loops в Core Graph — защита от tool storms
Multi-agent с проверкой друг друга — паттерн похож на Living SOPs Kognitos

Что открыто (обсуждаем)

Аудио стек: WhisperX vs Deepgram vs NeMo — есть recommendation
Structured output: Pydantic + LangGraph native + Instructor fallback — есть recommendation
Состав первых 2-3 агентов — обсуждаем с Димой
Vector store на On-Prem: pgvector default, Qdrant как опция при росте

Что в артефакте слабо

Не сказано как разделять "общий код" vs "client-specific code" в two-deployment режиме (это про two-deployment-pattern)
Не сказано про auth/RBAC (важно для трека 2 в Альфе)
Не сказано про eval framework (RAGAS, LangSmith eval, custom) — обязательно для production
"Agents проверяют друг друга и синтезируют" — звучит круто, но без конкретики что именно проверяют

Связано

Metadata

title: Архитектура из 6 модулей (артефакт Gemini)
tags: ['architecture', 'reference', 'gemini']
source: gemini-artifact-2026-06
created: 2026-06-29