> ## Documentation Index
> Fetch the complete documentation index at: https://docs.onyx.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Google Vertex AI

> Configure Google Vertex AI language models for use with Onyx

## Guide

This guide walks through setting up Google Vertex AI language models for use with Onyx.

<Note>
  Google Vertex AI and Google AI Studio serve the same models. However,
  Vertex AI has enterprise-grade features that may be useful for your organization.
</Note>

<Steps>
  <Step title="Create a Service Account for Onyx">
    Go to the [Google Cloud Console Service Accounts Page](https://console.cloud.google.com/iam-admin/serviceaccounts)

    Select your project and click **Create Service Account**.

    Give your Service Account a name and a description.

    On the **Permissions** tab, grant the service account the **Vertex AI Administrator** role.

    <img className="rounded-image" src="https://mintcdn.com/danswer/sZSCgOqeRdUK59k_/assets/admins/ai_models/gcs_service_acc.png?fit=max&auto=format&n=sZSCgOqeRdUK59k_&q=85&s=0afcb51f4ed93758636638dfb5fe9b20" alt="Google Cloud Console Service Accounts Page" width="2342" height="822" data-path="assets/admins/ai_models/gcs_service_acc.png" />

    <img className="rounded-image" src="https://mintcdn.com/danswer/sZSCgOqeRdUK59k_/assets/admins/ai_models/gcs_service_acc_config.png?fit=max&auto=format&n=sZSCgOqeRdUK59k_&q=85&s=51dda13fb551168784a4205f5f339033" alt="Google Cloud Console Service Account Configuration" width="1714" height="1328" data-path="assets/admins/ai_models/gcs_service_acc_config.png" />
  </Step>

  <Step title="Create a New Key for the Service Account">
    Click your newly created Service Account → **Keys** → **Add Key** → **Create new key**.

    Select **JSON** as the key type and click **Create**. The key will be automatically downloaded to your computer.
  </Step>

  <Step title="Navigate to Language Models">
    Access the Admin Panel from your user profile icon, then navigate to **Configuration → Language Models**.
  </Step>

  <Step title="Configure Google Vertex AI">
    Select **Google Cloud Vertex AI** from the available providers.

    Give this configuration a **Display Name**.

    Upload your JSON key to the **Credentials File** field.

    If relevant, specify a **Location**.
  </Step>

  <Step title="Choose Visible Models">
    In the **Advanced Options**, you will see a list of all models available from this provider.
    You may choose which models are visible to your users in Onyx.

    Setting visible models is useful when a provider publishes multiple models and versions of the same model.
  </Step>

  <Step title="Designate Provider Access">
    Lastly, decide whether the provider should be public to all users in Onyx.

    If set to private,
    the provider's models will be available to Admins and User Groups you explicitly assign the provider to.
  </Step>
</Steps>
