Вызов функций (tool use)

import json
from openai import OpenAI

client = OpenAI(
    api_key="sk-ВАШ_КЛЮЧ",
    base_url="https://www.ruapi.ai/v1",
)

# Это ваш реальный код. Модель его НЕ выполняет — только просит вызвать.
def get_weather(city: str) -> str:
    # тут был бы запрос к погодному API
    return f"В городе {city} сейчас +18°C, переменная облачность"

# Описание функции для модели: что она умеет и какие аргументы принимает
tools = [
    {
        "type": "function",
        "function": {
            "name": "get_weather",
            "description": "Возвращает текущую погоду в указанном городе",
            "parameters": {
                "type": "object",
                "properties": {
                    "city": {
                        "type": "string",
                        "description": "Название города, например «Москва»",
                    }
                },
                "required": ["city"],
            },
        },
    }
]

messages = [{"role": "user", "content": "Какая сейчас погода в Москве?"}]

# Шаг 1. Первый запрос — отдаём модели вопрос и список инструментов
response = client.chat.completions.create(
    model="claude-opus-4-8",  # точные имена — на www.ruapi.ai
    messages=messages,
    tools=tools,
)

message = response.choices[0].message

# Шаг 2. Проверяем, захотела ли модель вызвать функцию
if message.tool_calls:
    # ВАЖНО: сначала дописываем в историю сам ответ модели (с tool_calls)
    messages.append(message)

    # Шаг 3. Обрабатываем каждый вызов (их может быть несколько)
    for tool_call in message.tool_calls:
        # Аргументы приходят СТРОКОЙ с JSON — её нужно распарсить
        args = json.loads(tool_call.function.arguments)

        if tool_call.function.name == "get_weather":
            result = get_weather(args["city"])
        else:
            result = "Неизвестная функция"

        # Результат вызова отдаём отдельным сообщением role="tool"
        messages.append(
            {
                "role": "tool",
                "tool_call_id": tool_call.id,  # привязка к конкретному вызову
                "content": result,
            }
        )

    # Шаг 4. Второй запрос — теперь модель видит результат и даёт финальный ответ
    final = client.chat.completions.create(
        model="claude-opus-4-8",
        messages=messages,
        tools=tools,
    )
    print(final.choices[0].message.content)
else:
    # Модель решила ответить сразу, без вызова функции
    print(message.content)