{"registry_version":"2026.1025.387","generated_at":"2026-10-25T06:27:00Z","content_sha256":"089d16f627d9365e3d0663cc8069203706d7cb23a76c332226e29686968811a5","signed":true,"signature":{"key_id":"ed25519:74ca19268e364242","algorithm":"ed25519","expires_at":"2026-11-24T06:27:09Z","expired":false,"manifest":"/registry/manifest.json"},"entry_sha256":"9f56d969639d03bf91893a87a91801ff170e82bc8f00e1ca0def61f477ccca5b","entry":{"id":"google/vertex-ai","name":"Google Vertex AI (Gemini Enterprise Agent Platform) – project, API and credentials","vendor":"Google Cloud","summary":"Use Gemini and partner models on Google Cloud: a project with billing, the aiplatform.googleapis.com API enabled, IAM roles, and authentication via Application Default Credentials / service account (production) or an API key (testing, or express mode with no billing).","aliases":["vertex-ai","vertex","gemini-enterprise-agent-platform","agent-platform","aiplatform"],"category":"ai","group":"C","homepage":"https://cloud.google.com/vertex-ai","docs":["https://docs.cloud.google.com/vertex-ai/docs/start/cloud-environment","https://docs.cloud.google.com/vertex-ai/generative-ai/docs/start/api-keys","https://docs.cloud.google.com/vertex-ai/generative-ai/docs/start/express-mode/overview","https://docs.cloud.google.com/vertex-ai/generative-ai/docs/standard-paygo"],"status":"researched","last_verified":null,"last_researched":"2026-10-25","sources":[{"id":"gcp-vertex-setup","url":"https://docs.cloud.google.com/vertex-ai/docs/start/cloud-environment","title":"Google Cloud – Set up a project and a development environment","accessed":"2026-10-25","supports":"Select/create project (Project Creator role); confirm billing; enable aiplatform.googleapis.com (serviceusage.services.enable); roles/aiplatform.user suffices for most users; gcloud init and gcloud auth application-default login","kind":"official"},{"id":"gcp-vertex-api-keys","url":"https://docs.cloud.google.com/vertex-ai/generative-ai/docs/start/api-keys","title":"Google Cloud – Get an API key (Agent Platform)","accessed":"2026-10-25","supports":"API key or ADC; API key for testing, ADC for production; express mode needs @gmail.com, Workspace users use the billing-account path; GOOGLE_API_KEY env var; key leaks spend your quota; avoid calling directly from mobile/web clients in production","kind":"official"},{"id":"gcp-vertex-express","url":"https://docs.cloud.google.com/vertex-ai/generative-ai/docs/start/express-mode/overview","title":"Google Cloud – Agent Platform in express mode overview","accessed":"2026-10-25","supports":"Express mode for @gmail.com accounts, no billing for free tier, API key created automatically, 90-day free tier for new users, model list and 10 RPM caps for some models, Activate now to upgrade; product now named Gemini Enterprise Agent Platform","kind":"official"},{"id":"gcp-standard-paygo","url":"https://docs.cloud.google.com/vertex-ai/generative-ai/docs/standard-paygo","title":"Google Cloud – Standard PayGo","accessed":"2026-10-25","supports":"Usage tiers by rolling 30-day spend set TPM thresholds per model family on the global endpoint; 429 means temporary contention; backoff and global endpoint recommended; Priority PayGo / Provisioned Throughput for assured capacity","kind":"official"},{"id":"gcp-genai-quotas","url":"https://docs.cloud.google.com/vertex-ai/generative-ai/docs/quotas","title":"Google Cloud – Generative AI quotas and system limits","accessed":"2026-10-25","supports":"Quotas per project shared across apps; tuned models share base model quota; most increases via console Submit request","kind":"official"},{"id":"gcp-free-trial","url":"https://docs.cloud.google.com/free/docs/free-cloud-features","title":"Google Cloud – Free Trial and Free Tier","accessed":"2026-10-25","supports":"$300 Welcome credit for 90 days; credit card or other payment method required; no billing during trial unless you upgrade; eligibility excludes previous paying users","kind":"official"},{"id":"gcp-service-terms","url":"https://cloud.google.com/terms/service-terms","title":"Google Cloud – Service Specific Terms","accessed":"2026-10-25","supports":"§18 no training on Customer Data without permission; §17 no using outputs to build competing or substitute models; §20(c) Generative AI Prohibited Use Policy; §20(d) not for services directed at under-18s; §20(h) prompt/output storage; §20(i) indemnity; §20(k) grounding with Google Search caching limits","kind":"official"},{"id":"gcp-partner-models","url":"https://docs.cloud.google.com/vertex-ai/generative-ai/docs/partner-models/use-partner-models","title":"Google Cloud – Partner models for MaaS","accessed":"2026-10-25","supports":"Partner models must be enabled from the Model Garden model card (accepting terms) and need the Consumer Procurement Entitlement Manager role; org policy must allow them","kind":"official"}],"allowed_domains":["console.cloud.google.com"],"account_model":{"summary":"A Google account owns or joins a Google Cloud project; the project is linked to a Cloud Billing account and has the Vertex AI (Agent Platform) API enabled. Quotas and spend are per project; Standard PayGo tiers are set by organisation spend.","accounts":[{"name":"Google account","kind":"personal","owned_by":"you","required":true,"note":"Express mode needs a @gmail.com account; Workspace users take the standard billing path."},{"name":"Google Cloud project","kind":"project","parent":"Google account","required":true,"note":"Express mode creates the organisation, project and billing setup for you."},{"name":"Cloud Billing account","kind":"billing","parent":"Google Cloud project","required":false,"note":"Required outside the express-mode free tier."},{"name":"Service account","kind":"other","parent":"Google Cloud project","required":false,"note":"Typical production identity, granted roles/aiplatform.user and used via ADC [to verify service-account setup page]."}],"notes":["Google now documents Vertex AI as \"Gemini Enterprise Agent Platform\"; the API is still aiplatform.googleapis.com."]},"prerequisites":[{"need":"A Google Cloud project you can administer","note":"Related registry entry google/cloud-project-run covers creating a project (Cloud Run parts not needed)."},{"need":"A Cloud Billing account linked to the project (unless using express mode free tier)","note":"Related id google/cloud-billing [to verify entry exists]."}],"have_ready":[{"kind":"payment_card","description":"Credit card or other payment method for Cloud Billing","why":"The Google Cloud Free Trial and paid billing both need a payment method; some countries also need bank account verification.","needed_for":["link-billing"],"auto_check":"none","source":"gcp-free-trial"}],"steps":[{"id":"choose-path","title":"Choose standard setup or express mode","summary":"Express mode (@gmail.com only) gives an API key with no billing and a 90-day free tier for new users, with low rate limits. Standard setup (project + billing) is needed for production, ADC and higher quotas.","route":"guided","depends_on":[],"gate":"none","sources":["gcp-vertex-express","gcp-vertex-api-keys"]},{"id":"express-mode-signup","title":"Sign up for express mode (optional)","summary":"You sign in with a @gmail.com account and accept the terms; an API key is created automatically and is shown on the API Keys page. Upgrade later with \"Activate now\".","route":"guided","depends_on":["choose-path"],"gate":"human_terms","capture":{"env":"GOOGLE_API_KEY","kind":"api_key"},"optional":true,"sources":["gcp-vertex-express"]},{"id":"select-project","title":"Create or select a Google Cloud project","summary":"Pick a project in the console project selector or create one (needs the Project Creator role).","route":"guided","depends_on":["choose-path"],"gate":"human_terms","url":"https://console.cloud.google.com/projectselector2/home/dashboard","sources":["gcp-vertex-setup"]},{"id":"link-billing","title":"Link a billing account","summary":"You confirm billing is enabled on the project, creating a billing account (or Free Trial) and entering payment details yourself if needed.","route":"guided","depends_on":["select-project"],"gate":"human_payment","url":"https://console.cloud.google.com/billing","sources":["gcp-vertex-setup","gcp-free-trial"]},{"id":"enable-api","title":"Enable the Vertex AI (Agent Platform) API","summary":"Enable aiplatform.googleapis.com on the project (needs serviceusage.services.enable, e.g. Owner or Service Usage Admin), or run gcloud services enable aiplatform.googleapis.com.","route":"copilot","depends_on":["link-billing"],"gate":"none","url":"https://console.cloud.google.com/apis/library/aiplatform.googleapis.com","sources":["gcp-vertex-setup"]},{"id":"grant-roles","title":"Grant IAM roles","summary":"Give the calling user or service account roles/aiplatform.user (enough for most use); roles/aiplatform.admin for full control.","route":"guided","depends_on":["enable-api"],"gate":"none","url":"https://console.cloud.google.com/iam-admin/iam","sources":["gcp-vertex-setup"]},{"id":"configure-adc","title":"Configure Application Default Credentials (recommended for production)","summary":"Locally, install the gcloud CLI, run gcloud init then gcloud auth application-default login. In production, run as a service account with the role above. Set the project ID and location in your client.","route":"guided","depends_on":["grant-roles"],"gate":"human_login","sources":["gcp-vertex-setup","gcp-vertex-api-keys"]},{"id":"create-api-key","title":"Create an API key (testing)","summary":"Alternatively create an API key for the project from the API Keys page, add restrictions, and keep it out of source control and client-side apps. Google recommends API keys for testing and ADC for production.","route":"guided","depends_on":["enable-api"],"gate":"none","capture":{"env":"GOOGLE_API_KEY","kind":"api_key"},"optional":true,"sources":["gcp-vertex-api-keys"]},{"id":"enable-partner-models","title":"Enable partner models in Model Garden (optional)","summary":"For non-Google models (e.g. Claude), open the model card in Model Garden, click Enable and accept the model's terms yourself. Needs the Consumer Procurement Entitlement Manager role and an org policy that allows partner models.","route":"guided","depends_on":["enable-api"],"gate":"human_terms","optional":true,"sources":["gcp-partner-models"]}],"outputs":[{"name":"GOOGLE_CLOUD_PROJECT","description":"Google Cloud project ID used for Vertex AI calls","secret":false,"example_format":"my-project-…","environments":["development","test","staging","production"],"from_step":"select-project"},{"name":"GOOGLE_CLOUD_LOCATION","description":"Region or global endpoint for requests (global is recommended for Standard PayGo)","secret":false,"example_format":"global","environments":["development","test","staging","production"],"from_step":"enable-api"},{"name":"GOOGLE_API_KEY","description":"API key for Gemini on Vertex AI (express mode or testing)","secret":true,"example_format":"AIza…","environments":["development","test"],"from_step":"create-api-key"}],"terms_notes":[{"kind":"rules_say","severity":"red","title":"Not for services aimed at under-18s","text":"Generative AI Services may not be used in a site or app directed towards, or likely to be accessed by, individuals under 18.","source":"gcp-service-terms"},{"kind":"rules_say","severity":"amber","title":"No building competing or substitute models from outputs","text":"You may not use AI/ML outputs to substitute or circumvent a Google model or to create or improve similar models (Google's fine-tuning/distillation features excepted). The Generative AI Prohibited Use Policy applies.","source":"gcp-service-terms"},{"kind":"rules_say","severity":"yellow","title":"Google does not train on your data by default","text":"Google will not use Customer Data to train or fine-tune AI/ML models without your prior permission or instruction; generated output is your Customer Data.","source":"gcp-service-terms"},{"kind":"rules_say","severity":"amber","title":"Grounding with Google Search results cannot be cached","text":"Grounded Results and Search Suggestions may not be cached, syndicated or trained on, apart from narrow evaluation and chat-history exceptions.","source":"gcp-service-terms"},{"kind":"rules_say","severity":"amber","title":"A leaked API key spends your quota and money","text":"Anyone with your key can use your project's quota, causing charges and access to tuned models and files. Do not ship keys in mobile or web clients.","source":"gcp-vertex-api-keys"}],"pricing_notes":{"free_tier":"Express mode free tier for new users (90 days, no billing, low rate limits). Separately, the Google Cloud Free Trial gives new customers $300 Welcome credit for 90 days, with a payment method on file.","costs":"Pay-as-you-go per model usage (token-based for Gemini) under Standard PayGo; Priority PayGo, Flex PayGo and Provisioned Throughput also exist [to verify per-model prices].","notes":"Standard PayGo throughput thresholds rise with rolling 30-day organisation spend (e.g. Gemini Flash tier 1 2,000,000 TPM). 429 means temporary contention; retry with backoff and prefer the global endpoint.","source":"gcp-standard-paygo"},"stripe_projects":false,"api_provisioning":{"available":"partial","notes":"Once a project and billing exist, enabling the API (Service Usage), granting IAM roles and creating service accounts and API keys are scriptable with gcloud or Google Cloud APIs. Creating the Google account, accepting terms, adding payment and enabling partner models remain human steps.","docs":["https://docs.cloud.google.com/vertex-ai/docs/start/cloud-environment"],"source":"gcp-vertex-setup"},"notes":["Product renamed in Google docs to Gemini Enterprise Agent Platform; legacy name Vertex AI kept as entry name for search.","Per-model token prices not captured (pricing page did not render in fetch) [to verify].","Express mode sign-up URL and API Keys page URL not captured [to verify].","Console URLs for project selector, IAM and billing are standard console paths [to verify]."]}}