# GCP Solution Architecture Agent Environment Variables # Agent Identity AGENT_NAME=gcp_solution_architecture_agent AGENT_VERSION=1.0.0 LOG_LEVEL=INFO # A2A server (python -m app.main). The container image sets A2A_PORT=8080. A2A_HOST=0.0.0.0 A2A_PORT=8000 # A2A_PUBLIC_URL=https://agents.example.com/solution-architect # Models (providers/.yaml): gemini/ uses ADK's native Gemini client. # These are read by Google's client, not by this app's settings. The app exports them # from this file at start-up; a value already set in the environment wins. # Vertex AI with Application Default Credentials: # GOOGLE_GENAI_USE_ENTERPRISE=true # GOOGLE_CLOUD_PROJECT=your-project-id # GOOGLE_CLOUD_LOCATION=global # GOOGLE_APPLICATION_CREDENTIALS=/app/credentials/adc.json # Or the Gemini API: GOOGLE_API_KEY=... MODEL_TIMEOUT_SECONDS=180 # Cloud Provider Bundle (providers/.yaml) & Remote MCP Servers CLOUD_PROVIDER=gcp MCP_ENABLED=true MCP_ENABLE_PREVIEW=true # MCP_QUOTA_PROJECT=your-project-id # defaults to the Application Default Credentials project MCP_TIMEOUT_SECONDS=30 # Local Terraform tools (fmt, validate, plan; never apply) TERRAFORM_BINARY=terraform TERRAFORM_TIMEOUT_SECONDS=300 # Terraform providers are cached here so each check does not download them again. # Relative to the repository root; set it empty to disable. TF_PLUGIN_CACHE_DIR=.cache/terraform-plugins # Use published Terraform modules when a caller does not say. Off writes plain # resources; a caller opts in per Execution with terraform_modules. TERRAFORM_MODULES=false # Hierarchical Execution Engine ORCHESTRATOR=router # router | model ORCHESTRATOR_BUDGET=40 SPECIALIST_BUDGET=15 # With a user present, a Deliverable is shown to them before it is first submitted. CONFIRM_DRAFTS=true # Give Specialists the lessons Skill. Set false to run without anything learned. LESSONS_ENABLED=true # Give a role the lighter model its provider bundle names for a first attempt. MODEL_TIERS=false # Overlay Skills: an organisation's standards or one engagement's constraints. The # folders they live in, and the ones every Execution loads (comma-separated names). OVERLAY_SKILLS_DIRS=skills/overlays DEFAULT_OVERLAY_SKILLS= MAX_REVISIONS=3 MAX_ORCHESTRATOR_TURNS=100 MAX_PARALLEL_SPECIALISTS=4 CHECKPOINTER=sqlite CHECKPOINT_DB_PATH=checkpoints.db # A model reads the requirements against the Checks when the Target architecture is # first submitted, and returns what no Check verifies. One model run per Execution. DESIGN_COVERAGE_REVIEW=false # Jev decision service, through the TypeSafe AI Python SDK (typesafe-sdk). # Leave the key unset to run without it: every decision then takes its fallback. # TYPESAFE_API_KEY= # TYPESAFE_BASE_URL= # defaults to the SDK's endpoint # TYPESAFE_DEFAULT_MODEL= # defaults to the SDK's model JEV_TIMEOUT_SECONDS=5 JEV_REQUESTS_PER_SECOND=5 JEV_MAX_IN_FLIGHT=8 JEV_BUDGET_CALLS=500 JEV_BUDGET_TOKENS=1000000 JEV_ACT_THRESHOLD=0.75 JEV_CLOSE_THRESHOLD=0.15 JEV_CONFIDENCE_THRESHOLD=0.6 # Review a design's coverage with Jev before it is submitted: for each condition a # requirement lists, which Check verifies it. Off until a full case has run with it. JEV_COVERAGE_REVIEW=false # How likely "no Check verifies this" must be before the condition is raised. JEV_COVERAGE_THRESHOLD=0.6 # Review the requirements with Jev before they are submitted: does any name a cloud # product? Off until a full case has run with it. JEV_REQUIREMENTS_REVIEW=false JEV_REQUIREMENTS_THRESHOLD=0.3 # How directly a change must affect a pillar for its advisor to be consulted again: # 0 not at all, 1 only indirectly, 2 directly. JEV_PILLAR_THRESHOLD=1.5 # In a Change request, an item this unlikely to have really changed is listed as reworded. JEV_REWORDED_THRESHOLD=0.25 # Name, in a Specialist's context, the references of its Skills its task needs: # 0 not needed, 1 might help, 2 needed. JEV_SKILL_ROUTING=true JEV_SKILL_THRESHOLD=1.25 # Judge each Execution's design recommendations when it ends; kept in execution.json. JEV_ASSESS_EXECUTIONS=true # Withhold an MCP server's reply that reads as instructions to the agent, and flag a # request or reply from the user that does. JEV_GUARDRAIL=true JEV_GUARDRAIL_THRESHOLD=0.75 # PostgreSQL (Execution records, and checkpoints when CHECKPOINTER=postgres) POSTGRES_HOST=localhost POSTGRES_PORT=5432 POSTGRES_DB=gcp_agent_db POSTGRES_USER=postgres POSTGRES_PASSWORD=postgres # DATABASE_URL=postgresql://postgres:postgres@localhost:5432/gcp_agent_db SQLITE_FALLBACK_DB=gcp_agent_local.db