Gemini Cookbook: официальные quickstarts · Урок 2

Function Calling в Gemini API

Передаём функции как tools, включаем automatic_function_calling в ChatSession, разбираем историю с FunctionCall/FunctionResponse и реализуем ручной цикл вызовов.

20 мин чтения3 вопроса в квизеГотовый промпт включёнВ работе

Практическое задание

Что сделать после урока

Создайте чат-бота с тремя инструментами: get_weather(city), convert_currency(amount, from_currency, to_currency) и calculate_tax(income, rate). Протестируйте multi-tool сценарий с одним сообщением пользователя.

Готовый промпт

Шаблон под задачу урока

Скопируйте и адаптируйте под свой контекст. Текст в треугольных скобках — то, что нужно заменить.

from google import genai

client = genai.Client(api_key=GEMINI_API_KEY)

def get_stock_price(ticker: str) -> dict:
    """Get the current stock price for a given ticker symbol."""
    # Mock implementation
    prices = {"GOOGL": 175.0, "AAPL": 190.5, "MSFT": 415.2}
    return {"ticker": ticker, "price": prices.get(ticker, 0), "currency": "USD"}

chat = client.chats.create(
    model="gemini-2.5-flash",
    config={"tools": [get_stock_price]}
)

response = chat.send_message("What is the current price of Apple and Google stocks?")
print(response.text)

Типичные ошибки

На чём чаще всего спотыкаются

Использование неподдерживаемых типов параметров (только int, float, bool, str, list, dict); отсутствие docstring у функции (модель не поймёт её назначение); забывать про FunctionResponse при ручном режиме.

Что такое function calling

Function calling позволяет описать Python-функции и передать их модели — она решает, когда и с какими аргументами их вызывать. SDK автоматически генерирует схему из имени функции, docstring и аннотаций типов.

Определяем функции-инструменты

def enable_lights(): """Turn on the lighting system.""" print("LIGHTBOT: Lights enabled.") def set_light_color(rgb_hex: str): """Set the light color. Lights must be enabled for this to work.""" print(f"LIGHTBOT: Lights set to {rgb_hex}.") def stop_lights(): """Stop flashing lights.""" print("LIGHTBOT: Lights turned off.") light_controls = [enable_lights, set_light_color, stop_lights]

Чат с автоматическим вызовом функций

chat = client.chats.create( model=MODEL_ID, config={ "tools": light_controls, "system_instruction": "You are a lighting system bot.", # automatic_function_calling включён по умолчанию } ) response = chat.send_message("It's awful dark in here...") print(response.text)

def multiply(a: float, b: float): """returns a * b.""" return a * b chat = client.chats.create( model=MODEL_ID, config={"tools": [multiply]} ) response = chat.send_message( "I have 57 cats, each owns 44 mittens, how many mittens is that?" ) print(response.text)

Разбор истории чата

for content in chat.get_history(): print(content.role) for part in content.parts: if part.text: print("Text:", part.text) if part.function_call: print("FunctionCall:", part.function_call) if part.function_response: print("FunctionResponse:", part.function_response)

Ручной режим (generate_content)

response = client.models.generate_content( model=MODEL_ID, contents="Which theaters in Mountain View show Barbie?", config={"tools": theater_functions, "automatic_function_calling": {"disable": True}} ) # Обрабатываем FunctionCall вручную и отправляем FunctionResponse обратно

Сообщить об ошибке

Function Calling в Gemini API

Квиз — 3 вопроса

Что такое function calling

Определяем функции-инструменты

Чат с автоматическим вызовом функций

Математические инструменты — пример

Разбор истории чата

Ручной режим (generate_content)

Автогенерация схемы