From a688f139531c75eaf576e67d56eac8a40250b408 Mon Sep 17 00:00:00 2001
From: Huang <huangyiyang89@gmail.com>
Date: Thu, 20 Aug 2026 15:57:52 +0800
Subject: [PATCH] clarify Vertex AI env vars

---
 docs/llm-providers/vertex.mdx | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/docs/llm-providers/vertex.mdx b/docs/llm-providers/vertex.mdx
index d7ed9710..281fed72 100644
--- a/docs/llm-providers/vertex.mdx
+++ b/docs/llm-providers/vertex.mdx
@@ -47,6 +47,13 @@ export VERTEXAI_PROJECT="your-project-id"
 export VERTEXAI_LOCATION="global"
 ```
 
+Strix passes Vertex AI requests through LiteLLM, which reads the project and location
+from `VERTEXAI_PROJECT` and `VERTEXAI_LOCATION`. Do not add an underscore after
+`VERTEX`: `VERTEX_AI_PROJECT` and `VERTEX_AI_LOCATION` are not recognized.
+
+If Strix reports `Could not resolve project_id`, check these variable names before
+retrying the scan.
+
 ## Prerequisites
 
 1. Enable the Vertex AI API in your Google Cloud project