函式呼叫（Function Calling）

from openai import OpenAI
import json
 
client = OpenAI(
    base_url="https://api.ofox.ai/v1",
    api_key="<你的 OFOXAI_API_KEY>"
)
 
# 1. 定義工具
tools = [{
    "type": "function",
    "function": {
        "name": "get_weather",
        "description": "取得指定城市的即時天氣資訊",
        "parameters": {
            "type": "object",
            "properties": {
                "city": {
                    "type": "string",
                    "description": "城市名稱，如：北京、上海"
                },
                "unit": {
                    "type": "string",
                    "enum": ["celsius", "fahrenheit"],
                    "description": "溫度單位"
                }
            },
            "required": ["city"]
        }
    }
}]
 
# 2. 傳送請求
messages = [{"role": "user", "content": "北京今天天氣怎麼樣？"}]
 
response = client.chat.completions.create(
    model="openai/gpt-4o",
    messages=messages,
    tools=tools,
    tool_choice="auto"
)
 
message = response.choices[0].message
 
# 3. 處理工具呼叫
if message.tool_calls:
    for tool_call in message.tool_calls:
        args = json.loads(tool_call.function.arguments)
 
        # 4. 執行你的函式
        result = get_weather(args["city"])  # 你自己的實作
 
        # 5. 將結果發回模型
        messages.append(message)
        messages.append({
            "role": "tool",
            "tool_call_id": tool_call.id,
            "content": json.dumps(result)
        })
 
    # 取得最終回覆
    final = client.chat.completions.create(
        model="openai/gpt-4o",
        messages=messages,
        tools=tools
    )
    print(final.choices[0].message.content)

import OpenAI from 'openai'
 
const client = new OpenAI({
  baseURL: 'https://api.ofox.ai/v1',
  apiKey: '<你的 OFOXAI_API_KEY>'
})
 
// 1. 定義工具
const tools: OpenAI.ChatCompletionTool[] = [{
  type: 'function',
  function: {
    name: 'get_weather',
    description: '取得指定城市的即時天氣資訊',
    parameters: {
      type: 'object',
      properties: {
        city: { type: 'string', description: '城市名稱' },
        unit: { type: 'string', enum: ['celsius', 'fahrenheit'] }
      },
      required: ['city']
    }
  }
}]
 
// 2. 傳送請求
const messages: OpenAI.ChatCompletionMessageParam[] = [
  { role: 'user', content: '北京今天天氣怎麼樣？' }
]
 
const response = await client.chat.completions.create({
  model: 'openai/gpt-4o',
  messages,
  tools,
  tool_choice: 'auto'
})
 
const message = response.choices[0].message
 
// 3. 處理工具呼叫
if (message.tool_calls) {
  messages.push(message)
 
  for (const toolCall of message.tool_calls) {
    const args = JSON.parse(toolCall.function.arguments)
    const result = await getWeather(args.city)  // 你自己的實作
 
    messages.push({
      role: 'tool',
      tool_call_id: toolCall.id,
      content: JSON.stringify(result)
    })
  }
 
  const final = await client.chat.completions.create({
    model: 'openai/gpt-4o',
    messages,
    tools
  })
 
  console.log(final.choices[0].message.content)
}