Function calling на практике: инструменты шаг за шагом

Языковая модель сама по себе не знает погоду, курс валют или содержимое вашей базы. Function calling (вызов инструментов) даёт ей мост в реальный мир: вы описываете доступные функции, модель решает, какую позвать и с какими аргументами, а выполняете её вы и возвращаете результат. Разберём полный цикл по шагам. Определение — в глоссарии.

Как это работает: четыре шага

1. Вы описываете инструменты — имя, назначение и схему аргументов каждой функции в поле tools запроса.
2. Модель решает — вместо текста возвращает tool_calls: какую функцию звать и с какими аргументами в JSON.
3. Вы выполняете — модель не запускает код сама; функцию вызываете вы своим кодом и получаете результат.
4. Модель отвечает — результат отправляется обратно, и модель формулирует финальный ответ пользователю на его основе.

Шаг 1: описание инструмента

Инструмент описывается JSON-схемой. Чем понятнее description, тем точнее модель решает, когда его звать:

tools = [{"type": "function","function": {"name": "get_weather","description": "Возвращает текущую погоду в указанном городе","parameters": {"type": "object","properties": {"city": {"type": "string", "description": "Название города"},},"required": ["city"],},},}]

Шаг 2–4: полный цикл

import jsonfrom openai import OpenAI​client = OpenAI(base_url="https://ai-gatewey.ru/v1", api_key="sk-aigate-ваш_ключ")​def get_weather(city: str) -> str:# здесь настоящий запрос к погодному сервисуreturn f"В городе {city} сейчас +18°C, ясно"​messages = [{"role": "user", "content": "Какая погода в Казани?"}]​# 1. модель решает вызвать инструментresp = client.chat.completions.create(model="anthropic/claude-sonnet-5.5", messages=messages, tools=tools,)msg = resp.choices[0].messagemessages.append(msg)​# 2. выполняем вызванную функциюfor call in msg.tool_calls or []:args = json.loads(call.function.arguments)result = get_weather(**args)messages.append({"role": "tool","tool_call_id": call.id,"content": result,})​# 3. модель формулирует финальный ответfinal = client.chat.completions.create(model="anthropic/claude-sonnet-5.5", messages=messages, tools=tools,)print(final.choices[0].message.content)

Практические советы

• Ясные описания — модель выбирает инструмент по description; пишите его как инструкцию, а не как заголовок.
• Строгая схема — перечисляйте required-поля и типы, чтобы аргументы приходили в предсказуемом виде.
• Несколько инструментов — модель сама выберет подходящий или несколько; давайте ей осмысленный набор, а не один на всё.
• Проверка на выходе — всегда валидируйте аргументы и оборачивайте вызов в обработку ошибок.

Список моделей с поддержкой инструментов и детали формата — на странице возможности function calling.

Частые вопросы