agent-platform-tuning

Fine-tune open and Gemini models on Google Cloud Agent Platform infrastructure.

Updated May 11, 2026
One-click install
npx skills add https://github.com/alon3153/upe-social-publisher --skill agent-platform-tuning-alon3153
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: agent-platform-tuning
Source: https://github.com/alon3153/upe-social-publisher/tree/main/.agents/skills/agent-platform-tuning
Command: npx skills add https://github.com/alon3153/upe-social-publisher --skill agent-platform-tuning-alon3153

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires google-cloud-aiplatform, google-genai, google-cloud-storage, datasets, and includes scripts (resource) and references (resource) components.

What problem does it solve? Fine-tuning large language models on Google Cloud involves many error-prone steps: environment and IAM setup, dataset formatting and validation, model and region selection, cost estimation, job submission, monitoring, and deployment. This Skill guides an AI agent through the entire supervised tuning lifecycle on Agent Platform with guardrails that prevent common failures. ## Core Features & Use Cases - End-to-End Tuning Workflow: Covers environment setup, dataset preparation and validation, model and hyperparameter recommendation, job submission, monitoring, and deployment for both open models (Gemma, Llama, Qwen) and Gemini models. - Deterministic Helper Scripts: Includes scripts to convert and validate JSONL datasets, list available base models, estimate tuning cost, submit and cancel tuning jobs, and poll job status. - Use Case: A user wants to fine-tune Llama 3.1 8B on their own instruction data. The Skill validates the dataset, recommends hyperparameters from the models catalog, estimates cost, verifies the GCS dataset URI, and submits the job only after explicit user confirmation. ## Quick Start Ask the agent to fine-tune an open model on Agent Platform using your JSONL dataset and let it walk you through setup, configuration, and job submission.

Frequently Asked Questions about agent-platform-tuning

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I fine-tune an open model on Google Cloud Agent Platform?▼

Prepare a JSONL dataset in messages or prompt/completion format, upload it to a GCS bucket, then submit a tuning job with a base model resource name like qwen/qwen3@qwen3-8b. The skill's scripts handle validation, cost estimation, submission, and monitoring.

What dataset format does Agent Platform supervised tuning require?▼

Tuning requires JSONL files in UTF-8 stored in Google Cloud Storage, using either a conversational messages format with role and content fields or a prompt/completion format. The prepare_dataset.py script converts CSV, JSON, or Parquet and validates existing JSONL.

Which models are supported for tuning on Agent Platform?▼

Supported open models include Gemma 3 and 4, Llama 3.1 through 4, Qwen 3 and 3.5, and Medgemma, each with a specific publisher resource name. Gemini models are also tunable, but supported regions vary per model and must be checked in the documentation.

Can I use the global location for Gemini model tuning?▼

No, the global endpoint is rejected for Gemini tuning with a FAILED_PRECONDITION error. Global is recommended only for open models; Gemini tuning regions vary per model and must be looked up in the supervised tuning documentation.

Why was my tuning job rejected for validation split size?▼

The tuning service rejects validation files exceeding 25% of the training file measured in bytes, so an 80/20 row split can overshoot. Use a 0.1 validation split, which prepare_dataset.py enforces by measuring the written files before upload.

How do I estimate the cost of a tuning job before submitting?▼

Run calculate_cost.py with your JSONL dataset, model name, tuning mode, and epochs. It multiplies dataset characters by a per-model tokens-per-character ratio and the published price per million tokens to produce a dollar estimate.