Skip to content

Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.

2.5 KB
Raw Blame

Google GenAI Provider

The Google GenAI Provider allows you to integrate Google's Generative AI models (Gemini) with Composio tools.

Installation

# Using npm
npm install @composio/core @composio/google @google/genai

# Using yarn
yarn add @composio/core @composio/google @google/genai

# Using pnpm
pnpm add @composio/core @composio/google @google/genai

Usage

import { Composio } from '@composio/core';
import { GoogleProvider } from '@composio/google';
import { GoogleGenAI } from '@google/genai';

// Initialize Google GenAI
const ai = new GoogleGenAI({
  apiKey: process.env.GEMINI_API_KEY,
});

// Initialize Composio with Google Provider
const composio = new Composio({
  apiKey: process.env.COMPOSIO_API_KEY,
  provider: new GoogleProvider(),
});

// Get tools
const tools = await composio.tools.get('default', 'HACKERNEWS_GET_USER');

// Define task
const task = "Fetch the details of the user 'haxzie'";

// Generate content with function calling
const response = await ai.models.generateContent({
  model: 'gemini-3.7-flash',
  contents: task,
  config: {
    tools: [{ functionDeclarations: tools }],
  },
});

// Handle function calls
if (response.functionCalls) {
  console.log(`Calling tool ${response.functionCalls[0].name}`);
  const result = await provider.executeToolCall(
    'default',
    {
      name: response.functionCalls[0].name,
      args: response.functionCalls[0].args
    }
  );
  console.log(JSON.parse(result).data);
}

Configuration Options

The Google GenAI provider supports various initialization options:

Gemini Developer API (API Key)

const ai = new GoogleGenAI({
  apiKey: process.env.GEMINI_API_KEY,
});

Vertex AI

const ai = new GoogleGenAI({
  vertexai: {
    project: 'your-project-id',
    location: 'us-central1',
    apiVersion: 'v1',
  },
});

Supported Models

  • gemini-3.7-flash - Fast, efficient default model for most use cases
  • gemini-3.1-pro-preview - Advanced model with enhanced reasoning and coding capabilities
  • gemini-3.5-flash-lite - Fastest and lowest-cost option for lightweight tasks
  • gemini-2.5-flash - Fast model with thinking capabilities
  • gemini-2.5-pro - Advanced reasoning model

Function Calling

The provider automatically converts Composio tools to the Google GenAI function declaration format, making it easy to use function calling with Gemini models.

Examples

See the examples/google directory for complete examples of using the Google GenAI provider with Composio.