Iteration 4: - Overlay Skills (step 12): an Execution names an organisation's standards Skill from the folders the deployment configures; recorded with its version. An example standards Skill and an evaluation case that uses it. - Lessons (step 10): a prove command that compares a run with lessons against one without, and triage of evidence an existing lesson already covers. Iteration 5: - Step 8: the references of a Specialist's Skills its task needs are named in its context as read_first. - Step 14: a remote MCP server's reply that instructs the agent is withheld; the user's own text is flagged as a risk and nothing more. - Step 15: in a Change request, items only reworded are listed apart from real changes. - Step 19: each Execution's design recommendations are judged when it ends and the scores kept in its record. The evaluation takes its rubric from the same place. Each question was calibrated against live Jev; none has run in a case. Steps 6, 7, 9, 13 and 18 stay planned, with the reasons in the plan map. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
102 lines
4.0 KiB
Plaintext
102 lines
4.0 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
|
|
|
|
# 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
|
|
# 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
|
|
|
|
# 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
|