docs: incorporate Dialogflow CX FAQ-agent plan into MASTERPLAN phases
This commit is contained in:
parent
5e33bb64b3
commit
8ca45af1e9
|
|
@ -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*
|
||||
|
|
|
|||
Loading…
Reference in New Issue
Block a user