Vertex AI Architecture

Published
Length
3 min read

Luis Felipe Dias

All posts

To build a vertex ai architecture, link cloud storage, model training nodes, and API endpoints. You control who can run jobs or call models by setting up cloud roles. Most teams start by giving developers and apps broad roles to test models fast. Over time, these wide permissions stay in place inside production projects. Any user or script with that role can read training files or query live endpoints. How a vertex ai architecture works A vertex ai architecture groups data prep, model trainin

Zero Trust Architecture + AI Agent Security: the complete guide

Architecture patterns, implementation strategies, and security best practices. Delivered to your inbox.

Free white paper. No spam. Unsubscribe anytime.

To build a vertex ai architecture, link cloud storage, model training nodes, and API endpoints. You control who can run jobs or call models by setting up cloud roles. Most teams start by giving developers and apps broad roles to test models fast. Over time, these wide permissions stay in place inside production projects. Any user or script with that role can read training files or query live endpoints.

How a vertex ai architecture works

A vertex ai architecture groups data prep, model training, and model serving in one cloud project. First, teams load raw training datasets into cloud buckets or cloud data tables. Next, training jobs read that data, run compute tasks, and save model files to a registry. Finally, you deploy the saved model to an endpoint so apps can send requests.

Cloud identity and role settings tie all of these moving parts together. You assign service accounts to training jobs so they can read raw data buckets. You also give user roles to engineers so they can run notebooks and test prompts. When an app calls a model endpoint, the cloud checks the caller role first.

Network rules add another boundary around the project and its data buckets. Teams often place endpoints inside private networks to block outside traffic from the public internet. Storage buckets and model registries sit behind these same project walls. Once a caller passes the network and role checks, the endpoint runs the prompt.

Where native project roles leave gaps

Cloud roles and private networks do a great job of blocking outsiders. They decide which user or service account can log in and call an endpoint. They also control who can start a training run or delete a saved model. Still, project roles stop checking once the session starts or the request enters the endpoint.

Native roles do not read what is inside an API call or a database query. An engineer with notebook permissions can pull live customer tables to test a new prompt. That dataset might hold emails, phone numbers, card numbers, or national IDs. Without field-level masking that rewrites matched fields in results, raw personal data enters the notebook.

Zero Trust Architecture + AI Agent Security: architecture patterns and best practices

Continue reading? Get the full guide.

Free. No spam. Unsubscribe anytime.

The same problem happens when apps or users send prompts to hosted foundation models. A cloud role says a developer can call the model endpoint. It does not check if the prompt text includes a secret key or customer card numbers. Standard cloud audit logs record who called the endpoint, but often miss the full payload.

How to tighten data and model permissions

To reduce risk, split your AI work into separate cloud projects for testing and production. Give human engineers viewer roles in production instead of broad editor roles. Let automated pipelines deploy models from the registry to live endpoints. This stops manual changes on live systems.

Next, give each training job and app its own single-purpose service account. Do not share one default service account across all notebooks and endpoints. Grant each account read rights only to the exact bucket it needs. Even with clean roles, you still need a way to inspect queries and mask sensitive fields in flight.

Govern statements and responses across databases and APIs

Good config and scoped roles are needed setup. They do not check single queries in flight or mask sensitive fields in returned rows. Across Postgres, MySQL, SQL Server, MongoDB, ClickHouse, Kubernetes APIs, SSH, and internal HTTP endpoints, hoop.dev runs beside each supported service as an open-source proxy, a sidecar for your database or API.

First, hoop.dev guardrails block banned queries before they run. Then hoop.dev data masking rewrites matched sensitive values in responses in memory. The audit trail records every statement and verdict per resource. Furthermore, hoop.dev holds SOC 2 Type II and is open source on GitHub.

Frequently asked questions

What are the main parts of a Vertex AI setup?

The core parts are cloud storage buckets, managed notebooks, training clusters, a model registry, and endpoints. Cloud identity roles and private networks link these parts inside your project.

How do service accounts work in model training?

A training job uses a service account to read source data and write model files. You should give that account permissions only for the specific buckets required for that job.

Do cloud roles stop sensitive data from entering prompts?

No, cloud roles only check if a user or app is allowed to call the endpoint. They do not inspect prompt text or rewrite emails, phone numbers, or card numbers in flight.

Save the open-source gateway.

hoop is MIT-licensed infrastructure for controlling how AI agents reach production data. Star hoophq/hoop so you can inspect it, deploy it, or share it when your team starts governing agent access.