Hubungkan Google Vertex AI

Bayangkan Google Vertex AI sebagai “ruang tunggu kelas bisnis” untuk model AI Gemini milik Google—model hebat yang sama, tetapi dengan fasilitas enterprise seperti tarif yang stabil, penagihan melalui akun Google Cloud Anda, dan tanpa kejutan batas permintaan yang tidak menentu.

Mengapa Tidak Cukup Pakai API Key Biasa?

Jika Anda pernah menggunakan penyedia AI lain, Anda pasti terbiasa menyalin API key statis ke dalam file konfigurasi. Vertex tidak bekerja seperti itu. Alih-alih menggunakan key yang tidak pernah berubah, Vertex menggunakan token OAuth2 berumur pendek—seperti boarding pass yang kedaluwarsa setelah sekitar satu jam.

Kabar baiknya? Hermes Agent menangani semua proses pembuatan dan pembaruan token secara otomatis. Anda tidak perlu menyentuh token sama sekali. Ini juga alasan mengapa Anda tidak bisa hanya menempelkan token sementara ke kolom api_key pada penyedia kustom—token itu akan kedaluwarsa di tengah percakapan dan merusak sesi Anda.

Yang Anda Butuhkan (Prasyarat)

• Proyek Google Cloud dengan Vertex AI API diaktifkan dan penagihan aktif
• Salah satu jenis kredensial berikut:
  • File kunci JSON akun layanan (direkomendasikan untuk server)
  • Application Default Credentials (ADC) melalui gcloud auth application-default login (bagus untuk pengembangan lokal)

Itu saja. Hermes akan menginstal google-auth secara otomatis saat pertama kali Anda memilih Vertex.

Mulai Cepat: Dua Opsi

Opsi A — JSON Akun Layanan (untuk server/gateway)

Cukup tambahkan satu baris ke file ~/.hermes/.env Anda:

echo "VERTEX_CREDENTIALS_PATH=/path/to/service-account.json" >> ~/.hermes/.env

Opsi B — Application Default Credentials (untuk pengembangan lokal)

Jalankan ini di terminal Anda:

gcloud auth application-default login

Lalu pilih Vertex sebagai penyedia Anda:

hermes model

Pilih “More providers…” → “Google Vertex AI” → masukkan ID proyek GCP Anda (atau biarkan kosong untuk menggunakan yang ada di kredensial Anda) → pilih region (default: global) → pilih model Gemini.

Terakhir, mulai mengobrol:

hermes chat

Di Mana Pengaturan Disimpan (Penjelasan Singkat)

Hermes membagi pengaturan Vertex ke dalam dua file berdasarkan tingkat sensitivitas:

~/.hermes/.env — menyimpan penunjuk rahasia (jalur ke kredensial Anda):

# Gunakan salah satu dari ini (diperiksa sesuai urutan); kosongkan keduanya untuk menggunakan ADC:
VERTEX_CREDENTIALS_PATH=/path/to/service-account.json
GOOGLE_APPLICATION_CREDENTIALS=/path/to/service-account.json

~/.hermes/config.yaml — menyimpan pengaturan routing non-rahasia (ID proyek dan region):

model:
  default: google/gemini-...

Ringkasan & Tips Praktis

Vertex AI memberi Anda keandalan kelas enterprise dengan model Gemini, dan Hermes menangani pembaruan token OAuth2 yang rumit secara otomatis. Anda cukup mengarahkan Hermes ke kredensial Anda sekali, dan selesai.

Tips pro: Jika Anda menjalankan Hermes di server atau gateway, selalu gunakan metode JSON akun layanan (Opsi A)—lebih aman dan lebih dapat diprediksi daripada ADC. Dan jika Anda mengalami kendala, jalankan hermes setup untuk memperbaiki instalasi terkelola jika instalasi otomatis google-auth gagal. Selamat membangun!