GonkaGate Server Tools

Позвольте модели вызывать инструменты GonkaGate во время chat-completions запроса.

Server Tools — это инструменты, которые выполняет GonkaGate во время POST /v1/chat/completions. Добавьте их в OpenAI-compatible массив tools с префиксом gonkagate:. Вашему приложению не нужно реализовывать callback для этих инструментов.

Доступные инструменты

Инструмент	Type	Что делает
Web Search	`gonkagate:web_search`	Даёт запросу доступ к актуальной информации из web search GonkaGate.
Web Fetch	`gonkagate:web_fetch`	Позволяет модели прочитать публичный URL и извлечённый HTML, text или PDF content.
Datetime	`gonkagate:datetime`	Даёт модели текущую дату и время, optional в нужной timezone.

Как это работает

Добавьте один или несколько GonkaGate server tools в tools.
Отправьте обычный chat-completions запрос на https://api.gonkagate.com/v1/chat/completions.
GonkaGate выполняет server tool, когда он нужен, и передаёт результат модели.
Финальный ответ возвращается как обычно в choices[0].message.content.

Server tools можно использовать рядом с обычными user-defined function tools. GonkaGate выполняет только gonkagate:* инструменты. Ваше приложение по-прежнему обрабатывает собственные function tools.

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

server-tools.sh

export GONKAGATE_API_KEY="gp-your-api-key"

curl https://api.gonkagate.com/v1/chat/completions \
  -H "Authorization: Bearer $GONKAGATE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "qwen/qwen3-235b-a22b-instruct-2507-fp8",
    "messages": [
      {
        "role": "user",
        "content": "What changed in AI this week, and what day is it in New York?"
      }
    ],
    "tools": [
      { "type": "gonkagate:web_search" },
      {
        "type": "gonkagate:datetime",
        "parameters": { "timezone": "America/New_York" }
      }
    ]
  }'

Server Tools vs Plugins vs User-Defined Tools

	Server Tools	Plugins	User-Defined Tools
Who decides to use it	The model	Always runs	The model
Who executes it	GonkaGate	GonkaGate	Your application
Call frequency	0 to N times per request	Once per request	0 to N times per request
Specified via	`tools` array	`plugins` array	`tools` array
Type prefix	`gonkagate:*`	N/A	`function`

Plugins остаются поддержанными. Используйте Server Tools, когда модель должна сама решить, нужен ли GonkaGate-operated tool во время запроса. Используйте plugins, когда нужны plugin-specific request fields или сохранённые plugin settings.

Совместимость

Server tool types должны использовать префикс gonkagate:.
gonkagate:web_search использует существующее web-search поведение GonkaGate и не принимает request-level parameters.
gonkagate:web_fetch поддерживает только non-streaming chat completions. Не используйте его с stream: true.
Если вы комбинируете gonkagate:web_fetch со своими function tools, модель не должна вызывать Web Fetch и ваш function tool в одном assistant turn.
gonkagate:datetime добавляет текущий datetime context до ответа модели.

Связанные страницы

Web Search для актуальной информации.
Web Fetch для чтения публичных URL.
Datetime для timezone-aware текущего времени.
Tool Calling для user-defined function tools.
Справочник Chat Completions API для полной схемы запроса.

Overview