Adjust the instructions on Vertex configuration (#290)

Co-authored-by: Nikola Forró <[email protected]>

Author: lbarcziova

templates/beeai-agent.env

@@ -1,22 +1,44 @@
-# for example gemini:gemini-2.5-pro or anthropic:claude-sonnet-4-20250514 or vertexai:...
+# =============================================================================
+# MODEL CONFIGURATION
+# =============================================================================
+# Choose ONE of the following model configurations:
+
+# --- OPTION 1: Direct API Access (gemini: or anthropic: prefix) ---
+# Use these for direct API access with API keys
+# CHAT_MODEL=gemini:gemini-2.5-pro
+# CHAT_MODEL=anthropic:claude-sonnet-4-20250514
+
+# --- OPTION 2: Vertex AI Access (vertexai: prefix) ---
+# Use these for Google Cloud Vertex AI with service account credentials
 # CHAT_MODEL=vertexai:gemini-2.5-pro
-# CHAT_MODEL=vertexai:claude-sonnet-4@20250514
+# CHAT_MODEL=vertexai:claude-sonnet-4-5
+
 CHAT_MODEL=
 
-# API key or other credentials corresponding to the model above
+# =============================================================================
+# CREDENTIALS - Use based on model prefix above
+# =============================================================================
+
+# --- FOR gemini: prefix ONLY ---
 # Request or use existing GCP project
 # How to: https://source.redhat.com/departments/it/datacenter_infrastructure/itcloudservices/itpubliccloudpage/cloud/gcp/gcpgeminiapi#tab--gemini-models
 # Google Cloud Console → API & Services → Credentials → API Keys → Show Key
 GEMINI_API_KEY=
 
+# --- FOR anthropic: prefix ONLY ---
+#ANTHROPIC_API_KEY=
+
+# --- FOR vertexai: prefix ONLY ---
+# Setup instructions:
+# 1. Get jotnar-vertex-dev.json from Bitwarden (requires access to jotnar group)
+# 2. Place the file in .secrets/jotnar-vertex-dev.json in this repository
+# 3. Uncomment the variables below
 # GOOGLE_VERTEX_PROJECT=jotnar-bot
 # # Location is important! Anthropic's models are not available in all locations
 # # Right now we have Sonnet 4.5 set up in global, 4.0 is not tied to a location
 # GOOGLE_VERTEX_LOCATION=global
 # GOOGLE_APPLICATION_CREDENTIALS=/home/beeai/jotnar-vertex-dev.json
 
-#ANTHROPIC_API_KEY=
-
 # BeeAI Framework Configuration
 BEEAI_MAX_ITERATIONS=255
 BEEAI_MAX_RETRIES_PER_STEP=5