8000 GitHub - rominirani/gcp-gemini-decisions-hybrid-gateway: 5-Part Series & Cloud Run Reference Architecture: Sub-200ms Multimodal AI Control Planes on Google Cloud with the Gemini Decisions API (gemini-decision-1) & Gemini Enterprise Agent Platform · GitHub
[go: up one dir, main page]

Skip to content

About

5-Part Series & Cloud Run Reference Architecture: Sub-200ms Multimodal AI Control Planes on Google Cloud with the Gemini Decisions API (gemini-decision-1) & Gemini Enterprise Agent Platform

Resources

Stars

2 stars

Watchers

0 watching

Forks

Repository files navigation

Gemini Decisions API — Python & Google Cloud Run Examples

Google Cloud Run Gemini Decisions API Gemini Enterprise Agent Platform License: MIT

Runnable Python scripts and Google Cloud Run services demonstrating Google DeepMind's Gemini Decisions API (gemini-decision-1)—evaluating yes/no (noul), multiple-choice (choice), rubric (score), and multimodal (photo & PDF) decisions in a single pass with zero output tokens, alongside automatic escalation to Gemini 3.8 Flash and BigQuery telemetry.

  • For complete step-by-step setup and deployment commands, see TUTORIAL.md.

⚡ Quickstart: Run Locally in 60 Seconds

Requires Python 3.11+ and a Gemini API Key from Google AI Studio:

git clone https://github.com/rominirani/gcp-gemini-decisions-hybrid-gateway.git
cd gcp-gemini-decisions-hybrid-gateway

python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

export GEMINI_API_KEY="YOUR_GEMINI_API_KEY"

# 1. Ticket routing + calibrated caution on unverified refunds (0 output tokens)
python scripts/quickstart_decisions.py

# 2. 8 policy, PII & prompt-injection checks in one API call
python scripts/parallel_guardrails.py

# 3. Photo (resolution="low" vs "high") & PDF invoice check without OCR
python scripts/multimodal_triage.py

📐 Cloud Run Router Architecture (02-hybrid-gateway/)

flowchart TD
    Ingress["HTTP Client / Browser Test Page"] --> S1["Step 1: Gemini Decisions API (gemini-decision-1)<br/>• Secret Manager: GEMINI_API_KEY<br/>• Single Pass (noul, choice, score) • 0 Output Tokens<br/>• $0.10 / MTok Input • ~172 ms Warm"]
    S1 --> Gate{"Confidence >= 0.85<br/>& P(Auto-Resolve) >= 0.80?"}
    Gate -- "YES (Fast Path: ~75% of Traffic)" --> Fast["Run Backend Action Immediately<br/>Measured: 155–195 ms | ~$0.000052"]
    Gate -- "NO (Escalate Hard Cases)" --> S2["Step 2: Escalate to gemini-3.8-flash<br/>• Gemini Enterprise Agent Platform (Cloud Run IAM)<br/>• Writes Troubleshooting Plan & Reply (~6.1s)"]
    Fast --> BQ["BigQuery Event Log<br/>(Cost & Accuracy SQL Checks)"]
    S2 --> BQ
Loading

📂 Repository Structure

.
├── scripts/
│   ├── quickstart_decisions.py  # Routing + calibrated caution on unverified refunds
│   ├── parallel_guardrails.py   # 8 policy, PII & injection checks in 1 API call
│   ├── multimodal_triage.py     # Photo resoluti
574B
on (4x savings) + PDF check without OCR
│   └── setup_gcp.sh             # Enables GCP APIs, Secret Manager, IAM SA & BigQuery table
├── 01-decisions-classifier/     # Minimal standalone Cloud Run classifier (164–185 ms)
├── 02-hybrid-gateway/           # Cloud Run request router + browser test UI + Gemini 3.8 Flash escalation
├── 03-multimodal-triage/        # Cloud Run multipart image/PDF upload API + SSRF & magic-byte checks
├── 04-pubsub-policy-stream/     # Cloud Pub/Sub push worker running 8 policy checks per message
├── 05-bigquery-finops/          # Partitioned BigQuery schema, seeder & cost/accuracy SQL queries
├── 06-adk-workflows/            # Google ADK 2.0 Workflows + Decisions API & live latency benchmark
├── .env.example                 # Sanitized environment template (zero fallbacks)
├── requirements.txt             # Python dependencies (google-genai >= 3.2.0)
└── TUTORIAL.md                  # Step-by-step terminal runbook

About

5-Part Series & Cloud Run Reference Architecture: Sub-200ms Multimodal AI Control Planes on Google Cloud with the Gemini Decisions API (gemini-decision-1) & Gemini Enterprise Agent Platform

Resources

Stars

2 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages

0