Дата и время
Модель не знает, который час и какое сегодня число. Серверный инструмент aitunnel:datetime отвечает ей на этот вопрос.
aitunnel:datetime нужен для «сколько дней до дедлайна», «что было на прошлой неделе» и любых расчётов от сегодняшней даты. Инструмент исполняет AITUNNEL: запрос к провайдеру не уходит, клиенту ничего реализовывать не нужно. Инструмент бесплатный — платите только за токены модели.
aitunnel:datetime в массиве toolstimezone (по умолчанию 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.
{
"tools": [
{
"type": "aitunnel:datetime",
"parameters": { "timezone": "Europe/Moscow", "max_uses": 3 }
}
]
}| Параметр | Тип | По умолчанию | Описание |
|---|---|---|---|
timezone | string | UTC | Часовой пояс по базе IANA: Europe/Moscow, Asia/Novosibirsk |
max_uses | integer | 3 | Сколько раз модель может спросить время за один запрос: 1–10 |
Часовой пояс задаёт запрос, а не модель: она видит функцию datetime без аргументов и спросить время в другом поясе не может. Нужен пояс пользователя — передайте его в timezone.
max_uses ограничивает только этот инструмент. Общий лимит вызовов серверных инструментов в запросе — max_tool_calls: см. лимиты вызовов.
Что получает модель
{"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:
{
"model": "gpt-5.6-sol",
"input": "Какой сегодня день недели в Новосибирске?",
"tools": [
{
"type": "aitunnel:datetime",
"parameters": { "timezone": "Asia/Novosibirsk" }
}
]
}Цена и учёт
Сам инструмент бесплатный. Платите за токены модели:
- описание инструмента и его результат — несколько десятков токенов в промпте;
- чтобы прочитать результат, AITUNNEL вызывает модель ещё раз. Каждый вызов модели оплачивается как отдельный запрос, в истории запросов это отдельные строки. Сколько было вызовов, показывает
usage.rounds.
{
"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 не работает с ключом, у которого включено скрытие чувствительных данных.» |
См. также
- Серверные инструменты — как AITUNNEL исполняет инструменты, лимиты, стриминг и
usage - Поиск по базе знаний —
aitunnel:file_search, вместе с датой удобно для сроков из документов - Веб-поиск —
aitunnel:web_search - Вызов инструментов — ваши собственные функции