Genesis Arbitrage

Genesis Arbitrage · · 3 мин чтения

Вызов функций (function calling)

Вызов функций (function calling, tool use) — режим, в котором языковая модель вместо текста возвращает имя инструмента и аргументы в JSON. Сама модель запрос не выполняет: его делает ваш код, результат возвращается модели, и она отвечает по полученным данным.

Как проходит вызов

  1. Приложение передаёт модели описания инструментов: имя, назначение и схему аргументов в JSON Schema.
  2. Модели нужны данные, и она возвращает, например, funding_rates с аргументами {"coin": "TON"}.
  3. Код проверяет аргументы, делает запрос к API и отправляет ответ модели.
  4. Модель пишет ответ по этим данным или вызывает следующий инструмент.

Названия полей зависят от 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  # уходит модели как результат инструмента

Безопасность

Смотрите также: OpenAPI, JSON, API-ключ, ошибки Genesis API, Genesis API для ИИ-агентов, данные крипторынка для ИИ-агентов.

Вопросы и ответы

Может ли модель сама купить монету через вызов функций?

Только если вы дадите ей такой инструмент. Через Genesis API — нет: он отдаёт данные и ордеров не ставит. Решение о сделке и сама сделка остаются за человеком.