OpenAI發(fā)布全新函數(shù)調(diào)用指南，助開發(fā)者擴展模型能力！此指南整合了用戶反饋，篇幅縮短50%，內(nèi)容更清晰，並包含最佳實踐、文檔內(nèi)函數(shù)生成以及使用天氣API的完整示例。 OpenAI致力於簡化AI工具，使其更易於開發(fā)者使用，從而更有效地利用函數(shù)調(diào)用功能。

OpenAI發(fā)布全新函數(shù)調(diào)用指南！

我們根據(jù)您的反饋做出了重要改進：

– 篇幅縮短50%，更清晰易懂 – 新增最佳實踐（詳情見下文?） – 支持文檔內(nèi)函數(shù)生成！ – 提供使用天氣API的完整功能示例

查看指南並分享您的想法… pic.twitter.com/Id89E9PEff

— ilan bigio (@ilanbigio) January 13, 2025

目錄

• OpenAI函數(shù)調(diào)用工作原理？
• 快速示例：天氣API
  • 步驟1：定義函數(shù)
  • 步驟2：使用已定義函數(shù)調(diào)用模型
  • 步驟3：執(zhí)行函數(shù)
  • 步驟4：向模型提供結(jié)果
  • 步驟5：獲取最終響應(yīng)
• 函數(shù)調(diào)用的最佳實踐
• 總結(jié)

OpenAI函數(shù)調(diào)用工作原理？

函數(shù)調(diào)用允許OpenAI模型與開發(fā)者定義的工具交互，使其能夠執(zhí)行超出文本或音頻生成的更多任務(wù)。以下是簡化的流程：

1. 定義函數(shù): 創(chuàng)建一個模型可以調(diào)用的函數(shù)（例如，get_weather）。
2. 模型決定調(diào)用函數(shù): 基於系統(tǒng)提示和用戶輸入，模型確定何時調(diào)用函數(shù)。
3. 執(zhí)行函數(shù): 運行函數(shù)代碼並返回結(jié)果。
4. 整合結(jié)果: 模型使用函數(shù)的輸出生成最終響應(yīng)。

該圖片展示了開發(fā)者和AI模型之間函數(shù)調(diào)用的流程。以下是分步說明：

• 工具定義 消息: 開發(fā)者定義工具（函數(shù)）並發(fā)送消息。在本例中，定義了get_weather(location)函數(shù)，用戶詢問：“巴黎的天氣如何？”
• 工具調(diào)用: 模型識別需要使用參數(shù)“paris”調(diào)用get_weather函數(shù)。
• 執(zhí)行函數(shù)代碼: 開發(fā)者（或系統(tǒng)）執(zhí)行實際的get_weather(“paris”)函數(shù)。函數(shù)返迴響應(yīng)，例如：{“temperature”: 14}。
• 結(jié)果: 函數(shù)的結(jié)果（{“temperature”: 14}）與所有先前消息一起返回給模型。
• 最終響應(yīng): 模型使用函數(shù)結(jié)果生成自然語言響應(yīng)，例如：“巴黎目前的溫度是14°C?！?/li>

另請閱讀：支持函數(shù)調(diào)用的6大頂級LLM

快速示例：天氣API

讓我們來看一個使用get_weather函數(shù)的實際示例。此函數(shù)檢索給定坐標(biāo)的當(dāng)前溫度。

步驟1：定義函數(shù)

<code>import requests

def get_weather(latitude, longitude):
    response = requests.get(f"https://api.open-meteo.com/v1/forecast?latitude={latitude}&longitude={longitude}&current=temperature_2m,wind_speed_10m&hourly=temperature_2m,relative_humidity_2m,wind_speed_10m")
    data = response.json()
    return data['current']['temperature_2m']</code>

步驟2：使用已定義函數(shù)調(diào)用模型

<code>from openai import OpenAI
import json

client = OpenAI(api_key="sk-api_key”)

tools = [{
    "type": "function",
    "function": {
        "name": "get_weather",
        "description": "獲取提供的坐標(biāo)（攝氏度）的當(dāng)前溫度。",
        "parameters": {
            "type": "object",
            "properties": {
                "latitude": {"type": "number"},
                "longitude": {"type": "number"}
            },
            "required": ["latitude", "longitude"],
            "additionalProperties": False
        },
        "strict": True
    }
}]

messages = [{"role": "user", "content": "今天巴黎的天氣怎么樣？"}]

completion = client.chat.completions.create(
    model="gpt-4o",
    messages=messages,
    tools=tools,
)</code>

步驟3：執(zhí)行函數(shù)

<code>tool_call = completion.choices[0].message.tool_calls[0]
args = json.loads(tool_call.function.arguments)

result = get_weather(args["latitude"], args["longitude"])</code>

步驟4：向模型提供結(jié)果

<code># 附加模型的工具調(diào)用消息
messages.append(completion.choices[0].message)

# 將結(jié)果消息作為字符串附加
messages.append({
    "role": "tool",
    "tool_call_id": tool_call.id,
    "content": json.dumps({"temperature": result})  # 將結(jié)果轉(zhuǎn)換為JSON字符串
})

# 創(chuàng)建第二個聊天完成
completion_2 = client.chat.completions.create(
    model="gpt-4o",
    messages=messages,
    tools=tools,
)</code>

步驟5：獲取最終響應(yīng)

<code>print(completion_2.choices[0].message.content)</code>

輸出：

<code>巴黎目前的溫度是-2.8°C。</code>

函數(shù)調(diào)用的最佳實踐

為了幫助您充分利用函數(shù)調(diào)用，以下是一些專業(yè)技巧：

1. 編寫清晰詳細的描述
   • 清晰地描述函數(shù)的目的、參數(shù)和輸出。
   • 使用系統(tǒng)提示指導(dǎo)模型何時（以及何時不）使用函數(shù)。
2. 應(yīng)用軟件工程最佳實踐
   • 使函數(shù)直觀易懂。
   • 使用枚舉和對象結(jié)構(gòu)來防止無效狀態(tài)。
3. 減輕模型的負擔(dān)
   • 不要讓模型填寫您已知的參數(shù)。
   • 合併總是按順序調(diào)用的函數(shù)。
4. 保持函數(shù)數(shù)量較少
   • 為了提高準(zhǔn)確性，一次最多使用少於20個函數(shù)。
5. 利用OpenAI資源
   • 使用Playground生成和迭代函數(shù)模式。
   • 考慮針對複雜任務(wù)或大量函數(shù)進行微調(diào)。

了解更多信息，請訪問OpenAI。

總結(jié)

OpenAI改進後的函數(shù)調(diào)用指南使開發(fā)者能夠無縫集成自定義工具，使AI更易於訪問和使用。通過簡化流程、提供清晰的示例以及優(yōu)先考慮用戶反饋，OpenAI使開發(fā)者能夠進行創(chuàng)新並構(gòu)建利用AI全部潛力的解決方案，從而推動現(xiàn)實世界的應(yīng)用和創(chuàng)造力。

以上是簽署OpenAI函數(shù)調(diào)用指南的詳細內(nèi)容。更多資訊請關(guān)注PHP中文網(wǎng)其他相關(guān)文章！