gemini 3 1 pro preview vs customtools comparison guide id image 0 图示

gemini-3.1-pro-preview vs customtools: 6 perbedaan utama membantu Anda memilih Model Agen yang tepat

oleh

gemini-3.1-pro-preview dan gemini-3.1-pro-preview-customtools adalah dua endpoint model yang dirilis Google di hari yang sama. Harganya sama, kemampuan penalarannya sama, tapi perilakunya sangat berbeda. Artikel ini akan membandingkan perbedaan keduanya dari 6 dimensi kunci untuk membantu kamu membuat pilihan yang tepat dalam pengembangan Agent.

Nilai Inti: Setelah membaca artikel ini, kamu akan tahu persis kapan harus menggunakan versi standar dan kapan harus menggunakan versi customtools, sehingga terhindar dari "jebakan" saat mengembangkan Agent.

gemini-3-1-pro-preview-vs-customtools-comparison-guide-id 图示

Langsung ke Kesimpulan: Kapan Pakai Versi yang Mana

Kalau kamu sedang terburu-buru, langsung saja lihat tabel ini:

Skenario Kamu Pilih yang Mana Alasan
Dialog murni/Tanya Jawab Versi Standar Kualitas paling stabil
Terjemahan/Analisis teks Versi Standar Tidak melibatkan pemanggilan alat
Pembuatan kode (tanpa alat) Versi Standar Langsung mengeluarkan kode
Asisten coding (dengan alat seperti view_file) Versi customtools Memastikan alat dipanggil dengan benar
Agent DevOps (bash + alat kustom) Versi customtools Menghindari model selalu menggunakan bash untuk melewati alat
Alur kerja MCP Versi customtools Jaminan prioritas alat
Belum yakin? Gunakan standar dulu, jika alat diabaikan baru ganti ke customtools Saran resmi dari Google

🎯 Pernyataan resmi Google: "Jika Anda menggunakan gemini-3.1-pro-preview dan model tersebut mengabaikan alat kustom Anda dan lebih memilih perintah bash, cobalah model gemini-3.1-pro-preview-customtools sebagai gantinya."

Perbedaan 1: Prioritas Pemanggilan Alat — Perbedaan Inti

Ini adalah satu-satunya perbedaan mendasar antara kedua versi tersebut. Ketika model memiliki dua kemampuan sekaligus, yaitu "eksekusi bash" dan "alat kustom", bagaimana cara ia memilih?

Masalah pada Versi Standar: Menggunakan bash secara diam-diam

Saat Anda mendaftarkan alat view_file pada versi standar, tetapi memintanya untuk melihat sebuah berkas:

User: "Lihat isi dari src/main.py"
Perilaku Versi Standar: Menjalankan perintah bash `cat src/main.py`  ← Melewati alat Anda!

Dalam diskusi pengembang di Hacker News, beberapa pengembang memberikan umpan balik mengenai masalah serupa:

  • "Model mencoba mengedit berkas dengan cara yang aneh, alih-alih menggunakan alat pengeditan teks yang disediakan"
  • "Kemampuan pemanggilan alat kurang baik, sering kali mengambil jalan memutar"
  • "Mudah terjebak dalam loop dan tidak bisa lanjut"

Perbaikan pada Versi customtools: Menghargai alat Anda

User: "Lihat isi dari src/main.py"
Perilaku Versi customtools: Memanggil view_file("src/main.py")  ← Menggunakan alat yang Anda daftarkan ✓
Skenario Perilaku Versi Standar Perilaku Versi customtools
Melihat berkas cat src/main.py (bash) view_file("src/main.py")
Mencari kode grep -r "TODO" *.py (bash) search_code("TODO", "*.py")
Mengedit berkas sed -i 's/old/new/' file (bash) edit_file(path, old, new)
Mencantumkan berkas ls -la src/ (bash) list_files("src/")
Menjalankan pengujian pytest tests/ (bash) run_tests("tests/")

Perbedaan 2: Performa Kualitas Umum — Versi Standar Lebih Stabil

Google secara eksplisit memberikan peringatan penting dalam dokumentasi resminya:

"While gemini-3.1-pro-preview-customtools is optimized for agentic workflows that use custom tools and bash, you may see quality fluctuations in some use cases which don't benefit from such tools."

Ini berarti versi customtools mungkin tidak sestabil versi standar dalam skenario berikut:

Tipe Skenario Kualitas Versi Standar Kualitas Versi customtools Penjelasan
Percakapan teks murni ⭐⭐⭐⭐⭐ ⭐⭐⭐⭐ Mungkin ada sedikit fluktuasi
Penulisan teks panjang ⭐⭐⭐⭐⭐ ⭐⭐⭐⭐ Tidak melibatkan alat, versi standar lebih unggul
Penalaran matematika ⭐⭐⭐⭐⭐ ⭐⭐⭐⭐⭐ Kemampuan inti penalaran sama
Pembuatan kode (tanpa alat) ⭐⭐⭐⭐⭐ ⭐⭐⭐⭐ Versi standar sedikit lebih unggul
Agent + Alat kustom ⭐⭐⭐ ⭐⭐⭐⭐⭐ customtools jauh lebih baik
Campuran bash + alat kustom ⭐⭐⭐ ⭐⭐⭐⭐⭐ Keunggulan inti dari customtools

Wawasan Kunci: Versi customtools bukanlah model yang "lebih kuat", melainkan versi yang dioptimalkan agar "lebih fokus pada pemanggilan alat". Dalam skenario yang tidak melibatkan alat, versi standar justru lebih baik.

💡 Saran Pemilihan: Jika lebih dari 50% permintaan aplikasi Anda tidak melibatkan pemanggilan alat, disarankan untuk tetap menggunakan versi standar sebagai default, dan hanya beralih ke versi customtools dalam alur kerja Agent. APIYI (apiyi.com) mendukung peralihan parameter model secara dinamis dalam kode sesuai dengan skenario.

Perbedaan 3: Parameter dan Spesifikasi Model — Sama Persis

Kedua versi ini benar-benar identik dalam hal "spesifikasi perangkat keras":

Spesifikasi Versi Standar Versi customtools
Konteks Input 1.048.576 tokens 1.048.576 tokens
Output Maksimal 65.536 tokens 65.536 tokens
Harga Input (≤200K) $2.00 / 1M tokens $2.00 / 1M tokens
Harga Input (>200K) $4.00 / 1M tokens $4.00 / 1M tokens
Harga Output (≤200K) $12.00 / 1M tokens $12.00 / 1M tokens
Harga Output (>200K) $18.00 / 1M tokens $18.00 / 1M tokens
Cache Konteks $0.20-$0.40 / 1M $0.20-$0.40 / 1M
ARC-AGI-2 77.1% Sama (tidak dirilis secara terpisah)
SWE-Bench 80.6% Sama (tidak dirilis secara terpisah)
GPQA Diamond 94.3% Sama (tidak dirilis secara terpisah)
Sistem Berpikir Low / Medium / High Low / Medium / High
Input Multimodal Teks/Gambar/Audio/Video Teks/Gambar/Audio/Video

Poin Penting: Google tidak merilis data benchmark terpisah untuk versi customtools karena model dasarnya sama. Perbedaannya hanya terletak pada optimasi perilaku pemanggilan alat (tool calling).

Perbedaan 4: Cara Pemanggilan API — Hanya Parameter model yang Berbeda

gemini-3-1-pro-preview-vs-customtools-comparison-guide-id 图示

Contoh Kode: Beralih Antara Versi Standar dan customtools dengan Sekali Klik

import openai

client = openai.OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://api.apiyi.com/v1"  # Antarmuka terpadu APIYI
)

# Mendefinisikan alat kustom
tools = [{
    "type": "function",
    "function": {
        "name": "view_file",
        "description": "Melihat isi file yang ditentukan",
        "parameters": {
            "type": "object",
            "properties": {
                "file_path": {"type": "string", "description": "Jalur file"}
            },
            "required": ["file_path"]
        }
    }
}]

# Versi Standar: Mungkin melewatkan alat
resp_standard = client.chat.completions.create(
    model="gemini-3.1-pro-preview",
    messages=[{"role": "user", "content": "Lihat src/main.py"}],
    tools=tools
)

# Versi customtools: Memprioritaskan penggunaan alat
resp_custom = client.chat.completions.create(
    model="gemini-3.1-pro-preview-customtools",
    messages=[{"role": "user", "content": "Lihat src/main.py"}],
    tools=tools
)

# Membandingkan perbedaan perilaku
print("Versi Standar:", resp_standard.choices[0].message)
print("Versi customtools:", resp_custom.choices[0].message)

Perbedaan 5: Pengalaman Nyata Pengembang — Umpan Balik Komunitas

Umpan balik pengembang di Hacker News dan GitHub mengungkap titik masalah (pain points) versi standar dalam skenario Agent:

Masalah Versi Standar dalam Skenario Agent

Umpan balik pengembang dari diskusi Hacker News:

Deskripsi Masalah Analisis Penyebab Apakah customtools bisa menyelesaikannya?
"Model mencoba mengedit file dengan cara yang aneh, tidak menggunakan alat pengeditan teks yang disediakan" Versi standar cenderung menggunakan bash Bisa — Memprioritaskan penggunaan alat kustom
"Kemampuan pemanggilan alat (tool calling) buruk, sering berputar-putar" Prioritas alat rendah Bisa — Meningkatkan prioritas alat
"Mudah terjebak dalam loop, tidak bisa maju" Perpindahan antara alat dan bash membingungkan Teratasi sebagian — Jalur alat lebih jelas
"Menghabiskan banyak token berpikir lalu melakukan hal yang tidak masuk akal" Konflik antara penalaran model dan pemilihan alat Teratasi sebagian — Pemilihan alat lebih pasti
"Terus-menerus perlu disuruh untuk lanjut atau selesai" Masalah main loop Agent Tidak bisa — Ini adalah masalah umum model

Praktik GitHub Copilot

Tim GitHub Copilot saat mengintegrasikan Gemini 3.1 Pro mencatat:

"Model bekerja sangat baik dalam siklus edit-then-test, memiliki presisi alat yang tinggi, dan mencapai tujuan dengan lebih sedikit pemanggilan alat."

Ini menunjukkan bahwa di bawah kerangka pemanggilan alat yang tepat, kemampuan Agent Gemini 3.1 Pro sangat kuat. Versi customtools dirancang justru agar "presisi alat yang tinggi" ini dapat dipicu dengan lebih andal.

🚀 Saran Praktis: Jika Anda sedang membangun produk asisten pengodean, disarankan untuk langsung mulai dengan versi customtools guna menghindari masalah pengabaian alat pada versi standar. Melalui APIYI apiyi.com, Anda dapat melakukan penerapan dan pengujian dengan cepat.

Perbedaan 6: Kerangka Kerja Agent dan Alat Pengodean yang Sesuai

Alat/Kerangka Kerja Versi yang Disarankan Alasan
Agent Buatan Sendiri (dengan alat kustom) customtools Memastikan alat dipanggil dengan benar
Produk sejenis Claude Code customtools Membutuhkan alat seperti view_file, edit_file, dll.
Cursor customtools Set alat IDE membutuhkan jaminan prioritas
GitHub Copilot Sudah terintegrasi Copilot telah mengoptimalkan pemanggilan alatnya sendiri
LangChain Agent customtools Alat yang terdaftar di kerangka kerja perlu dipanggil secara prioritas
Agent Protokol MCP customtools Alat MCP membutuhkan prioritas
Aplikasi RAG Murni Versi Standar Biasanya tidak melibatkan konflik antara bash vs alat
Aplikasi Chat Versi Standar Tidak melibatkan pemanggilan alat
API Pembuatan Konten Versi Standar Output teks murni

Cara Menentukan Apakah Perlu Beralih dari Versi Standar ke Versi customtools

gemini-3-1-pro-preview-vs-customtools-comparison-guide-id 图示

Daftar Diagnosis Cepat

Jika Anda mengalami situasi berikut saat menggunakan versi standar, itu berarti Anda harus beralih ke versi customtools:

  • Model menjalankan cat alih-alih memanggil view_file Anda
  • Model menjalankan grep alih-alih memanggil search_code Anda
  • Model menjalankan sed alih-alih memanggil edit_file Anda
  • Perintah bash sering muncul dalam log pemanggilan alat model
  • Tingkat pemanggilan alat model lebih rendah dari yang diharapkan (di bawah 50%)
  • Model sepertinya "tidak tahu" bahwa ada alat khusus yang tersedia

Jika muncul lebih dari 2 poin, disarankan untuk segera beralih ke gemini-3.1-pro-preview-customtools.

Lanjutan: Beralih Antara Dua Versi Secara Dinamis dalam Kode

Praktik terbaik bukanlah "pilih salah satu", melainkan melakukan routing secara dinamis berdasarkan jenis permintaan:

import openai

client = openai.OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://api.apiyi.com/v1"  # Antarmuka terpadu APIYI
)

def smart_route(messages, tools=None):
    """Memilih versi model secara dinamis berdasarkan kebutuhan alat"""
    if tools and len(tools) > 0:
        # Ada alat khusus → gunakan versi customtools untuk memastikan alat dipanggil
        model = "gemini-3.1-pro-preview-customtools"
    else:
        # Percakapan murni/penalaran → gunakan versi standar untuk memastikan kualitas yang stabil
        model = "gemini-3.1-pro-preview"

    return client.chat.completions.create(
        model=model,
        messages=messages,
        tools=tools
    )

# Skenario 1: Penalaran murni → otomatis pilih versi standar
resp1 = smart_route(
    messages=[{"role": "user", "content": "Jelaskan prinsip keterikatan kuantum"}]
)

# Skenario 2: Alur kerja Agent → otomatis pilih versi customtools
tools = [{"type": "function", "function": {
    "name": "view_file",
    "description": "Melihat file",
    "parameters": {"type": "object", "properties": {
        "path": {"type": "string"}
    }, "required": ["path"]}
}}]

resp2 = smart_route(
    messages=[{"role": "user", "content": "Lihat config.py"}],
    tools=tools
)

💰 Tips Biaya: Harga kedua versi ini sama persis, routing dinamis tidak akan menambah biaya tambahan apa pun. Melalui antarmuka terpadu APIYI apiyi.com, beralih model semudah mengubah sebuah string.

Pertanyaan yang Sering Diajukan

Q1: Apakah versi customtools lebih mahal?

Tidak. Harga kedua versi ini benar-benar sama: Input $2.00 / 1M token, Output $12.00 / 1M token. Melalui platform APIYI apiyi.com, Anda bisa menggunakan kedua versi tersebut dengan satu API Key yang sama.

Q2: Saya hanya menggunakan function calling tapi tidak memberikan izin eksekusi bash, apakah perlu menggunakan versi customtools?

Biasanya tidak perlu. Versi customtools terutama ditujukan untuk menyelesaikan masalah "saat bash dan alat kustom ada bersamaan, model lebih memprioritaskan bash". Jika Agent Anda tidak memiliki kemampuan eksekusi bash, pemanggilan alat (tool calling) pada versi standar sudah cukup handal.

Q3: Apa sebenarnya yang dimaksud dengan “fluktuasi kualitas” pada versi customtools?

Google belum merilis data spesifik. Berdasarkan umpan balik pengembang, hal ini terutama terlihat pada skenario yang tidak melibatkan alat, seperti percakapan murni atau pembuatan teks panjang, di mana konsistensi output dan gaya penulisan mungkin sedikit berfluktuasi. Namun, untuk skenario Agent yang intensif menggunakan alat, kualitas keseluruhan versi customtools justru lebih baik.

Q4: Bisakah saya menggunakan kedua versi secara bersamaan?

Tentu saja bisa. Direkomendasikan untuk melakukan perutean dinamis (dynamic routing) dalam kode Anda berdasarkan jenis permintaan: kirim permintaan yang melibatkan pemanggilan alat ke versi customtools, dan permintaan teks murni ke versi standar. Melalui antarmuka terpadu APIYI apiyi.com, Anda hanya perlu mengubah parameter model.

Ringkasan: Perbandingan Cepat 6 Poin Versi Standar vs. Customtools

# Dimensi Perbandingan Versi Standar Versi customtools Saran Pemilihan
1 Prioritas Alat Mungkin memprioritaskan bash Memprioritaskan alat kustom Gunakan customtools untuk Agent
2 Kualitas Umum Seimbang di semua skenario Fluktuasi kecil di skenario non-alat Gunakan versi standar untuk tugas umum
3 Spesifikasi/Harga Benar-benar sama Benar-benar sama Tidak ada perbedaan biaya
4 Pemanggilan API Hanya berbeda parameter model Hanya berbeda parameter model Beralih dengan mudah
5 Umpan Balik Komunitas Pemanggilan alat standar kurang handal Pemanggilan alat lebih handal Pilih customtools untuk skenario Agent
6 Framework yang Sesuai Chat/RAG/Penalaran murni Cursor/Claude Code/MCP Tergantung jenis aplikasi Anda

Ringkasan dalam satu kalimat: customtools bukanlah versi upgrade melainkan versi khusus — otak yang sama, tetapi dengan strategi pemilihan alat yang berbeda. Gunakan customtools untuk pengembangan Agent, dan versi standar untuk skenario lainnya. Kedua versi ini dapat beralih secara bebas menggunakan satu API Key yang sama melalui APIYI apiyi.com.

Panduan Cepat Pengambilan Keputusan

Pertanyaan Anda Jawaban
Saya hanya membuat aplikasi percakapan Gunakan versi standar
Saya sedang mengembangkan Agent Gunakan versi customtools
Mana yang lebih kuat di antara keduanya? Kemampuan penalaran sama, pemanggilan alat customtools lebih handal
Apakah perlu mengubah kode untuk beralih? Cukup ubah parameter model, kode lainnya tetap sama
Apakah ada perbedaan biaya? Benar-benar sama

Referensi

  1. Dokumentasi Google AI: Halaman model Gemini 3.1 Pro Preview

    • Tautan: ai.google.dev/gemini-api/docs/models/gemini-3.1-pro-preview
    • Deskripsi: Penjelasan tentang endpoint customtools dan hal-hal yang perlu diperhatikan saat menggunakannya.

  2. Panduan Pengembang Gemini 3: FAQ — Kapan harus beralih model

    • Tautan: ai.google.dev/gemini-api/docs/gemini-3
    • Deskripsi: Rekomendasi resmi mengenai waktu yang tepat untuk beralih dari versi standar ke versi customtools.

  3. Log Perubahan Gemini API: Catatan rilis 19 Februari 2026

    • Tautan: ai.google.dev/gemini-api/docs/changelog
    • Deskripsi: Pengumuman rilis pertama untuk varian customtools.

  4. Diskusi Hacker News: Umpan balik pengembang tentang pemanggilan alat (tool calling) Gemini 3.1 Pro

    • Tautan: news.ycombinator.com/item?id=47074735
    • Deskripsi: Pengalaman nyata para pengembang dan laporan masalah yang ditemukan.

  5. Log Perubahan GitHub Copilot: Integrasi Gemini 3.1 Pro

    • Tautan: github.blog/changelog/2026-02-19-gemini-3-1-pro-is-now-in-public-preview-in-github-copilot
    • Deskripsi: Evaluasi akurasi alat dalam skenario asisten pengkodean (coding assistant).

📝 Penulis: Tim APIYI | Untuk diskusi teknis, kunjungi APIYI apiyi.com
📅 Waktu Pembaruan: 20 Februari 2026
🏷️ Kata Kunci: gemini-3.1-pro-preview-customtools, perbandingan versi standar, pengembangan Agent, pemanggilan alat, function calling, pemilihan model

Tinggalkan komentar