Вызов функций (function calling)
Вызов функций (function calling, tool use) — режим, в котором языковая модель вместо текста возвращает имя инструмента и аргументы в JSON. Сама модель запрос не выполняет: его делает ваш код, результат возвращается модели, и она отвечает по полученным данным.
Как проходит вызов
- Приложение передаёт модели описания инструментов: имя, назначение и схему аргументов в JSON Schema.
- Модели нужны данные, и она возвращает, например,
funding_ratesс аргументами{"coin": "TON"}. - Код проверяет аргументы, делает запрос к API и отправляет ответ модели.
- Модель пишет ответ по этим данным или вызывает следующий инструмент.
Названия полей зависят от API модели. В Claude API схема лежит в input_schema, модель отвечает блоком tool_use, а результат возвращают блоком tool_result; в MCP схема называется inputSchema.
Инструмент для Genesis API
Описание инструмента для ставок фандинга в формате Claude API:
{
"name": "funding_rates",
"description": "Ставки фандинга монеты по биржам (Genesis API)",
"input_schema": {
"type": "object",
"properties": {
"coin": {"type": "string", "description": "Тикер, например TON"},
"exchange": {"type": "string",
"description": "Биржи через запятую"}
},
"required": ["coin"]
}
}
Исполнитель с белым списком: модель выбирает только из известных инструментов и параметров, ключ берётся из окружения сервера.
import os
import requests
API = "https://api.genesisarbitrage.com/v1"
TOOLS = {"funding_rates": ("/funding/rates", {"coin", "exchange"})}
def run_tool(name: str, args: dict) -> str:
"""Выполняет вызов модели: только известные пути и параметры."""
if name not in TOOLS:
return '{"error": "unknown tool"}'
path, allowed = TOOLS[name]
params = {k: v for k, v in args.items() if k in allowed}
r = requests.get(
API + path,
headers={"X-API-Key": os.environ["GENESIS_API_KEY"]},
params=params,
timeout=10,
)
return r.text # уходит модели как результат инструмента
Безопасность
- Ключ хранится только на сервере, который выполняет вызовы: в описание инструмента и в промпт он не попадает.
- Аргументы модели проверяются по белому списку инструментов, путей и параметров.
- Ответ API передавайте модели как данные: в названиях токенов и рынков бывает произвольный текст, в том числе похожий на инструкции.
- Сделки — только с подтверждением человека. Genesis API только читает данные и ордеров не ставит; торговые API бирж вы подключаете к агенту на свой риск и подтверждаете каждую сделку вручную.
Смотрите также: OpenAPI, JSON, API-ключ, ошибки Genesis API, Genesis API для ИИ-агентов, данные крипторынка для ИИ-агентов.
Вопросы и ответы
Может ли модель сама купить монету через вызов функций?
Только если вы дадите ей такой инструмент. Через Genesis API — нет: он отдаёт данные и ордеров не ставит. Решение о сделке и сама сделка остаются за человеком.