Documentation

Google Cloud Vertex AI

Connect Sypha to Google’s enterprise AI platform, featuring Gemini and partner models like Claude.

← All guides

Sypha facilitates direct integration with Google Cloud’s Vertex AI, an enterprise-grade platform offering high-capacity foundation models, including the full Gemini family and authorized partner models from Anthropic.

Official Site: cloud.google.com/vertex-ai

Strategic Prerequisites

  • GCP Infrastructure: An active Google Cloud Project with the Vertex AI API enabled.
  • Model Authorization: Access must be explicitly granted for specific engines (e.g., Claude) within the GCP console.
  • Primary Authentication (ADC): Sypha utilises Google's Application Default Credentials.
    1. Install the GCP CLI.
    2. Authenticate locally: gcloud auth application-default login
  • Secondary Authentication (Service Account): Alternatively, you can utilize a JSON service account key. Ensure the account has the Vertex AI User role.

Authorized Model Registry

Sypha supports the following enterprise engines on Vertex AI:

  • Google Gemini: Including the full 2.0 and 1.5 Flash and Pro families.
  • Anthropic Claude: Including 3.7 Sonnet, 3.5 Sonnet, and Opus (with optional high-reasoning thinking modes).

Note: For the most recent production IDs, consult the Vertex AI Model Garden.

Configuring Sypha

  1. Access Configuration: Click the gear icon in the Sypha sidebar.
  2. Set Provider: Choose "GCP Vertex AI" from the provider menu.
  3. Configure Authentication Strategy:
    • ADC Execution: If you ran the gcloud command locally, no further entry is required.
    • Service Account Integration: Paste the contents of your JSON key file into the credentials field, or provide the local absolute file path.
  4. Define Project & Region: Input your GCP Project ID and the specific region (e.g., us-central1).
  5. Assign Primary Engine: Select your model from the selector.

Operational Considerations

  • Enterprise Governance: Vertex AI offers robust security and data isolation, making it ideal for corporate environments.
  • Fiscal Oversight: Resource consumption is managed via your GCP billing account. Review the Vertex AI Rate Schedule for details.
  • Identity Awareness: Ensure the authenticated identity has permission to call aiplatform.googleapis.com.