Toolها (ابزارها) در هوش مصنوعی

import { OpenAI } from "openai";

const openai = new OpenAI({
  baseURL: '<baseUrl>',
  apiKey: '<LIARA_API_KEY>',
});

function getCurrentWeather(location, unit = "celsius") {
  return {
    location: location,
    temperature: unit === "celsius" ? 35 : 68, // Celsius or Fahrenheit
    unit: unit,
    condition: "Sunny"
  };
}

const tools = [{
    "type": "function",
    "function": {
        "name": "getCurrentWeather",
        "description": "Get current temperature for a given location.",
        "parameters": {
            "type": "object",
            "properties": {
                "location": {
                    "type": "string",
                    "description": "City and country e.g. Bogotá, Colombia"
                },
                "unit": {"type": "string", "enum": ["celsius", "fahrenheit"]},
            },
            "required": [
                "location"
            ],  
        },
    }
}];

"function": {
  "name": "getCurrentWeather",
  "description": "Get current temperature for a given location.",
  "parameters": {
      "type": "object",
      "properties": {
          "location": {
              "type": "string",
              "description": "City and country e.g. Bogotá, Colombia"
          },
          "unit": {"type": "string", "enum": ["celsius", "fahrenheit"]},
      },
      "required": [
          "location"
      ],  
  },
}

"parameters": {
  "type": "object",
  "properties": {
    "location": {
      "type": "string",
      "description": "The city and state, e.g. San Francisco, CA",
    },
    "unit": {"type": "string", "enum": ["celsius", "fahrenheit"]},
  },
  "required": ["location"],
  },

const messages = [{ role: "user", content: "What is the weather like in Paris today?" }];

const completion = await openai.chat.completions.create({
    model: "openai/gpt-4.1",
    messages: messages,
    tools,
    tool_choice: "auto",
});

console.log(JSON.stringify(completion, null, 2));

{
  "id": "6834381c546e1efa313fa872",
  "model": "openai/gpt-4.1",
  "object": "chat.completion",
  "created": 1748252700,
  "choices": [
    {
      "logprobs": null,
      "finish_reason": "tool_calls",
      "native_finish_reason": "tool_calls",
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "",
        "refusal": null,
        "reasoning": null,
        "tool_calls": [
          {
            "index": 0,
            "id": "call_DzeyygbKgYRe6gYvk73fv152",
            "type": "function",
            "function": {
              "name": "getCurrentWeather",
              "arguments": "{"location":"Paris, France"}"
            }
          }
        ]
      }
    }
  ],
  "usage": {
    "prompt_tokens": 77,
    "completion_tokens": 17,
    "total_tokens": 94,
    "prompt_tokens_details": {
      "cached_tokens": 0
    },
    "completion_tokens_details": {
      "reasoning_tokens": 0
    }
  }
}

const argsRaw = completion.choices[0].message.tool_calls[0].function.arguments;
const args = JSON.parse(argsRaw);
console.log(args);

{ location: 'Paris, France' }

const weather = getCurrentWeather(
  args["location"],
  args["unit"] || "celsius"
);

console.log(`The current weather in ${args.location} is ${weather.temperature}°${weather.unit === "celsius" ? "C" : "F"} and ${weather.condition}.`);

The current weather in Paris, France is 35°C and Sunny.

import { OpenAI } from "openai";

const openai = new OpenAI({
  baseURL: '<baseUrl>',
  apiKey: '<LIARA_API_KEY>',
});

function getCurrentWeather(location, unit = "celsius") {
  return {
    location: location,
    temperature: unit === "celsius" ? 35 : 68, // Celsius or Fahrenheit
    unit: unit,
    condition: "Sunny"
  };
}

const tools = [{
    "type": "function",
    "function": {
        "name": "getCurrentWeather",
        "description": "Get current temperature for a given location.",
        "parameters": {
            "type": "object",
            "properties": {
                "location": {
                    "type": "string",
                    "description": "City and country e.g. Bogotá, Colombia"
                },
                "unit": {"type": "string", "enum": ["celsius", "fahrenheit"]},
            },
            "required": [
                "location"
            ],  
        },
    }
}];



const messages = [{ role: "user", content: "What is the weather like in Paris today?" }];

const completion = await openai.chat.completions.create({
    model: "openai/gpt-4.1",
    messages: messages,
    tools,
    tool_choice: "auto",
});

const argsRaw = completion.choices[0].message.tool_calls[0].function.arguments;
const args = JSON.parse(argsRaw);

const weather = getCurrentWeather(
  args["location"],
  args["unit"] || "celsius"
);

console.log(`The current weather in ${args.location} is ${weather.temperature}°${weather.unit === "celsius" ? "C" : "F"} and ${weather.condition}.`);