📚 GCP Billing Agent Documentation

📚 GCP Billing Agent Documentation

Welcome to the comprehensive documentation for the GCP Billing Agent Application - a Gen AI solution for analyzing GCP billing data using Google’s Agent Development Kit (ADK) and Vertex AI Agent Engine.

🌐 Quick Access

• 📖 Documentation Index - Complete documentation directory with all guides and references
• 🏗️ Architecture Guide - Technical architecture and design decisions with Mermaid diagrams
• 🚀 Deployment Guide - Step-by-step deployment instructions
• 🔒 Authentication Setup - Firestore authentication configuration
• 📊 Agent Documentation - Complete agent implementation details
• 📈 Metrics Dashboard - Code metrics, AI effectiveness and repository analytics
• 🔧 Troubleshooting - Common issues and solutions

🎯 Key Features

Agent Engine Integration

• Auto-Discovery: Automatically discovers deployed reasoning engines from Vertex AI Agent Engine
• Multi-Agent Support: Support for multiple BigQuery agents with easy switching
• Fallback Mechanism: Environment variable fallback if auto-discovery fails

Web Interface

• Real-time Streaming: Watch responses appear in real-time
• Query History: View and manage your query history
• Firestore Authentication: Secure user authentication with domain restrictions
• Modern UI: Clean, modern chat interface built with React

Agent Capabilities

• BigQuery Analysis: Query and analyze GCP billing data
• Natural Language: Ask questions in natural language
• Cost Analysis: Get insights into GCP costs and usage patterns

🛠️ Technology Stack

• Frontend: React 18, Vite, Tailwind CSS
• Backend: FastAPI, Python 3.11+
• Agents: Google ADK, Google GenAI, Vertex AI Agent Engine
• Infrastructure: Cloud Run, Firestore, Vertex AI
• Authentication: Custom Firestore-based JWT authentication

🚀 Quick Start

# Deploy agents
make deploy-all-agents PROJECT_ID=your-project-id

# Deploy web interface
make deploy-web-simple PROJECT_ID=your-project-id

📚 Documentation Sections

Getting Started

• Start Here - Quick start guide for the web interface
• Getting Started - Detailed setup instructions
• Architecture - Complete system architecture with diagrams

Deployment

• Automated Deployment - One-command Cloud Build + Cloud Run deployment
• Deployment Guide - Cloud Run, Agent Engine, manual steps, and FAQ

Authentication & Security

• Authentication Setup - Firestore authentication configuration
• Security - Security best practices and architecture

Agents

• Agent Overview - Overview of available agents
  • bq_agent_mick - Alternative BigQuery agent implementation
  • bq_agent - Production-ready BigQuery agent
  • bq_agent_mick Deployment - Deployment guide
  • bq_agent_mick Usage - Usage guide
  • Deployment Automation - Agent deployment automation
  • Deployment Management - Managing deployments
  • Session Management - Agent session management

Solution Documentation

• Gen AI Solution - Complete Gen AI solution overview

Testing

• Testing History - Testing history and results
• Test Documentation - Test documentation and guides