工具调用

工具调用允许模型生成结构化参数，由你的应用执行函数。模型不会替你执行真实操作。Responses 与 Chat Completions 的工具定义和返回结构不同。

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_HILINKUP_API_KEY",
    base_url="https://api.hilinkup.com/v1",
)

Responses（新项目）
Chat Completions（兼容客户端）

response = client.responses.create(
    model="TOOL_CAPABLE_MODEL_ID",
    input="查询上海明天的天气。",
    tools=[
        {
            "type": "function",
            "name": "get_weather",
            "description": "查询指定城市和日期的天气",
            "parameters": {
                "type": "object",
                "properties": {
                    "city": {"type": "string"},
                    "date": {"type": "string", "format": "date"}
                },
                "required": ["city", "date"],
                "additionalProperties": False
            },
            "strict": True
        }
    ],
)

在 response.output 中查找 type == "function_call" 的项。执行函数后，使用同一个 call_id 发送 function_call_output。

response = client.chat.completions.create(
    model="TOOL_CAPABLE_MODEL_ID",
    messages=[{"role": "user", "content": "查询上海明天的天气。"}],
    tools=[
        {
            "type": "function",
            "function": {
                "name": "get_weather",
                "description": "查询指定城市和日期的天气",
                "parameters": {
                    "type": "object",
                    "properties": {
                        "city": {"type": "string"},
                        "date": {"type": "string", "format": "date"}
                    },
                    "required": ["city", "date"],
                    "additionalProperties": False
                }
            }
        }
    ],
)

在 choices[0].message.tool_calls 中读取调用，并将执行结果作为带 tool_call_id 的 tool 消息返回。

Responses 的函数定义字段直接位于工具对象中；Chat Completions 把定义放在 function 对象内。不要只替换端点后继续沿用另一种结构。

安全边界

工具参数来自模型输出，必须像不可信用户输入一样校验。涉及付款、删除、发信和权限变更时，应增加服务端授权和人工确认。

使用 JSON Schema 限制字段类型和允许值。
设置超时、并发和调用次数上限。
不向模型暴露内部密钥。
按协议返回工具结果：Responses 使用 function_call_output 和 call_id；Chat Completions 使用 tool 消息和 tool_call_id。
对模型不支持的工具参数提供明确降级路径。

入门

核心能力

可靠性

安全边界

​安全边界

安全边界