استدعاء الأدوات

import json
from openai import OpenAI

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

# 1. وصف الأدوات المتاحة
outils = [
    {
        "type": "function",
        "function": {
            "name": "stock_produit",
            "description": "Retourne le stock disponible d'un produit dans un entrepôt.",
            "parameters": {
                "type": "object",
                "properties": {
                    "reference": {"type": "string", "description": "مرجع المنتج، مثل DEMO-001"},
                    "entrepot": {"type": "string", "enum": ["alger", "oran", "constantine"]},
                },
                "required": ["reference"],
            },
        },
    }
]

# 2. مثال محلي ببيانات افتراضية
def stock_produit(reference: str, entrepot: str = "alger") -> dict:
    return {"reference": reference, "entrepot": entrepot, "disponible": 42}

messages = [{"role": "user", "content": "كم تبقى من DEMO-001 في وهران؟"}]

reponse = client.chat.completions.create(
    model="mina-full", messages=messages, tools=outils
)
message = reponse.choices[0].message

# 3. تنفيذ ما يطلبه النموذج
if message.tool_calls:
    messages.append(message)                       # garder la demande dans l'historique
    for appel in message.tool_calls:
        arguments = json.loads(appel.function.arguments)
        resultat = stock_produit(**arguments)
        messages.append({
            "role": "tool",
            "tool_call_id": appel.id,
            "content": json.dumps(resultat, ensure_ascii=False),
        })

    # 4. طلب الإجابة النهائية
    finale = client.chat.completions.create(
        model="mina-full", messages=messages, tools=outils
    )
    print(finale.choices[0].message.content)
    # → « بقيت 42 وحدة من DEMO-001 في مستودع وهران. »

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.CLOUDZIR_API_KEY,
  baseURL: "https://api.cloudzir.com/v1",
});

const outils = [{
  type: "function",
  function: {
    name: "stock_produit",
    description: "Retourne le stock disponible d'un produit dans un entrepôt.",
    parameters: {
      type: "object",
      properties: {
        reference: { type: "string" },
        entrepot: { type: "string", enum: ["alger", "oran", "constantine"] },
      },
      required: ["reference"],
    },
  },
}];

const implementations = {
  stock_produit: ({ reference, entrepot = "alger" }) => ({ reference, entrepot, disponible: 42 }),
};

const messages = [{ role: "user", content: "كم تبقى من DEMO-001 في وهران؟" }];

let r = await client.chat.completions.create({ model: "mina-full", messages, tools: outils });
const msg = r.choices[0].message;

if (msg.tool_calls?.length) {
  messages.push(msg);
  for (const appel of msg.tool_calls) {
    const args = JSON.parse(appel.function.arguments);
    const resultat = implementations[appel.function.name](args);
    messages.push({
      role: "tool",
      tool_call_id: appel.id,
      content: JSON.stringify(resultat),
    });
  }
  r = await client.chat.completions.create({ model: "mina-full", messages, tools: outils });
  console.log(r.choices[0].message.content);
}