The reference agent's subject, cloud solution architecture, as an agent in the operating model agent's pattern: the Execution engine (from orchestration_engine) and one Workflow in app/solution_architecture, built for the settings and provider bundle by assembly.workflow_for. Copied from gcp_solution_architecture_agent at 8b397cd without its own engine: its role files, Skills, provider bundle, ADRs, vocabulary, scripts and evaluation datasets. The image takes the engine from a named build context and installs Terraform. It is called through the Orchestration engine, and its files are what the operating model agent digests. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
112 lines
4.5 KiB
Plaintext
112 lines
4.5 KiB
Plaintext
# 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/<name>.yaml): gemini/<model> 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/<name>.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
|