{"record":{"id":"24e4ba0675730453","repo":"microsoft/semantic-kernel","slug":"failed-to-validate-vertex-ai-settings-e-24e4ba","errorCode":null,"errorMessage":"Failed to validate Vertex AI settings: {e}","messagePattern":"Failed to validate Vertex AI settings: (.+?)","errorType":"exception","errorClass":"ServiceInitializationError","httpStatus":null,"severity":"error","filePath":"python/semantic_kernel/connectors/ai/google/vertex_ai/services/vertex_ai_text_embedding.py","lineNumber":68,"sourceCode":"\n        Args:\n            project_id (str): The Google Cloud project ID.\n            region (str): The Google Cloud region.\n            embedding_model_id (str): The Gemini model ID.\n            service_id (str): The Vertex AI service ID.\n            env_file_path (str): The path to the environment file.\n            env_file_encoding (str): The encoding of the environment file.\n        \"\"\"\n        try:\n            vertex_ai_settings = VertexAISettings(\n                project_id=project_id,\n                region=region,\n                embedding_model_id=embedding_model_id,\n                env_file_path=env_file_path,\n                env_file_encoding=env_file_encoding,\n            )\n        except ValidationError as e:\n            raise ServiceInitializationError(f\"Failed to validate Vertex AI settings: {e}\") from e\n        if not vertex_ai_settings.embedding_model_id:\n            raise ServiceInitializationError(\"The Vertex AI embedding model ID is required.\")\n\n        super().__init__(\n            ai_model_id=vertex_ai_settings.embedding_model_id,\n            service_id=service_id or vertex_ai_settings.embedding_model_id,\n            service_settings=vertex_ai_settings,\n        )\n\n    @override\n    async def generate_embeddings(\n        self,\n        texts: list[str],\n        settings: \"PromptExecutionSettings | None\" = None,\n        **kwargs: Any,\n    ) -> ndarray:\n        raw_embeddings = await self.generate_raw_embeddings(texts, settings, **kwargs)\n        return array(raw_embeddings)","sourceCodeStart":50,"sourceCodeEnd":86,"githubUrl":"https://github.com/microsoft/semantic-kernel/blob/c028a0c7dc4f0814cdcbaba9d998f187a41197bf/python/semantic_kernel/connectors/ai/google/vertex_ai/services/vertex_ai_text_embedding.py#L50-L86","documentation":"Raised by VertexAITextEmbedding.__init__ when VertexAISettings construction raises a ValidationError. The embedding service wraps the pydantic failure (embedding_model_id/project_id/region) into a ServiceInitializationError at construction time.","triggerScenarios":"Instantiating VertexAITextEmbedding with missing/malformed configuration (project_id, region, embedding_model_id, or env file issues).","commonSituations":"No VERTEX_AI_PROJECT/region env var. Bad .env path. Embedding-specific settings not configured.","solutions":["Read the {e} detail to identify the failing field(s).","Supply project_id and region explicitly or via env / .env.","Confirm env_file_path and encoding are correct."],"exampleFix":"# before\nsvc = VertexAITextEmbedding()\n# after\nsvc = VertexAITextEmbedding(project_id='my-project', region='us-central1', embedding_model_id='textembedding-gecko@003')","handlingStrategy":"validation","validationCode":"from semantic_kernel.connectors.ai.google.vertex_ai.vertex_ai_settings import VertexAISettings\ntry:\n    s = VertexAISettings(embedding_model_id=passed)\nexcept Exception as e:\n    print('config invalid:', e)","typeGuard":null,"tryCatchPattern":"try:\n    svc = VertexAITextEmbedding(project_id=..., region=..., embedding_model_id=...)\nexcept ServiceInitializationError as e:\n    raise","preventionTips":["Provide project_id, region, and embedding_model_id (explicitly or via env).","Validate settings construction before instantiating the service.","Confirm env_file_path correctness."],"tags":["vertex-ai","configuration","settings","initialization","embeddings"],"backgroundTag":null,"analyzedSha":"c028a0c7dc4f0814cdcbaba9d998f187a41197bf","analyzedAt":"2026-08-13T13:48:05.040Z","schemaVersion":2},"datasetVersion":"2026-08-13T14:17:21.547Z"}