LogoLogo
API Documentation
Current Version
Current Version
  • DecisionRules Documentation
  • DecisionRules Academy
  • API
    • API Introduction
    • API Keys
      • Solver API Keys
      • Management API keys
      • BI API keys
    • Rule Solver API
    • Management API
      • Rule Migration Strategies
      • Deprecated Endpoints
    • Console Logs API
    • Business Intelligence API
      • Deprecated Endpoints
    • Datacenters & Locations
      • Global Cloud
      • Regional Cloud
    • Apache Kafka Solver API
    • Endpoint Settings
    • Archive
      • Rule Flow Solver API (DEPRECATED)
  • AI Assistant
    • About Assistant
    • Assistant Setup
      • Gemini Assistant
  • RULES
    • Rules Introduction
    • Rule List
    • Rule Mode
    • Common Rule Features
      • Input & Output Model
        • Simple Editor
        • JSON Editor
      • Test Bench
      • Rule Alias
      • Rule State
      • Versioning
      • Rule Variables
      • Execution Strategy
      • Rule Dependencies
      • Rule Export & Import
        • Rule Export
        • Rule Import
        • Managing Decision Table in Excel/Google Sheets
        • Deprecated Formats: XLSX v.1 and CSV
      • Tags
      • Rule Comparison
        • Decision Table Comparison
        • Decision Tree Comparison
        • Scripting Rule Comparison
      • Rule Lock
      • Teamwork Indicator
      • Event Timeline
    • Data Types & Functions
      • Supported Data Types
      • Operators and Functions
        • Basic operators
        • Date operators
        • Functions
          • Logical Functions
          • Math Functions
          • Date and Time Functions
          • Text Functions
          • Data Functions
          • Array Functions
          • Integration functions
          • Functions and JSON
    • Decision Table
      • Table Designer
        • Table Operations
          • Filter Values
          • Valid Values
          • Sorting
      • Binding to Model
    • Decision Tree
      • Tree Designer
    • Workflow
      • Workflow Designer
      • Workflow Nodes Overview
      • Workflow Limits
    • Scripting Rule
      • Custom functions in Scripting Rules
      • Calling external API within ScriptingRules
      • Use Rule Variables in Scripting Rules
      • Call Embedded Rules in Scripting Rules
      • Tips
    • Rule Flow
      • Rule Flow Designer
      • Rule Flow Mapping
      • Rule States in Rule Flow
      • Warnings & Errors
      • Rule Flow Limits
  • SPACE
    • Space Introduction
    • Space Info
    • Dashboard
    • Access
    • API Keys
    • Audit Logs
  • Organization
    • Organization Introduction
    • Organization List
    • Members
    • Teams
    • Spaces
    • Space Roles
    • Policies
    • Statistics
    • Settings
  • Profile
    • Profile Introduction
    • General
    • Dashboard
    • Plans
    • Add-ons
    • Limits
      • Plan Limits Explained
    • Subscriptions
    • Invoices
  • Access
    • Sign Up & Login
    • Invitations & Permissions
    • Single Sign-On (SSO)
  • Business Intelligence
    • Audit Logs
    • Power BI Connectivity
      • Create a Power BI Report
      • Connect Power BI to Business Intelligence API
      • Connecting from Power BI (deprecated)
      • Connect DecisionRules to Power BI Using Our Custom Connector
  • OTHER DEPLOYMENT OPTIONS
    • Regional Cloud
      • Region Specific API URLs
    • Docker & On-Premise
      • Environment Variables
      • Redis Connection Modes
      • DecisionRules Application
        • Minimal Requirements
        • DecisionRules Server
        • DecisionRules Client
        • DecisionRules Business Intelligence
        • Networking Between Docker Containers
      • Setup Single Sign-On (SSO)
        • Set up Microsoft Entra ID SSO
        • Set up Google SSO
      • Docker Showcase App
        • Showcase
        • Showcase + Business Intelligence
      • AWS Setup
        • AWS ECS/Fargate
        • Cache - Amazon ElastiCache
      • Microsoft Azure Setup
        • Database - Azure CosmosDB
        • Cache - Azure Cache for Redis
        • Azure Container Apps
      • Azure Red Hat OpenShift
      • Google Kubernetes Engine (GKE)
      • Kubernetes Setup
        • Kubernetes Setup with Business Intelligence
      • Logging options
      • CD/CI Pipelines
        • Azure DevOps CICD Pipelines
        • Using Migration script (old way)
      • Offline License
      • White Labeling
  • SDK and Integrations
    • Languages / Frameworks
      • SQL Server
      • Oracle PL/SQL
      • PostgreSQL
      • JavaScript
      • Java Spring Example
      • PHP Library
      • Python Library
      • .NET Library
      • Google Tag Manager
    • Excel Add-in
  • Terms & Conditions
    • Terms and Conditions
    • Privacy Policy
    • Service Level Agreement
      • Community Support
      • Standard Cloud (SaaS)
      • Silver SLA
      • Gold SLA
      • Custom SLA
    • Sub-Processor List
  • Product Updates
    • Release Notes
      • Public Cloud
      • On-Premise / Private Cloud
    • Major Updates
      • Changes in Version 1.19.0 (10/2024)
      • Changes in Version 1.20.0 (4/2025)
    • Roadmap
Powered by GitBook
On this page
  • How to Generate Your Gemini Configuration
  • Enable Vertex AI API
  • Choosing the Right Region for Gemini
  • Where to Upload Your Gemini Configuration
  • ⚡ Instant Connection Test
  • 🔧 Which Gemini Model Version Do We Use?

Was this helpful?

  1. AI Assistant
  2. Assistant Setup

Gemini Assistant

Follow these steps to generate your own Google Service Account credentials needed for your Gemini integration.

Last updated 4 days ago

Was this helpful?

How to Generate Your Gemini Configuration

  1. Open Google Cloud Console Go to .

  2. Select or Create a Project Choose your existing project or create a new one where you want to manage AI access.

  3. Create a Service Account (in case you don't have one yet)

    • Click "Create Service Account".

    • Enter a name (e.g., "Gemini AI Access").

    • Click "Create and Continue".

  4. Assign Roles

    • Grant the service account the "Vertex AI User" role (or any other appropriate role to access Vertex AI).

    • Click "Done".

  5. Generate a JSON Key

    • Open your Service Account.

    • Go to the "Keys" tab.

    • Click "Add Key" → "Create New Key".

    • Select "JSON" and click "Create".

    • Download and securely store the JSON file.

🧾 Example Gemini Configuration File

When uploading your AI configuration for Google Gemini, the file should look similar to this:

{
  "type": "service_account",
  "project_id": "your-gcp-project-id",
  "private_key_id": "your-private-key-id",
  "private_key": "-----BEGIN PRIVATE KEY-----\n...\n-----END PRIVATE KEY-----\n",
  "client_email": "your-service-account@your-gcp-project-id.iam.gserviceaccount.com",
  "client_id": "123456789012345678901",
  "auth_uri": "https://accounts.google.com/o/oauth2/auth",
  "token_uri": "https://oauth2.googleapis.com/token",
  "auth_provider_x509_cert_url": "https://www.googleapis.com/oauth2/v1/certs",
  "client_x509_cert_url": "https://www.googleapis.com/robot/v1/metadata/x509/your-service-account%40your-gcp-project-id.iam.gserviceaccount.com",
  "universe_domain": "googleapis.com",
}

Enable Vertex AI API

Before using Gemini models, ensure that Vertex AI is enabled in your Google Cloud project. Without this, you won't be able to access models, endpoints, or perform predictions. To enable it:

  1. Go to the Vertex AI API page.

  2. Select your project.

  3. Click "Enable".

This step is required only once per project and can take a few seconds to activate.

Choosing the Right Region for Gemini

When uploading your Gemini configuration file in DecisionRules, you’ll find a “Region” field in the form. This lets you select the Google Cloud region where your Gemini model will run.

By default, the model runs in us-central1 , which is widely supported and suitable for most users. However, selecting a region closer to your users or aligned with your existing Google Cloud infrastructure can offer benefits like:

  • Faster response times due to reduced latency

  • Compliance with data residency requirements

  • Better integration with other region-specific services

You do not need to include the location in your configuration JSON — the selected region in the form will override it.

Where to Upload Your Gemini Configuration

Now that you’ve generated your Google Cloud Service Account JSON file, you can upload it directly in the DecisionRules app by navigating to Organization → Settings.

There, you’ll find a form where you can:

  • Select your AI model (Gemini)

  • Fill in your preferred region

  • Upload your configuration file in JSON format

Once uploaded, our system will use your credentials securely and exclusively to connect to your Gemini model on Vertex AI, enabling your organization to use the AI Assistant in a fully self-managed way. This approach gives you full control over your AI usage while keeping the integration flexible, isolated, and secure.

Your configuration file is stored securely in our internal database, accessible only to the backend of your own Docker-deployed DecisionRules instance. We never transmit your credentials elsewhere, and the data is only used to authenticate requests to the Vertex AI service on your behalf.

⚡ Instant Connection Test

After submitting, the form will automatically test the connection to Vertex AI. You’ll see right away whether the setup is successful and if the AI assistant is ready to use.

If there’s an issue, you’ll be notified instantly so you can adjust your configuration or permissions without guessing.

🔧 Which Gemini Model Version Do We Use?

When your configuration is connected, our system automatically uses the model version:

gemini-2.0-flash-lite-001

We’ve carefully tested multiple Gemini versions — including the more advanced and higher-priced options — and found that this particular version consistently provides the best results for our use cases in the DecisionRules environment.

⚠️ Note: A more powerful or expensive model doesn’t always mean better outcomes. In our case, gemini-2.0-flash-lite-001 offers the best balance of performance, speed, cost-efficiency, and quality when used for business rule processing and assistant workflows.

how to create access credentials.

To learn more, see Google’s .

Google Service Accounts
Official Google Developer Guide
official list of supported regions