函数调用(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": "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 # 作为工具结果回传给模型
安全
- 密钥只存放在执行调用的服务器上;绝不要写入工具描述或提示词。
- 模型给出的参数要对照由工具、路径和参数组成的白名单进行检查。
- 把 API 响应作为数据交给模型:代币和市场名称可能包含任意文本,包括看起来像指令的文本。
- 交易需要人工确认。Genesis API 只读取数据,不下任何订单;如果你把交易所的交易 API 接入智能体,风险自负,并且每一笔交易都要手动确认。
另请参阅:OpenAPI、JSON、API 密钥、Genesis API 错误、面向 AI 智能体的 Genesis API、面向 AI 智能体的加密货币市场数据。
常见问题
模型能通过函数调用买入币吗?
只有你给它提供这样的工具才行。通过 Genesis API 不行:它只返回数据,不下任何订单。是否交易以及交易本身,都由人来决定和完成。