Вызов функций (Function Calling)

Function calling (tool use) позволяет модели запрашивать вызов ваших функций и получать результат обратно. Поддерживается на всех OpenAI-совместимых моделях.

Параметры

Параметр	Тип	Описание
`tools`	arrayGPT · Claude	Список инструментов. Каждый объект: { type: "function", function: { name, description, parameters } }.
`tool_choice`	string \| objectGPT · Claude	"auto" (модель решает), "none" (не вызывать), "required" (обязательно вызвать), или { type: "function", function: { name } } — конкретный инструмент.
`parallel_tool_calls`	booleanGPT	true — модель запрашивает несколько инструментов одновременно. По умолчанию true. Claude не поддерживает этот флаг, но параллельные вызовы делает самостоятельно.

Пример: однократный вызов

curl https://plusvibeapi.ru/v1/chat/completions \
  -H "Authorization: Bearer $PLUSVIBE_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.5",
    "tools": [{
      "type": "function",
      "function": {
        "name": "get_weather",
        "description": "Возвращает текущую погоду в городе",
        "parameters": {
          "type": "object",
          "properties": {
            "city": { "type": "string", "description": "Название города" }
          },
          "required": ["city"]
        }
      }
    }],
    "tool_choice": "auto",
    "messages": [{"role": "user", "content": "Какая погода в Москве?"}]
  }'

Multi-turn: передаём результат обратно

После вызова инструмента добавьте сообщение роли tool с результатом и отправьте следующий запрос.

# messages после первого ответа с tool_call:
messages = [
    {"role": "user", "content": "Какая погода в Москве?"},
    # ответ модели с вызовом инструмента
    {"role": "assistant", "tool_calls": msg.tool_calls, "content": None},
    # результат вашей функции
    {
        "role": "tool",
        "tool_call_id": msg.tool_calls[0].id,
        "content": json.dumps({"city": "Москва", "temp": 18, "desc": "Облачно"}),
    },
]
resp2 = client.chat.completions.create(model="gpt-5.5", tools=tools, messages=messages)
print(resp2.choices[0].message.content)
# → "В Москве сейчас 18°C, облачно."

Пример ответа (tool_call)

{
  "choices": [{
    "message": {
      "role": "assistant",
      "content": null,
      "tool_calls": [{
        "id": "call_abc123",
        "type": "function",
        "function": {
          "name": "get_weather",
          "arguments": "{\"city\":\"Москва\"}"
        }
      }]
    },
    "finish_reason": "tool_calls"
  }]
}

Параметры tools и tool_choice проходят без изменений на апстрим — поддержка зависит от выбранной модели. GPT-5.x и Claude поддерживают полный цикл tool use.

← Структурированный вывод Модели →