docs(corpus-seed): add OSVauco knowledge base seed document for RAG Engine

This document provides an overview of the OSVauco AI-driven operating system, including its architecture, agent details, infrastructure scripts, known issues, cost model, and GCP configuration.

2026-05-23 05:35:28 +02:00

3.6 KiB

Raw Blame History

OSVauco Knowledge Base

Hva er OSVauco?

OSVauco er et AI-drevet operativsystem (OPAX) som kjører på Google Cloud. Du er første kunde. Når det virker for deg → selg det til andre.

Prosjekt: propane-will-491900-m5 Region: us-central1 Primær repo: chrischristiansen-glitch/OSVauco

Repo-oversikt

Repo	Hva det er
OSVauco	Regler, GCP-scripts, agenter, docs — KJERNEN
vauco-gemini-tui-bridge	TUI-cockpit
vauco-os	Det kundene bruker
vauco-bootstrap	Onboarding av nye kunder
deep-dream	Strategisk visjon — aldri deploy herfra

Agentarkitektur

OSVauco bruker Google ADK 2.0 (Agent Development Kit) med Vertex AI / Gemini.

Agenter

root_agent (gcp-orchestrator): Orkestrerer alle sub-agenter
rag_agent: RAG-søk mot Vertex AI RAG Engine-corpus
memory_agent: Persistent minne via Vertex AI Memory Bank (Agent Engine)
tools_agent: GCP-verktøy (gcloud, Storage, Monitoring)

Teknologistack

Runtime: Cloud Run (skaler til 0, ingen idle-kostnad)
LLM: Gemini 2.0 Flash (orkestrering) + Gemini 2.0 Flash (sub-agenter)
RAG: Vertex AI RAG Engine (text-embedding-005)
Minne: Vertex AI Memory Bank / Agent Engine
CI/CD: Cloud Build + GitHub OAuth
Observability: Cloud Monitoring + Cloud Logging
Sikkerhet: IAP (Identity-Aware Proxy) på opax.vauco.no

Infrastrukturscripts (00–08)

Script	Hva den gjør
00-authcheck.sh	Verifiser gcloud-innlogging og prosjekt
01-setupenv.sh	Aktiver APIs, opprett SA, sett IAM, budsjettvarsel
02-deploy.sh	Deploy med IAP på eget domene
03-teardown.sh	Riv ned Cloud Run (kjør hver kveld)
04-observability-setup.sh	Cloud Monitoring + alerting
05-cloudrun-deploy.sh	Deploy ADK-agent til Cloud Run
06-cicd-setup.sh	GitHub → Cloud Build CI/CD
07-rag-setup.sh	Opprett RAG Engine corpus + last opp frodi
08-memorybank-setup.sh	Opprett Memory Bank (Agent Engine)

Kjente problemstillinger

ID	Problem	Løsning
OQ-01	Memory Bank — ingen gcloud CLI	Python SDK only
OQ-02	RAG Engine regional tilgjengelighet	Fallback til us-east1
OQ-03	CMEK ikke for RAG Engine	VPC-SC only
OQ-04	Cloud Build GitHub OAuth	Manuelt i Console
OQ-05	gcloud alpha monitoring ustabil	Fallback til true
OQ-06	Memory Bank auto-discovery	Eksplisitt env var MEMORY_ENGINE_NAME
OQ-07	Monitoring email flag-format	Teste i dev
OQ-08	VPC connector e2-micro regional	Default us-central1

Kostnadsmodell

Scenario	Kostnad/mnd
Bare deg (dev, teardown daglig)	~$25-75
1 betalende kunde (lett prod)	~$115-280
Medioteq-type (klinisk, compliance)	~$220-350

Breakeven: 1 kunde til $300-500/mnd dekker alle kostnader. ALTID kjør 03-teardown.sh hver kveld for å unngå 24/7-fakturering.

GCP-konfigurasjon

PROJECT_ID=propane-will-491900-m5
REGION=us-central1
CLOUD_RUN_SERVICE=osvauco-agent
AGENT_SA=osvauco-agent-sa@propane-will-491900-m5.iam.gserviceaccount.com
RAG_CORPUS_DISPLAY_NAME=osvauco-corpus
MEMORY_INSTANCE_DISPLAY_NAME=propane-will-491900-m5-memory-bank
ORCHESTRATOR_MODEL=gemini-2.0-flash-001
SUBAGENT_MODEL=gemini-2.0-flash-001

Fase A — Kjørerekkefølge

cd ~/OSVauco
source .env
bash infrastructure/00-authcheck.sh
bash infrastructure/01-setupenv.sh
bash infrastructure/07-rag-setup.sh
bash infrastructure/08-memorybank-setup.sh
# Legg MEMORY_ENGINE_NAME i .env
bash infrastructure/05-cloudrun-deploy.sh
bash infrastructure/04-observability-setup.sh
# Om kvelden:
bash infrastructure/03-teardown.sh

3.6 KiB Raw Blame History Unescape Escape