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.
This commit is contained in:
GitHub
parent
025f94a976
commit
ccf1a8f4fe
108
docs/corpus-seed/osvauco-knowledge-base.md
Normal file
108
docs/corpus-seed/osvauco-knowledge-base.md
Normal file
|
|
@ -0,0 +1,108 @@
|
||||||
|
# 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
|
||||||
|
|
||||||
|
```bash
|
||||||
|
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
|
||||||
|
```
|
||||||
Loading…
Reference in New Issue
Block a user