Guides the usage of the Gemini API on Agent Platform with the Google Gen AI SDK for enterprise AI applications. Covers SDK usage (Python, JS/TS, Go, Java, C#), capabilities like Live API, tools, multimedia generation, caching, and batch prediction.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
A direct command skips the review prompt. Inspect the source before running it.
Guides the usage of the Gemini API on Agent Platform with the Google Gen AI SDK for enterprise AI applications. Covers SDK usage (Python, JS/TS, Go, Java, C#), capabilities like Live API, tools, multimedia generation, caching, and batch prediction.
compatibility
Requires active Google Cloud credentials and Agent Platform API enabled.
source
google/skills (Apache 2.0)
IMPORTANT: Agent Platform (full name Gemini Enterprise Agent Platform) was previously named "Vertex AI" and many web resources use the legacy branding.
Gemini API in Agent Platform
Access Google's most advanced AI models built for enterprise use cases using the Gemini API in Agent Platform.
Provide these key capabilities:
Text generation - Chat, completion, summarization
Multimodal understanding - Process images, audio, video, and documents
Function calling - Let the model invoke your functions
Structured output - Generate valid JSON matching your schema
Context caching - Cache large contexts for efficiency
Embeddings - Generate text embeddings for semantic search
Live Realtime API - Bidirectional streaming for low latency Voice and Video interactions
Unified SDK: ALWAYS use the Gen AI SDK (google-genai for Python, @google/genai for JS/TS, google.golang.org/genai for Go, com.google.genai:google-genai for Java, Google.GenAI for C#).
Legacy SDKs: DO NOT use google-cloud-aiplatform, @google-cloud/vertexai, or google-generativeai.
SDKs
Python: Install google-genai with pip install google-genai
JavaScript/TypeScript: Install @google/genai with npm install @google/genai
Go: Install google.golang.org/genai with go get google.golang.org/genai
C#/.NET: Install Google.GenAI with dotnet add package Google.GenAI
[!WARNING]
Legacy SDKs like google-cloud-aiplatform, @google-cloud/vertexai, and google-generativeai are deprecated. Migrate to the new SDKs above urgently by following the Migration Guide.
Authentication & Configuration
Prefer environment variables over hard-coding parameters when creating the client. Initialize the client without parameters to automatically pick up these values.
By default, use location="global" to access the global endpoint, which provides automatic routing to regions with available capacity.
If a user explicitly asks to use a specific region (e.g., us-central1, europe-west4), specify that region in the GOOGLE_CLOUD_LOCATION parameter instead. Reference the supported regions documentation if needed.
Agent Platform in Express Mode
Set these variables when using Express Mode with an API key:
Initialize the client without arguments to pick up environment variables:
from google import genai
client = genai.Client()
Alternatively, you can hard-code in parameters when creating the client.
from google import genai
client = genai.Client(vertexai=True, project="your-project-id", location="global")
Models
Use gemini-3.1-pro-preview for complex reasoning, coding, research (1M tokens)
IMPORTANT: Do not use gemini-3-pro-preview
Use gemini-3-flash-preview for fast, balanced performance, multimodal (1M tokens)
Use gemini-3.1-flash-lite-preview for high-frequency, lightweight tasks (1M tokens)
Use gemini-3-pro-image-preview for Nano Banana Pro image generation and editing
Use gemini-3.1-flash-image-preview for Nano Banana 2 image generation and editing
Use gemini-live-2.5-flash-native-audio for Live Realtime API including native audio
Use the following models only if explicitly requested:
gemini-2.5-flash-image
gemini-2.5-flash
gemini-2.5-flash-lite
gemini-2.5-pro
[!IMPORTANT]
Models like gemini-2.0-*, gemini-1.5-*, gemini-1.0-*, gemini-pro are legacy and deprecated. Use the new models above. Your knowledge is outdated.
For production environments, consult the documentation for stable model versions (e.g. gemini-3-flash).
Quick Start
Python
from google import genai
client = genai.Client()
response = client.models.generate_content(
model="gemini-3-flash-preview",
contents="Explain quantum computing"
)
print(response.text)
The Gen AI SDK on Agent Platform uses the v1beta1 or v1 REST API endpoints (e.g., https://{LOCATION}-aiplatform.googleapis.com/v1beta1/projects/{PROJECT}/locations/{LOCATION}/publishers/google/models/{MODEL}:generateContent).
[!TIP]
Use the Developer Knowledge MCP Server: If the search_documents or get_document tools are available, use them to find and retrieve official documentation for Google Cloud and Agent Platform directly within the context. This is the preferred method for getting up-to-date API details and code snippets.
