Chris Christiansen
9fcb9c354a
Some checks are pending
Check Python Version Consistency / Check Python Version (push) Waiting to run
109 lines
3.6 KiB
Markdown
109 lines
3.6 KiB
Markdown
# 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: vauco-saas/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
|
||
```
|