File size: 3,763 Bytes
3d142aa | 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 | # ==============================================================================
# Installation & Setup
# ==============================================================================
# Install dependencies using uv package manager
install:
@command -v uv >/dev/null 2>&1 || { echo "uv is not installed. Installing uv..."; curl -LsSf https://astral.sh/uv/0.8.13/install.sh | sh; source $HOME/.local/bin/env; }
uv sync
# ==============================================================================
# Playground Targets
# ==============================================================================
# Launch local dev playground
playground:
@echo "==============================================================================="
@echo "| 🚀 Starting your agent playground... |"
@echo "| |"
@echo "| 💡 Try asking: What's the weather in San Francisco? |"
@echo "| |"
@echo "| 🔍 IMPORTANT: Select the 'rag_agent' folder to interact with your agent. |"
@echo "==============================================================================="
uv run adk web . --port 8501 --reload_agents
# ==============================================================================
# Backend Deployment Targets
# ==============================================================================
# Deploy the agent remotely
deploy:
# Export dependencies to requirements file using uv export.
(uv export --no-hashes --no-header --no-dev --no-emit-project --no-annotate > rag_agent/app_utils/.requirements.txt 2>/dev/null || \
uv export --no-hashes --no-header --no-dev --no-emit-project > rag_agent/app_utils/.requirements.txt) && \
uv run -m rag_agent.app_utils.deploy \
--source-packages=./rag_agent \
--display-name="bitcast_agent_focus" \
--entrypoint-module=rag_agent.agent_engine_app \
--entrypoint-object=agent_engine \
--requirements-file=rag_agent/app_utils/.requirements.txt
# Alias for 'make deploy' for backward compatibility
backend: deploy
# ==============================================================================
# Infrastructure Setup
# ==============================================================================
# Set up development environment resources using Terraform
setup-dev-env:
PROJECT_ID=$$(gcloud config get-value project) && \
(cd deployment/terraform/dev && terraform init && terraform apply --var-file vars/env.tfvars --var dev_project_id=$$PROJECT_ID --auto-approve)
# ==============================================================================
# Testing & Code Quality
# ==============================================================================
# Run unit and integration tests
test:
uv sync --dev
uv run pytest tests/unit && uv run pytest tests/integration
# Run code quality checks (codespell, ruff, mypy)
lint:
uv sync --dev --extra lint
uv run codespell
uv run ruff check . --diff
uv run ruff format . --check --diff
uv run mypy .
# ==============================================================================
# Gemini Enterprise Integration
# ==============================================================================
# Register the deployed agent to Gemini Enterprise
# Usage: make register-gemini-enterprise (interactive - will prompt for required details)
# For non-interactive use, set env vars: ID or GEMINI_ENTERPRISE_APP_ID (full GE resource name)
# Optional env vars: GEMINI_DISPLAY_NAME, GEMINI_DESCRIPTION, GEMINI_TOOL_DESCRIPTION, AGENT_ENGINE_ID
register-gemini-enterprise:
@uvx agent-starter-pack@0.21.0 register-gemini-enterprise |