From dd1adf9ed651312ee9e10657d71e48308c84a17a Mon Sep 17 00:00:00 2001
From: huangyiyang89 <huangyiyang89@gmail.com>
Date: Thu, 21 May 2026 13:05:39 +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 d7ed9710e..281fed728 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