เชื่อมต่อ Google Vertex AI

คิดถึง Google Vertex AI เหมือนกับ “เลานจ์ชั้นธุรกิจ” ของโมเดล AI ตระกูล Gemini จาก Google — โมเดลเจ๋งๆ เดิมๆ แต่มาพร้อมสิทธิพิเศษระดับองค์กร เช่น อัตราค่าบริการที่มั่นคง เรียกเก็บเงินผ่านบัญชี Google Cloud ของคุณ และไม่มีเซอร์ไพรส์เรื่องการจำกัดอัตราการใช้งานแบบสุ่มๆ

ทำไมไม่ใช้แค่ API Key ทั่วไปล่ะ?

ถ้าคุณเคยใช้ผู้ให้บริการ AI รายอื่น คุณคงคุ้นเคยกับการคัดลอก API Key แบบคงที่ไปวางในไฟล์คอนฟิก แต่ Vertex ไม่ได้ทำงานแบบนั้น แทนที่จะเป็นคีย์ที่ไม่เปลี่ยนแปลง Vertex ใช้ OAuth2 token ระยะสั้น — เหมือนบอร์ดดิ้งพาสที่หมดอายุในราวๆ หนึ่งชั่วโมง

ข่าวดี? Hermes Agent จัดการเรื่องการสร้างและรีเฟรช token ให้อัตโนมัติทั้งหมด คุณไม่ต้องแตะต้อง token เลย และนี่คือเหตุผลที่คุณ ไม่สามารถ แค่วาง token ชั่วคราวลงในช่อง api_key ของ custom provider ได้ — เพราะมันจะหมดอายุกลางคันตอนคุยและทำลายเซสชันของคุณ

สิ่งที่คุณต้องเตรียม (ข้อกำหนดเบื้องต้น)

• โปรเจกต์ Google Cloud ที่เปิดใช้งาน Vertex AI API และเปิดการเรียกเก็บเงินแล้ว
• ข้อมูลรับรองอย่างใดอย่างหนึ่งต่อไปนี้:
  • ไฟล์ service account JSON key (แนะนำสำหรับเซิร์ฟเวอร์)
  • Application Default Credentials (ADC) ผ่านคำสั่ง gcloud auth application-default login (เหมาะสำหรับการพัฒนาบนเครื่องท้องถิ่น)

แค่นั้นแหละ Hermes จะติดตั้ง google-auth ให้อัตโนมัติในครั้งแรกที่คุณเลือก Vertex

เริ่มต้นใช้งานด่วน: สองตัวเลือก

ตัวเลือก A — Service Account JSON (สำหรับเซิร์ฟเวอร์/เกตเวย์)

แค่เพิ่มหนึ่งบรรทัดลงในไฟล์ ~/.hermes/.env ของคุณ:

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

ตัวเลือก B — Application Default Credentials (สำหรับการพัฒนาบนเครื่องท้องถิ่น)

รันคำสั่งนี้ในเทอร์มินัลของคุณ:

gcloud auth application-default login

จากนั้นเลือก Vertex เป็นผู้ให้บริการของคุณ:

hermes model

เลือก “More providers…” → “Google Vertex AI” → ใส่ GCP project ID ของคุณ (หรือปล่อยว่างไว้เพื่อใช้ค่าจากข้อมูลรับรองของคุณ) → เลือกภูมิภาค (ค่าเริ่มต้น: global) → เลือกโมเดล Gemini

สุดท้าย เริ่มแชทได้เลย:

hermes chat

การตั้งค่าอยู่ที่ไหน (อธิบายแบบง่ายๆ)

Hermes แบ่งการตั้งค่า Vertex ออกเป็นสองไฟล์ตามระดับความละเอียดอ่อน:

~/.hermes/.env — เก็บ ตัวชี้ความลับ (พาธไปยังข้อมูลรับรองของคุณ):

# ใช้อย่างใดอย่างหนึ่ง (ตรวจสอบตามลำดับนี้); ละเว้นทั้งคู่เพื่อใช้ ADC:
VERTEX_CREDENTIALS_PATH=/path/to/service-account.json
GOOGLE_APPLICATION_CREDENTIALS=/path/to/service-account.json

~/.hermes/config.yaml — เก็บ การตั้งค่าการกำหนดเส้นทางที่ไม่เป็นความลับ (project ID และภูมิภาค):

model:
  default: google/gemini-...

สรุป & เคล็ดลับใช้งานจริง

Vertex AI ให้ความน่าเชื่อถือระดับองค์กรกับโมเดล Gemini และ Hermes จัดการรีเฟรช OAuth2 token ที่ยุ่งยากให้อัตโนมัติ คุณแค่ชี้ Hermes ไปที่ข้อมูลรับรองของคุณครั้งเดียว แล้วก็จบ

เคล็ดลับมือโปร: ถ้าคุณรัน Hermes บนเซิร์ฟเวอร์หรือเกตเวย์ ให้ใช้วิธี service account JSON (ตัวเลือก A) เสมอ — ปลอดภัยและคาดเดาได้กว่า ADC และถ้าติดปัญหาตรงไหน ให้รัน hermes setup เพื่อซ่อมแซมการติดตั้งแบบจัดการ หากการติดตั้ง google-auth แบบง่ายๆ ล้มเหลว ขอให้สนุกกับการสร้างสรรค์ผลงาน!