diff --git a/MASTERPLAN.md b/MASTERPLAN.md index 7c929e7..20fb266 100644 --- a/MASTERPLAN.md +++ b/MASTERPLAN.md @@ -112,6 +112,58 @@ bash infrastructure/03-teardown.sh --- +## FASE A2 — Dialogflow CX FAQ-agent (parallelt med A4–A9) + +**Mål: Generativ FAQ-agent live på OSVauco | Tid: Ca. 3–5 timer** +**Kreditt: kr 5 822 (dialogflow_cx_credit_v2-0171F6-057E6B-A260BA) + $1 000 Playbooks-trial** +**Detaljer: se `docs/dialogflow-cx-budget-plan.md`** + +``` +[ ] DX1 — Opprett Playbook-agent i Conversational Agents Console + URL: https://console.cloud.google.com/conversational-agents + Prosjekt: propane-will-491900-m5 | Region: us-central1 + Type: Generative (Playbooks) — IKKE Flows + Språk: Norsk (nb) + Engelsk (en) + Kreditten aktiveres automatisk — ingen manuell kobling nødvendig + +[ ] DX2 — Last opp FAQ-innhold som Data Store + Console: Agent → Data Stores → Create + Kilde: Last opp markdown/PDF FAQ-filer fra docs/ + Alternativ: Link til nettsted (crawl) for automatisk oppdatering + ACTION: Kopier DATA_STORE_ID til .env + +[ ] DX3 — Konfigurer Playbook med norsk systempromptin + Instruksjon: "Du er OPAX-assistent for OSVauco. Svar alltid på norsk. + Bruk kun informasjon fra Data Store. Henvis til support ved usikkerhet." + Test: 10 typiske FAQ-spørsmål manuelt i Console + +[ ] DX4 — Koble webhook mot OSVauco Cloud Run (etter A6) + Requires: A6 (cloudrun-deploy) fullført + Metode: Dialogflow CX → Fulfillment → Webhook → Cloud Run URL + Auth: Bearer token fra Service Account (jason.vauger@vauco.no) + Bruksområde: Live data (f.eks. prosjektstatus, kostnader) via OPAX-agenten + +[ ] DX5 — Publiser via Dialogflow Messenger (web-widget) + Integrasjon: Agent → Integrations → Dialogflow Messenger + Legg til script-tag i vauco-os frontend + Test på mobil og desktop + +[ ] DX6 — Sett budsjett-alert for Dialogflow CX + Grense: $400 av $550 tilgjengelig kreditt + Console: Billing → Budgets & Alerts → Create budget + Koble til Pub/Sub topic fra A3 (10-cost-guard.sh håndterer auto-teardown) +``` + +**Kostnadsestimat Fase A2:** +| Aktivitet | Requests | Estimert kostnad | +|---|---|---| +| DX1–DX3 (bygging + testing) | ~500 | ~$6 | +| DX4–DX5 (integrasjon) | ~1 000 | ~$12 | +| 30 dager pilot (10k req/mnd) | 10 000 | ~$120 | +| **Buffer igjen av kr 5 822** | — | **~$412 (~kr 4 300)** | + +--- + ## FASE B — Sikring og CI/CD **Mål: Begrenset tilgang og aktiv CI/CD | Tid: 1 time** @@ -130,6 +182,10 @@ bash infrastructure/03-teardown.sh Se: infrastructure/notifications/webhook-setup.md [ ] B5 — bash infrastructure/10-cost-guard.sh Aktiverer auto-teardown Cloud Function + chat-varsling ved budsjett-overskridelse +[ ] B6 — Eksporter Dialogflow CX agent til versjonskontroll + gcloud beta dialogflow agents export --location=us-central1 \ + --destination=gs://propane-will-491900-m5-dialogflow-backup/agent.zip + Legg backup-rutine i CI/CD pipeline (etter B3) ``` --- @@ -145,6 +201,7 @@ bash infrastructure/03-teardown.sh Terraform-variabler: customer_id, customer_project_id, customer_region State-backend: GCS bucket (TF_STATE_BUCKET i .env) [ ] C2 — Pakk `vauco-os` som kundeflate + Inkluder Dialogflow Messenger widget (fra DX5) i kundefront [ ] C3 — Opprett billing@vauco.no som Google Group Legg inn: chris.christiansen@vauco.no + jason.vauger@vauco.no Oppdater .env: BILLING_VIEWER_EMAILS="billing@vauco.no" @@ -152,6 +209,7 @@ bash infrastructure/03-teardown.sh [ ] C4 — Første kunde: Medioteq Region: europe-north1, separat GCP-prosjekt Kjør: terraform apply -var="customer_id=medioteq" + Inkluder dedikert Dialogflow CX-agent per kunde (replikat av DX1–DX5) ``` --- @@ -186,6 +244,7 @@ bash infrastructure/03-teardown.sh | CI/CD `--no-traffic` | Manuell trafikkbytte — HITL | | Idempotente scripts | Trygt å kjøre flere ganger | | `03-teardown.sh` hver kveld | Agent Runtimes koster 24/7 | +| Conversational Agents (Dialogflow CX) | Playbooks GA — Data Store + webhook | --- @@ -194,10 +253,12 @@ bash infrastructure/03-teardown.sh | Scenario | Kostnad/mnd | |---|---| | Bare deg (dev, teardown daglig) | ~$25-75 | +| Dev + Dialogflow CX FAQ (10k req) | ~$145-195 (Playbooks ~$120 inkl.) | | 1 betalende kunde (lett prod) | ~$115-280 | | Medioteq-type (klinisk, compliance) | ~$220-350 | Breakeven: 1 kunde til $300-500/mnd dekker alle kostnader. +**Dialogflow CX-kreditten (kr 5 822) dekker ~4 måneder pilot uten reell kostnad.** --- @@ -215,6 +276,7 @@ Breakeven: 1 kunde til $300-500/mnd dekker alle kostnader. | OQ-08 | VPC connector e2-micro regional | Default us-central1 | | OQ-09 | GCP billing: 0 viewers | **LØST** — `11-billing-iam-hardening.sh` | | OQ-10 | GCP billing: Creator på domenet | **LØST** — fjernes når ORG_DOMAIN er satt | +| OQ-11 | Dialogflow CX Data Store norsk indeksering | Teste med nb-NO locale i DX2 | --- @@ -227,7 +289,7 @@ Terraform blir relevant ved kunde-onboarding: |---|---| | Fase C: Medioteq | `vauco-bootstrap` → Terraform-modul | | Per kunde | `terraform apply -var="customer_id=X"` oppretter isolert GCP-miljø | -| Ressurser per modul | Cloud Run, Cloud Build 2nd gen connection, IAP, budsjett, SA | +| Ressurser per modul | Cloud Run, Cloud Build 2nd gen connection, IAP, budsjett, SA, **Dialogflow CX agent** | | State-backend | GCS bucket (`TF_STATE_BUCKET`) — én bucket, én state-fil per kunde | | Fase D | Terraform Cloud for sentralisert state og CI/CD på tvers av kunder | @@ -237,6 +299,7 @@ Terraform-ressurser: - `google_cloudbuild_trigger` — push-til-main trigger - `google_billing_budget` — budsjett-alert per kunde - `google_cloud_run_v2_service` — Cloud Run-tjeneste +- `google_dialogflow_cx_agent` — FAQ-agent per kunde (Fase C) --- @@ -263,6 +326,7 @@ Terraform-ressurser: | Memory Bank oppslag | `gemini-2.0-flash` | — | Aldri — faktahenting | | TUI-cockpit (operator) | `gemini-2.0-flash` | `gemini-3.5-flash` | Bruker ber om dyp analyse | | vauco-os (kundeflate) | `gemini-2.0-flash` | `gemini-2.5-pro` | Compliance/kliniske sporsmal | +| **Dialogflow CX Playbooks** | **Gemini (managed)** | — | **Native i plattformen** | | Fase C: Terraform-gen | `gemini-3.5-flash` | — | Standard for denne modulen | | Fase C: Kunde-onboarding | `gemini-2.5-pro` | `gemini-3.5-flash` | Multi-step orkestrering | @@ -290,4 +354,3 @@ REASONING_MODEL=gemini-3.5-flash *OSVauco-NMTMD-GCOS | propane-will-491900-m5 | us-central1* *GitHub: chrischristiansen-glitch/OSVauco* -*GitHub: chrischristiansen-glitch/OSVauco*