Дата и время

Модель не знает, который час и какое сегодня число. Серверный инструмент aitunnel:datetime отвечает ей на этот вопрос.

aitunnel:datetime нужен для «сколько дней до дедлайна», «что было на прошлой неделе» и любых расчётов от сегодняшней даты. Инструмент исполняет AITUNNEL: запрос к провайдеру не уходит, клиенту ничего реализовывать не нужно. Инструмент бесплатный — платите только за токены модели.

Тип
aitunnel:datetime в массиве tools
Параметры
timezone (по умолчанию UTC), max_uses (по умолчанию 3)
Где работает
/chat/completions, /responses, /messages
Цена
Бесплатно, оплачиваются только токены модели

Быстрый старт

Добавьте инструмент в tools. Модель сама решает, нужно ли ей знать время: на вопрос, где дата не важна, она может ответить, не вызывая инструмент.

curl https://aitunnel.83.141.93.205.nip.io/__api/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-aitunnel-xxx" \
  -d '{
    "model": "gpt-5.6-sol",
    "messages": [
      { "role": "user", "content": "Сколько дней осталось до Нового года?" }
    ],
    "tools": [
      {
        "type": "aitunnel:datetime",
        "parameters": { "timezone": "Europe/Moscow" }
      }
    ]
  }'

Клиент получает один ответ — как на обычный запрос. Вызова инструмента в нём нет; что было исполнено, говорит usage.

Параметры

Все параметры необязательны: { "type": "aitunnel:datetime" } — время по UTC.

JSON
{
  "tools": [
    {
      "type": "aitunnel:datetime",
      "parameters": { "timezone": "Europe/Moscow", "max_uses": 3 }
    }
  ]
}
ПараметрТипПо умолчаниюОписание
timezonestringUTCЧасовой пояс по базе IANA: Europe/Moscow, Asia/Novosibirsk
max_usesinteger3Сколько раз модель может спросить время за один запрос: 1–10

Часовой пояс задаёт запрос, а не модель: она видит функцию datetime без аргументов и спросить время в другом поясе не может. Нужен пояс пользователя — передайте его в timezone.

max_uses ограничивает только этот инструмент. Общий лимит вызовов серверных инструментов в запросе — max_tool_calls: см. лимиты вызовов.

Что получает модель

JSON
{"datetime":"2026-11-18T02:07:31.000+03:00","weekday":"Wednesday","timezone":"Europe/Moscow"}
ПолеСмысл
datetimeМестное время со смещением от UTC, ISO 8601 с миллисекундами
weekdayДень недели по-английски: Monday … Sunday
timezoneЧасовой пояс из параметра timezone

Время берётся в момент вызова. Если модель спросила его дважды за запрос, повторный вызов с теми же аргументами не исполняется: модель получает первый результат.

Где работает

  • В /chat/completions, /responses и /messages, с любой моделью, которая умеет вызывать функции. Тип инструмента и параметры везде одинаковые.
  • Не работает через адрес для Cursor (/v1/cursor) и с API-ключом, у которого включена защита данных. С моделями GigaChat тоже: они не вызывают функции, запрос вернёт ошибку 400.
  • Можно класть в один tools с другими серверными инструментами и со своими функциями: см. вместе с вашими функциями.
  • Со stream: true ответ стримится по токенам; пока исполняется инструмент, приходят SSE-комментарии : aitunnel-progress: см. стриминг.

Тот же инструмент в /responses:

JSON
{
  "model": "gpt-5.6-sol",
  "input": "Какой сегодня день недели в Новосибирске?",
  "tools": [
    {
      "type": "aitunnel:datetime",
      "parameters": { "timezone": "Asia/Novosibirsk" }
    }
  ]
}

Цена и учёт

Сам инструмент бесплатный. Платите за токены модели:

  • описание инструмента и его результат — несколько десятков токенов в промпте;
  • чтобы прочитать результат, AITUNNEL вызывает модель ещё раз. Каждый вызов модели оплачивается как отдельный запрос, в истории запросов это отдельные строки. Сколько было вызовов, показывает usage.rounds.
JSON
{
  "usage": {
    "prompt_tokens": 412,
    "completion_tokens": 58,
    "total_tokens": 470,
    "cost_rub": 0.05,
    "cost_details": {
      "model_rub": 0.05
    },
    "server_tool_use": {
      "tool_calls_requested": 1,
      "tool_calls_executed": 1,
      "datetime_requests": 1
    },
    "rounds": 2
  }
}

usage.server_tool_use.datetime_requests — сколько раз модель узнала время. cost_rub — списание за запрос целиком, суммой по всем вызовам модели. Остальные поля — в учёте серверных инструментов.

Ошибки

Что не такСообщение
timezone не из базы IANA«Укажите часовой пояс в формате IANA, например Europe/Moscow»
max_uses не целое от 1 до 10 или в parameters неизвестное полеЧто не так с полем; поля перечислены в error.metadata.fields
Инструмент указан дважды«Серверный инструмент aitunnel:datetime указан дважды.»
Ваша функция названа datetime«Имя функции datetime занято серверным инструментом aitunnel:datetime.»
Запрос через адрес для Cursor (/v1/cursor)«Инструмент aitunnel:datetime в этом методе недоступен.»
У API-ключа включена защита данных«Инструмент aitunnel:datetime не работает с ключом, у которого включено скрытие чувствительных данных.»

См. также