Skip to content

docs(firestore-multimodal-genai): clarify Vertex AI location vs Cloud Functions location#1105

Open
cabljac wants to merge 1 commit into
mainfrom
docs/issue-522-publisher-model
Open

docs(firestore-multimodal-genai): clarify Vertex AI location vs Cloud Functions location#1105
cabljac wants to merge 1 commit into
mainfrom
docs/issue-522-publisher-model

Conversation

@cabljac

@cabljac cabljac commented Jul 2, 2026

Copy link
Copy Markdown
Collaborator

Summary

Documentation fix for #522 ("Publisher Model not found" on the Multimodal Tasks with the Gemini API extension).

Users who select the Vertex AI provider and pick a Cloud Functions location that is not a supported Vertex AI region (for example us-west2) hit a Publisher Model ... not found error at generation time. The extension already ships a VERTEX_AI_PROVIDER_LOCATION ("Vertex AI API Location") parameter that lets you target a supported region independently of the functions location, but the docs did not make the distinction clear or connect it to this error.

Changes

  • extension.yaml: expanded the LOCATION and VERTEX_AI_PROVIDER_LOCATION parameter descriptions to explain that the Cloud Functions location and the Vertex AI region are distinct, that an unsupported region causes the "Publisher Model not found" error, and that "Vertex AI API Location" should be set to a supported region.
  • PREINSTALL.md and README.md: same guidance mirrored so it appears on extensions.dev.
  • Refreshed the outdated Vertex AI locations links to https://cloud.google.com/vertex-ai/generative-ai/docs/learn/locations.
  • Bumped version to 1.0.8 and added a CHANGELOG entry.

Scope

Docs only. No code or dropdown-option behavior changes. The original report also asked about removing us-west2 from the Cloud Functions location dropdown; that is a valid Cloud Functions deployment region (the problem is specific to Vertex AI availability), so this PR leaves the option in place and instead documents how to point Vertex AI at a supported region.

Refs #522

… Functions location

Users hitting a "Publisher Model ... not found" error when using the
Vertex AI provider were selecting a Cloud Functions location (such as
us-west2) that is not a supported Vertex AI region. The docs did not make
clear that the Cloud Functions location and the Vertex AI region are
distinct, or that the "Vertex AI API Location" parameter can be used to
target a supported region.

- Explain the distinction and the "Publisher Model not found" cause in the
  LOCATION and VERTEX_AI_PROVIDER_LOCATION parameter descriptions.
- Update PREINSTALL.md and README.md with the same guidance.
- Refresh the outdated Vertex AI locations links.
- Bump version to 1.0.8.

Refs #522
@cabljac cabljac force-pushed the docs/issue-522-publisher-model branch from b97b7c1 to 75c48fd Compare July 2, 2026 10:15
@cabljac cabljac marked this pull request as ready for review July 2, 2026 10:18
@cabljac cabljac requested a review from CorieW July 2, 2026 13:14

@CorieW CorieW left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

lgtm

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants