Vai al contenuto

Guide alla migrazioneDa Google Vertex AI

Da solo Vertex AI a Vertex come uno dei tuoi provider

Vertex AI, ora parte di Gemini Enterprise Agent Platform, serve Gemini e Claude di Anthropic nel tuo progetto Google Cloud, fatturati da Google. INFRO lo chiama con un service account di quel progetto. La tua app chiama un unico endpoint e può passare in failover tra Claude su Vertex e Claude su Anthropic, o tra Gemini su Vertex e Gemini su Google AI, con i budget verificati prima di ogni chiamata.

Rinominato Gemini Enterprise Agent Platform il 2026-04-22; stessi host aiplatform.googleapis.com

Gli account INFRO sono self-service. Il catalogo, la documentazione e il contratto dell'API sono pubblici, il gateway è in produzione e tutto ciò che va oltre la v1 è indicato come "Più avanti". Piani e prova

A che punto siamo

Il cambio di nome

Le note di rilascio di Google dicono che il 2026-04-22 Vertex AI è entrato a far parte di Gemini Enterprise Agent Platform; la Vertex AI API ora è la Agent Platform API. Gli host aiplatform.googleapis.com sono ancora quelli documentati.

Modifiche all'SDK

Il Google Gen AI SDK ora accetta enterprise=True, mantenendo vertexai=True come flag legacy. Il 2026-09-18 il vecchio SDK Python è passato a google-cloud-agentplatform.

Cosa chiama INFRO

Vertex AI su locations/global nel tuo progetto, con token a breve durata firmati da una chiave di service account che richiede solo roles/aiplatform.user. Ogni modello Claude va abilitato nella sua scheda di Model Garden.

Se tutto ciò che esegui è in Google Cloud e gli strumenti di Google rispondono già alle tue domande, resta. Questi sono i casi specifici.

  • La tua organizzazione vieta le chiavi di service account. La connessione Vertex di INFRO ne usa una; non usa la workload identity federation.
  • Usi cache di contesto esplicite (caches.create e cached_content), grounding o altre funzionalità native di Gemini che le forme chat non supportano.
  • Ti affidi alle labels che arrivano a Cloud Billing per l'allocazione dei costi. INFRO registra l'attribuzione nei propri metadata.
  • Ti serve un endpoint regionale o multiregione per la residenza dei dati. INFRO chiama la location globale; la residenza dei dati è nella roadmap.

Le modifiche, una riga ciascuna. Tutto ciò che non è elencato qui resta com'è.

 Google Vertex AIINFRO
URL di baseaiplatform.googleapis.com/v1/projects/{project}/locations/{location}/...https://api.infro.io/v1 (forma OpenAI), https://api.infro.io per l'SDK di Anthropic.
CredenzialeUn token di accesso di un'ora da Application Default Credentials.Una chiave del gateway INFRO. INFRO detiene la chiave del service account, sigillata, e firma i propri token a breve durata.
Id del modellogemini-3.8-flash, google/gemini-3.8-flash, claude-sonnet-5-5.google/gemini-3.8-flash, anthropic/claude-sonnet-5.5; l'SDK di Anthropic può mantenere claude-sonnet-5-5 su /v1/messages.
Campilabels, o X-Vertex-AI-Labels per i modelli dei partner.metadata { user_id, session_id, tags }, registrati da INFRO, non inviati a Google.

Prima · Vertex AI

import { GoogleGenAI } from "@google/genai";

const ai = new GoogleGenAI({
  enterprise: true, // formerly vertexai: true
  project: "my-project",
  location: "global",
});

const response = await ai.models.generateContent({
  model: "gemini-3.8-flash",
  contents: "Hello",
  config: { labels: { team: "search" } },
});

Dopo · INFRO

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.infro.io/v1",
  apiKey: process.env.INFRO_API_KEY,
});

await client.chat.completions.create({
  model: "google/gemini-3.8-flash",
  messages: [{ role: "user", content: "Hello" }],
  // @ts-expect-error INFRO extension
  metadata: { tags: { team: "search" } },
});

Gemini passa alla forma di OpenAI

Il codice basato sul Gen AI SDK cambia la forma della richiesta in Chat Completions. Le funzionalità che quella forma non supporta, come le cache di contesto esplicite, sono un motivo per mantenere dirette quelle chiamate.

Claude resta nella forma di Anthropic

Su una connessione Vertex, /v1/messages invia il corpo così com'è scritto: blocchi di thinking, cache_control e strumenti inclusi. Una route può mettere Vertex al primo posto e Anthropic al secondo per lo stesso modello Claude.

Un service account

Concedigli solo roles/aiplatform.user. INFRO firma da esso token di un'ora a ogni chiamata e non legge nient'altro nel progetto.

Gli oggetti di Google Vertex AI a confronto con quelli di INFRO, dalla documentazione pubblica di Google Vertex AI letta il 19 ottobre 2026 e verificati con ciò che il gateway implementa. Una riga dice che INFRO non ha nulla.

Google Vertex AICosa fa lìIn INFRO
Progetto e credenzialidiversoIl tuo progetto Google Cloud; token ADC o di service account.Una connessione Vertex con una chiave di service account, sigillata; token firmati a ogni chiamata. Nessuna workload identity federation.
Gemini `generateContent`diversoLa Gemini API nativa tramite il Gen AI SDK.Servito tramite la forma di OpenAI su chat completions; le funzionalità solo native non vengono supportate.
Claude `rawPredict`stessa formaIl corpo Messages di Anthropic su Vertex./v1/messages, inviato a Vertex così com'è scritto.
Endpoint globali e regionalidiversoScegli globale, una regione o una multiregione.Solo la location globale.
EtichettediversoEtichette di costo inoltrate a Cloud Billing.Attribuzione tramite metadata nel log delle richieste e nell'utilizzo di INFRO, per progetto, chiave, utente e tag.
Caching del contestonienteCache esplicite create e richiamate tramite cached_content.Nulla di equivalente. Il cache_control di Claude arriva a Vertex così com'è scritto; INFRO aggiunge una cache delle risposte a corrispondenza esatta.
Quote e Provisioned ThroughputdiversoDynamic Shared Quota, tier Standard PayGo, Provisioned Throughput.Invariato lato Google; un 429 segue la regola di errore della route. INFRO aggiunge budget in dollari.
FailoverdiversoL'endpoint globale sceglie una regione; tra provider diversi se ne occupa il tuo codice.Route tra Vertex, Anthropic, Google AI e altri, con regole di errore per tipo.

È la nostra lettura della documentazione pubblicata da Google Vertex AI, non una prova o un benchmark. Se abbiamo letto male qualcosa, diccelo e correggeremo la riga.

Cosa non fa INFRO

  • Usare workload identity federation o ADC; richiede una chiave di service account.
  • Chiamare endpoint Vertex regionali o multiregione.
  • Supportare funzionalità native di Gemini come le cache di contesto esplicite o il grounding.
  • Inoltrare etichette di fatturazione o riconciliare con la fatturazione Google Cloud.

Cosa non si porta con sé

  • Storico di Cloud Logging e Monitoring; resta in Google Cloud.
  • Le cache di contesto; restano nel tuo progetto.

Domande

INFRO può instradare Claude su Vertex AI?
Sì. Collega Vertex AI con una chiave di service account, abilita il modello Claude in Model Garden e chiama /v1/messages o chat completions.
Chi mi fattura l'utilizzo?
Google Cloud, sul tuo progetto. INFRO è un abbonamento e aggiunge lo 0% alla spesa per i modelli.
Di quali permessi ha bisogno INFRO?
Un service account con roles/aiplatform.user. INFRO lo usa solo per chiamare Vertex AI.

Migra con noi, o da solo

Il programma di migrazione mappa in una call la tua configurazione Google Vertex AI su connessioni, route e budget di INFRO e migra con te il primo servizio. I tuoi provider continuano a fatturarti direttamente; INFRO è un abbonamento e aggiunge 0% alla spesa per i modelli.

Prova di 14 giorni Prenota una sessione di migrazioneLeggi il quickstart

Fonti

Ogni affermazione su Google Vertex AI in questa pagina proviene da una di queste fonti, lette il 19 ottobre 2026. Nulla è dedotto da una prova, un benchmark o una conversazione.