Документы
Справочник APIВойти

Вызовы инструментов

Передавайте определения функций только модели, в метаданных каталога которой явно указана поддержка инструментов.

Определите инструмент

Запрос чата
{
  "model": "YOUR_APPROVED_MODEL_ID",
  "messages": [
    {
      "role": "user",
      "content": "What is the weather in Paris?"
    }
  ],
  "max_tokens": 256,
  "tools": [
    {
      "type": "function",
      "function": {
        "name": "get_weather",
        "description": "Look up weather for a city",
        "parameters": {
          "type": "object",
          "properties": {
            "city": {
              "type": "string"
            }
          },
          "required": [
            "city"
          ]
        }
      }
    }
  ],
  "tool_choice": "auto"
}

Выполните цикл инструментов

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

Шлюз передаёт определения и результаты инструментов, но не запускает их. Считайте вывод модели и аргументы инструментов недоверенными данными.

Ошибки возможностей

Модель без подтверждённой поддержки инструментов возвращает ошибку unsupported_capability при передаче инструментов или их сообщений. Проверьте каталог перед включением режима инструментов в клиенте.