Genesis Arbitrage

Genesis Arbitrage · · 阅读约 4 分钟

函数调用(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": "A coin's funding rates by exchange (Genesis API)",
  "input_schema": {
    "type": "object",
    "properties": {
      "coin": {"type": "string", "description": "Ticker, e.g. TON"},
      "exchange": {"type": "string",
                   "description": "Exchanges, comma-separated"}
    },
    "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 错误、面向 AI 智能体的 Genesis API、面向 AI 智能体的加密货币市场数据。

常见问题

模型能通过函数调用买入币吗?

只有你给它提供这样的工具才行。通过 Genesis API 不行:它只返回数据,不下任何订单。是否交易以及交易本身,都由人来决定和完成。