# Gemini Agent SDK Setup

> Integrate OpenAI Agent SDK with Google Gemini backend into FastAPI service using the official Google Gemini API via OpenAI compatibility layer.

- Skill: `majiayu000/gemini-agent-sdk-setup` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add majiayu000/gemini-agent-sdk-setup`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/gemini-agent-sdk-setup/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/gemini-agent-sdk-setup

---


# Gemini Agent SDK Setup

## Instructions

1. Generate the Agent SDK client initialization in app/services/agent/client.py:
   - Import OpenAI from openai package
   - Configure client with GEMINI_API_KEY
   - Set base_url to Google's Gemini OpenAI compatibility endpoint: "https://generativelanguage.googleapis.com/v1beta/openai/"
   - Ensure proper error handling and retry logic

2. Create agent configuration in app/services/agent/config.py:
   - Define model name constants (gemini-1.5-flash, gemini-2.5-flash)
   - Set up default parameters for agent calls
   - Include proper timeout and retry configurations

3. Implement tool registration system in app/services/tools/registry.py:
   - Create function to register tools with the agent
   - Define tool schemas following OpenAI Agent SDK specification
   - Include validation for tool inputs and outputs

4. Create utility functions for calling Gemini models in app/services/agent/utils.py:
   - Wrapper function for agent completion calls
   - Error handling and logging utilities
   - Response parsing and validation

5. Follow Context7 MCP conventions:
   - Only use Gemini models (no OpenAI inference)
   - Follow deterministic output formatting
   - Include proper error handling and logging

## Examples

Input: "Setup Gemini Agent SDK integration"
Output: Creates client.py with:
```python
from openai import OpenAI
import os

client = OpenAI(
    api_key=os.getenv("GEMINI_API_KEY"),
    base_url="https://generativelanguage.googleapis.com/v1beta/openai/"
)

def call_gemini_agent(messages, tools=None, model="gemini-1.5-flash"):
    """Call the Gemini agent with provided messages and tools."""
    try:
        response = client.chat.completions.create(
            model=model,
            messages=messages,
            tools=tools,
            temperature=0.1
        )
        return response
    except Exception as e:
        # Handle errors appropriately
        raise e
```