فراخوانی ابزار (Function Calling)

import json
from openai import OpenAI

client = OpenAI(base_url="https://gisoo.pro/api/v1", api_key="sk-gisoo-v1-...")

# 1) Describe the functions your program can run.
tools = [{
    "type": "function",
    "function": {
        "name": "get_order_status",
        "description": "Look up the delivery status of a customer's order by its number.",
        "parameters": {
            "type": "object",
            "properties": {
                "order_number": {"type": "string", "description": "Order number, e.g. BK-10492"}
            },
            "required": ["order_number"],
            "additionalProperties": False,
        },
    },
}]

def get_order_status(order_number: str) -> dict:
    # your real database lookup goes here
    return {"order_number": order_number, "status": "shipped", "eta": "2 days"}

messages = [
    {"role": "system", "content": "You are a bookshop support agent. Reply in Persian."},
    {"role": "user", "content": "Where is my order BK-10492?"},
]

# 2) Let the model decide whether to call a tool.
first = client.chat.completions.create(model="gpt-4o-mini", messages=messages, tools=tools)
msg = first.choices[0].message

if msg.tool_calls:
    messages.append(msg)                          # keep the assistant turn with its tool_calls
    for call in msg.tool_calls:
        args = json.loads(call.function.arguments)  # validate before trusting it
        result = get_order_status(**args)
        messages.append({
            "role": "tool",
            "tool_call_id": call.id,
            "content": json.dumps(result, ensure_ascii=False),
        })

    # 3) Send the results back; the model writes the final answer.
    final = client.chat.completions.create(model="gpt-4o-mini", messages=messages, tools=tools)
    print(final.choices[0].message.content)
else:
    print(msg.content)

const tools = [{
  type: "function",
  function: {
    name: "get_order_status",
    description: "Look up the delivery status of a customer's order by its number.",
    parameters: {
      type: "object",
      properties: { order_number: { type: "string" } },
      required: ["order_number"],
      additionalProperties: false,
    },
  },
}];

const messages = [
  { role: "system", content: "You are a bookshop support agent. Reply in Persian." },
  { role: "user", content: "Where is my order BK-10492?" },
];

const first = await client.chat.completions.create({ model: "gpt-4o-mini", messages, tools });
const msg = first.choices[0].message;

if (msg.tool_calls?.length) {
  messages.push(msg);
  for (const call of msg.tool_calls) {
    const args = JSON.parse(call.function.arguments);
    const result = await getOrderStatus(args.order_number); // your code
    messages.push({ role: "tool", tool_call_id: call.id, content: JSON.stringify(result) });
  }
  const final = await client.chat.completions.create({ model: "gpt-4o-mini", messages, tools });
  console.log(final.choices[0].message.content);
} else {
  console.log(msg.content);
}

curl https://gisoo.pro/api/v1/chat/completions \
  -H "Authorization: Bearer $GISOO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o-mini",
    "messages": [{"role": "user", "content": "Where is my order BK-10492?"}],
    "tools": [{
      "type": "function",
      "function": {
        "name": "get_order_status",
        "description": "Look up the delivery status of an order",
        "parameters": {
          "type": "object",
          "properties": {"order_number": {"type": "string"}},
          "required": ["order_number"]
        }
      }
    }]
  }'

{
  "choices": [{
    "index": 0,
    "finish_reason": "tool_calls",
    "message": {
      "role": "assistant",
      "content": null,
      "tool_calls": [{
        "id": "call_Q7wPz1",
        "type": "function",
        "function": { "name": "get_order_status", "arguments": "{\"order_number\":\"BK-10492\"}" }
      }]
    }
  }]
}

{ "tool_choice": "auto" }                                              // default: model decides
{ "tool_choice": "none" }                                              // never call a tool
{ "tool_choice": "required" }                                          // must call some tool
{ "tool_choice": {"type": "function", "function": {"name": "get_order_status"}} }  // this one