docs: incorporate Dialogflow CX FAQ-agent plan into MASTERPLAN phases

This commit is contained in:
chrischristiansen-glitch 2026-05-24 13:50:20 +02:00
parent 5e33bb64b3
commit 8ca45af1e9

View File

@ -112,6 +112,58 @@ bash infrastructure/03-teardown.sh
--- ---
## FASE A2 — Dialogflow CX FAQ-agent (parallelt med A4A9)
**Mål: Generativ FAQ-agent live på OSVauco | Tid: Ca. 35 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 |
|---|---|---|
| DX1DX3 (bygging + testing) | ~500 | ~$6 |
| DX4DX5 (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 ## FASE B — Sikring og CI/CD
**Mål: Begrenset tilgang og aktiv CI/CD | Tid: 1 time** **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 Se: infrastructure/notifications/webhook-setup.md
[ ] B5 — bash infrastructure/10-cost-guard.sh [ ] B5 — bash infrastructure/10-cost-guard.sh
Aktiverer auto-teardown Cloud Function + chat-varsling ved budsjett-overskridelse 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 Terraform-variabler: customer_id, customer_project_id, customer_region
State-backend: GCS bucket (TF_STATE_BUCKET i .env) State-backend: GCS bucket (TF_STATE_BUCKET i .env)
[ ] C2 — Pakk `vauco-os` som kundeflate [ ] C2 — Pakk `vauco-os` som kundeflate
Inkluder Dialogflow Messenger widget (fra DX5) i kundefront
[ ] C3 — Opprett billing@vauco.no som Google Group [ ] C3 — Opprett billing@vauco.no som Google Group
Legg inn: chris.christiansen@vauco.no + jason.vauger@vauco.no Legg inn: chris.christiansen@vauco.no + jason.vauger@vauco.no
Oppdater .env: BILLING_VIEWER_EMAILS="billing@vauco.no" Oppdater .env: BILLING_VIEWER_EMAILS="billing@vauco.no"
@ -152,6 +209,7 @@ bash infrastructure/03-teardown.sh
[ ] C4 — Første kunde: Medioteq [ ] C4 — Første kunde: Medioteq
Region: europe-north1, separat GCP-prosjekt Region: europe-north1, separat GCP-prosjekt
Kjør: terraform apply -var="customer_id=medioteq" Kjør: terraform apply -var="customer_id=medioteq"
Inkluder dedikert Dialogflow CX-agent per kunde (replikat av DX1DX5)
``` ```
--- ---
@ -186,6 +244,7 @@ bash infrastructure/03-teardown.sh
| CI/CD `--no-traffic` | Manuell trafikkbytte — HITL | | CI/CD `--no-traffic` | Manuell trafikkbytte — HITL |
| Idempotente scripts | Trygt å kjøre flere ganger | | Idempotente scripts | Trygt å kjøre flere ganger |
| `03-teardown.sh` hver kveld | Agent Runtimes koster 24/7 | | `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 | | Scenario | Kostnad/mnd |
|---|---| |---|---|
| Bare deg (dev, teardown daglig) | ~$25-75 | | 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 | | 1 betalende kunde (lett prod) | ~$115-280 |
| Medioteq-type (klinisk, compliance) | ~$220-350 | | Medioteq-type (klinisk, compliance) | ~$220-350 |
Breakeven: 1 kunde til $300-500/mnd dekker alle kostnader. 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-08 | VPC connector e2-micro regional | Default us-central1 |
| OQ-09 | GCP billing: 0 viewers | **LØST**`11-billing-iam-hardening.sh` | | 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-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 | | Fase C: Medioteq | `vauco-bootstrap` → Terraform-modul |
| Per kunde | `terraform apply -var="customer_id=X"` oppretter isolert GCP-miljø | | 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 | | 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 | | 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_cloudbuild_trigger` — push-til-main trigger
- `google_billing_budget` — budsjett-alert per kunde - `google_billing_budget` — budsjett-alert per kunde
- `google_cloud_run_v2_service` — Cloud Run-tjeneste - `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 | | 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 | | 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 | | 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: 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 | | 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* *OSVauco-NMTMD-GCOS | propane-will-491900-m5 | us-central1*
*GitHub: chrischristiansen-glitch/OSVauco* *GitHub: chrischristiansen-glitch/OSVauco*
*GitHub: chrischristiansen-glitch/OSVauco*