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

# Integrate Google Cloud Vertex AI with LLM Controls

LLM Controls integrates with the [Google Vertex AI API](https://console.cloud.google.com/marketplace/product/google/aiplatform.googleapis.com) for authenticating the [Vertex AI embeddings model](https://docs.llmcontrols.ai/Components/Embeddings#vertexai-embeddings) and [Vertex AI](https://docs.llmcontrols.ai/Components/Models#vertexai) components.

Learn how to create a service account JSON in Google Cloud to authenticate LLM Controls' Vertex AI components.

## **Create a service account with Vertex AI access**

1. Select and enable your Google Cloud project. For more information, see [Create a Google Cloud project](https://developers.google.com/workspace/guides/create-project).
2. Create a service account in your Google Cloud project. For more information, see [Create a service account](https://developers.google.com/workspace/guides/create-credentials#service-account).
3. Assign the **Vertex AI Service Agent** role to your new account. This role allows LLM Controls to access Vertex AI resources. For more information, see [Vertex AI access control with IAM](https://cloud.google.com/vertex-ai/docs/general/access-control).
4. To generate a new JSON key for the service account, navigate to your service account.
5. Click **Add Key**, and then click **Create new key**.
6. Under **Key type**, select **JSON**, and then click **Create**. A JSON private key file is downloaded. Now that you have a service account and a JSON private key, you need to configure the credentials in LLM Controls components.

## **Configure credentials in LLM Controls components**

With your service account configured and your credentials JSON file created, follow these steps to authenticate the LLM Controls application.

1. Create a new project in LLM Controls.
2. From the **Components** menu, drag and drop either the **Vertex AI** or **Vertex AI Embeddings** component to your workspace.
3. In the Vertex AI component's **Credentials** field, add the service account JSON file.
4. Confirm the component can access the Vertex AI resources. Connect a **Chat input** and **Chat output** component to the Vertex AI component. A successful chat confirms the component has access to the Vertex AI resources.

<img src="https://mintcdn.com/devrel/cdevd-bQMnvRiYfJ/images/vertixAi.gif?s=506e0cfcb2acd5cd2969bbfa5295606d" alt="Vertix Ai Gi" width="1920" height="970" data-path="images/vertixAi.gif" />