使用工具:扩展模型能力的实用指南
通过远程MCP服务器或网络搜索等工具,扩展模型的功能。
在生成模型响应时,你可以使用内置的工具 来扩展模型能力。这些工具帮助模型从网络或你的文件中获取额外的上下文和信息。下面的示例使用网络搜索工具,利用网络上的最新信息生成模型响应。
为模型响应包含网络搜索结果
javascript
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.aaaaapi.com" });
const response = await client.responses.create({
model: "gpt-4.1",
tools: [ { type: "web_search_preview" } ],
input: "今天有什么积极的新闻报道?",
});
console.log(response.output_text);
python
from openai import OpenAI
client = OpenAI(base_url="https://api.aaaaapi.com")
response = client.responses.create(
model="gpt-4.1",
tools=[{"type": "web_search_preview"}],
input="今天有什么积极的新闻报道?"
)
print(response.output_text)
bash
curl "https://api.aaaaapi.com/v1/responses" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $OPENAI_API_KEY" \
-d '{
"model": "gpt-4.1",
"tools": [{"type": "web_search_preview"}],
"input": "今天有什么积极的新闻报道?"
}'
你可以从下面的可用工具列表中包含几个内置工具,让模型根据对话决定使用哪些工具。
可用工具
以下是OpenAI平台中可用的工具概述------选择其中一个以获取更多使用指导。
调用自定义代码,使模型能够访问额外的数据和功能。
在模型响应生成中包含来自互联网的数据。
通过模型上下文协议(MCP)服务器为模型提供新功能。
在生成响应时搜索上传文件的内容以获取上下文。
使用GPT Image生成或编辑图像。
允许模型在安全容器中执行代码。
创建代理工作流,使模型能够控制计算机界面。
在API中的使用
向模型响应生成请求时,你可以通过在tools
参数中指定配置来启用工具访问。每个工具都有其独特的配置要求------详见可用工具部分的详细说明。
根据提供的提示,模型会自动决定是否使用已配置的工具。例如,如果你的提示请求模型训练截止日期之后的信息,并且启用了网络搜索,模型通常会调用网络搜索工具来检索相关的最新信息。
你可以通过在API请求中设置tool_choice
参数来明确控制或引导此行为。
函数调用
除了内置工具外,你还可以使用tools
数组定义自定义函数。这些自定义函数允许模型调用你的应用程序代码,从而访问模型内部不直接提供的特定数据或功能。
在函数调用指南中了解更多信息。