| | গুগল কোলাবে চালান | | | গিটহাবে উৎস দেখুন |
জেমা-র মতো কোনো জেনারেটিভ আর্টিফিশিয়াল ইন্টেলিজেন্স (AI) মডেল ব্যবহার করার সময়, আপনি হয়তো কোনো কাজ সম্পন্ন করতে বা প্রশ্নের উত্তর দিতে প্রোগ্রামিং ইন্টারফেস পরিচালনা করার জন্য মডেলটিকে ব্যবহার করতে চাইতে পারেন। একটি প্রোগ্রামিং ইন্টারফেস সংজ্ঞায়িত করে মডেলকে নির্দেশ দেওয়া এবং তারপর সেই ইন্টারফেসটি ব্যবহার করে কোনো অনুরোধ করাকে ফাংশন কলিং বলা হয়।
এই নির্দেশিকাটি হাগিং ফেস ইকোসিস্টেমের মধ্যে জেমা ৪ ব্যবহার করার পদ্ধতি দেখায়।
এই নোটবুকটি টি৪ জিপিইউ-তে চলবে।
পাইথন প্যাকেজ ইনস্টল করুন
জেমা মডেল চালানো এবং অনুরোধ পাঠানোর জন্য প্রয়োজনীয় হাগিং ফেস লাইব্রেরিগুলো ইনস্টল করুন।
# Install PyTorch & other librariespip install torch accelerate# Install the transformers librarypip install transformers
লোড মডেল
নিম্নলিখিত কোড উদাহরণে দেখানো অনুযায়ী transformers লাইব্রেরি ব্যবহার করে AutoProcessor এবং AutoModelForImageTextToText ক্লাসগুলোর সাহায্যে একটি processor এবং model ইনস্ট্যান্স তৈরি করুন:
MODEL_ID = "google/gemma-4-E2B-it" # @param ["google/gemma-4-E2B-it","google/gemma-4-E4B-it", "google/gemma-4-31B-it", "google/gemma-4-26B-A4B-it"]
from transformers import AutoProcessor, AutoModelForMultimodalLM
model = AutoModelForMultimodalLM.from_pretrained(MODEL_ID, dtype="auto", device_map="auto")
processor = AutoProcessor.from_pretrained(MODEL_ID)
Loading weights: 0%| | 0/2011 [00:00<?, ?it/s]
পাসিং টুলস
আপনি ` apply_chat_template() ` ফাংশনের tools আর্গুমেন্টের মাধ্যমে মডেলে টুলস পাস করতে পারেন। এই টুলসগুলো নির্ধারণ করার দুটি পদ্ধতি রয়েছে:
- JSON স্কিমা : আপনি ফাংশনের নাম, বিবরণ এবং প্যারামিটার (টাইপ ও আবশ্যক ফিল্ড সহ) নির্ধারণ করে ম্যানুয়ালি একটি JSON ডিকশনারি তৈরি করতে পারেন।
- র পাইথন ফাংশন : আপনি সরাসরি পাইথন ফাংশন পাস করতে পারেন। সিস্টেমটি ফাংশনের টাইপ হিন্ট, আর্গুমেন্ট এবং ডকস্ট্রিং পার্স করে স্বয়ংক্রিয়ভাবে প্রয়োজনীয় JSON স্কিমা তৈরি করে। সর্বোত্তম ফলাফলের জন্য, ডকস্ট্রিংগুলো গুগল পাইথন স্টাইল গাইড মেনে চলা উচিত।
নিচে JSON স্কিমা সহ উদাহরণটি দেওয়া হলো।
from transformers import TextStreamer
weather_function_schema = {
"type": "function",
"function": {
"name": "get_current_temperature",
"description": "Gets the current temperature for a given location.",
"parameters": {
"type": "object",
"properties": {
"location": {
"type": "string",
"description": "The city name, e.g. San Francisco",
},
},
"required": ["location"],
},
}
}
message = [
{
"role": "system", "content": "You are a helpful assistant."
},
{
"role": "user", "content": "What's the temperature in London?"
}
]
text = processor.apply_chat_template(message, tools=[weather_function_schema], tokenize=False, add_generation_prompt=True)
inputs = processor(text=text, return_tensors="pt").to(model.device)
streamer = TextStreamer(processor)
outputs = model.generate(**inputs, streamer=streamer, max_new_tokens=64)
<bos><|turn>system
You are a helpful assistant.<|tool>declaration:get_current_temperature{description:<|"|>Gets the current temperature for a given location.<|"|>,parameters:{properties:{location:{description:<|"|>The city name, e.g. San Francisco<|"|>,type:<|"|>STRING<|"|>} },required:[<|"|>location<|"|>],type:<|"|>OBJECT<|"|>} }<tool|><turn|>
<|turn>user
What's the temperature in London?<turn|>
<|turn>model
<|tool_call>call:get_current_temperature{location:<|"|>London<|"|>}<tool_call|><|tool_response>
এবং সরাসরি পাইথন ফাংশন ব্যবহার করে একই উদাহরণ।
from transformers.utils import get_json_schema
def get_current_temperature(location: str):
"""
Gets the current temperature for a given location.
Args:
location: The city name, e.g. San Francisco
"""
return "15°C"
message = [
{
"role": "user", "content": "What's the temperature in London?"
}
]
text = processor.apply_chat_template(message, tools=[get_json_schema(get_current_temperature)], tokenize=False, add_generation_prompt=True)
inputs = processor(text=text, return_tensors="pt").to(model.device)
streamer = TextStreamer(processor)
outputs = model.generate(**inputs, streamer=streamer, max_new_tokens=256)
<bos><|turn>system
<|tool>declaration:get_current_temperature{description:<|"|>Gets the current temperature for a given location.<|"|>,parameters:{properties:{location:{description:<|"|>The city name, e.g. San Francisco<|"|>,type:<|"|>STRING<|"|>} },required:[<|"|>location<|"|>],type:<|"|>OBJECT<|"|>} }<tool|><turn|>
<|turn>user
What's the temperature in London?<turn|>
<|turn>model
<|tool_call>call:get_current_temperature{location:<|"|>London<|"|>}<tool_call|><|tool_response>
সম্পূর্ণ ফাংশন কলিং সিকোয়েন্স
এই বিভাগে মডেলকে বাহ্যিক টুলগুলির সাথে সংযুক্ত করার একটি তিন-পর্যায়ের চক্র দেখানো হয়েছে: ফাংশন কল অবজেক্ট তৈরি করার জন্য মডেলের পালা , কোড পার্স ও এক্সিকিউট করার জন্য ডেভেলপারের পালা (যেমন একটি ওয়েদার এপিআই), এবং চূড়ান্ত প্রতিক্রিয়া যেখানে মডেলটি টুলের আউটপুট ব্যবহার করে ব্যবহারকারীকে উত্তর দেয়।
মডেলের পালা
এখানে ব্যবহারকারীর জন্য প্রশ্নটি হলো "Hey, what's the weather in Tokyo right now?" এবং টুলটি হলো [get_current_weather] । জেমা নিম্নরূপ একটি ফাংশন কল অবজেক্ট তৈরি করে।
# Define a function that our model can use.
def get_current_weather(location: str, unit: str = "celsius"):
"""
Gets the current weather in a given location.
Args:
location: The city and state, e.g. "San Francisco, CA" or "Tokyo, JP"
unit: The unit to return the temperature in. (choices: ["celsius", "fahrenheit"])
Returns:
temperature: The current temperature in the given location
weather: The current weather in the given location
"""
return {"temperature": 15, "weather": "sunny"}
prompt = "Hey, what's the weather in Tokyo right now?"
tools = [get_current_weather]
message = [
{
"role": "system", "content": "You are a helpful assistant."
},
{
"role": "user", "content": prompt
},
]
text = processor.apply_chat_template(message, tools=tools, tokenize=False, add_generation_prompt=True)
inputs = processor(text=text, return_tensors="pt").to(model.device)
out = model.generate(**inputs, max_new_tokens=128)
generated_tokens = out[0][len(inputs["input_ids"][0]):]
output = processor.decode(generated_tokens, skip_special_tokens=False)
print(f"Prompt: {prompt}")
print(f"Tools: {tools}")
print(f"Output: {output}")
Prompt: Hey, what's the weather in Tokyo right now?
Tools: [<function get_current_weather at 0x7cef824ece00>]
Output: <|tool_call>call:get_current_weather{location:<|"|>Tokyo, JP<|"|>}<tool_call|><|tool_response>
ডেভেলপারের পালা
আপনার অ্যাপ্লিকেশনটি মডেলের রেসপন্স পার্স করে ফাংশনের নাম ও আর্গুমেন্টগুলো বের করবে এবং tool_calls ও tool_responses সাথে assistant রোলটি যুক্ত করবে।
import re
import json
def extract_tool_calls(text):
def cast(v):
try: return int(v)
except:
try: return float(v)
except: return {'true': True, 'false': False}.get(v.lower(), v.strip("'\""))
return [{
"name": name,
"arguments": {
k: cast((v1 or v2).strip())
for k, v1, v2 in re.findall(r'(\w+):(?:<\|"\|>(.*?)<\|"\|>|([^,}]*))', args)
}
} for name, args in re.findall(r"<\|tool_call>call:(\w+)\{(.*?)\}<tool_call\|>", text, re.DOTALL)]
calls = extract_tool_calls(output)
if calls:
# Call the function and get the result
#####################################
# WARNING: This is a demonstration. #
#####################################
# Using globals() to call functions dynamically can be dangerous in
# production. In a real application, you should implement a secure way to
# map function names to actual function calls, such as a predefined
# dictionary of allowed tools and their implementations.
results = [
{"name": c['name'], "response": globals()[c['name']](**c['arguments'])}
for c in calls
]
message.append({
"role": "assistant",
"tool_calls": [
{"function": call} for call in calls
],
"tool_responses": results
})
print(json.dumps(message[-1], indent=2))
{
"role": "assistant",
"tool_calls": [
{
"function": {
"name": "get_current_weather",
"arguments": {
"location": "Tokyo, JP"
}
}
}
],
"tool_responses": [
{
"name": "get_current_weather",
"response": {
"temperature": 15,
"weather": "sunny"
}
}
]
}
"tool_responses": [
{
"name": function_name,
"response": function_response
}
]
একাধিক স্বতন্ত্র অনুরোধের ক্ষেত্রে:
"tool_responses": [
{
"name": function_name_1,
"response": function_response_1
},
{
"name": function_name_2,
"response": function_response_2
}
]
চূড়ান্ত প্রতিক্রিয়া
অবশেষে, জেমা টুলটির প্রতিক্রিয়া পড়ে ব্যবহারকারীকে উত্তর দেয়।
text = processor.apply_chat_template(message, tools=tools, tokenize=False, add_generation_prompt=True)
inputs = processor(text=text, return_tensors="pt").to(model.device)
out = model.generate(**inputs, max_new_tokens=128)
generated_tokens = out[0][len(inputs["input_ids"][0]):]
output = processor.decode(generated_tokens, skip_special_tokens=True)
print(f"Output: {output}")
message[-1]["content"] = output
Output: The current weather in Tokyo is 15 degrees and sunny.
সম্পূর্ণ চ্যাট হিস্ট্রি নিচে দেখতে পারেন।
# full history
print(json.dumps(message, indent=2))
print("-"*80)
output = processor.decode(out[0], skip_special_tokens=False)
print(f"Output: {output}")
[
{
"role": "system",
"content": "You are a helpful assistant."
},
{
"role": "user",
"content": "Hey, what's the weather in Tokyo right now?"
},
{
"role": "assistant",
"tool_calls": [
{
"function": {
"name": "get_current_weather",
"arguments": {
"location": "Tokyo, JP"
}
}
}
],
"tool_responses": [
{
"name": "get_current_weather",
"response": {
"temperature": 15,
"weather": "sunny"
}
}
],
"content": "The current weather in Tokyo is 15 degrees and sunny."
}
]
--------------------------------------------------------------------------------
Output: <bos><|turn>system
You are a helpful assistant.<|tool>declaration:get_current_weather{description:<|"|>Gets the current weather in a given location.<|"|>,parameters:{properties:{location:{description:<|"|>The city and state, e.g. "San Francisco, CA" or "Tokyo, JP"<|"|>,type:<|"|>STRING<|"|>},unit:{description:<|"|>The unit to return the temperature in.<|"|>,enum:[<|"|>celsius<|"|>,<|"|>fahrenheit<|"|>],type:<|"|>STRING<|"|>} },required:[<|"|>location<|"|>],type:<|"|>OBJECT<|"|>} }<tool|><turn|>
<|turn>user
Hey, what's the weather in Tokyo right now?<turn|>
<|turn>model
<|tool_call>call:get_current_weather{location:<|"|>Tokyo, JP<|"|>}<tool_call|><|tool_response>response:get_current_weather{temperature:15,weather:<|"|>sunny<|"|>}<tool_response|>The current weather in Tokyo is 15 degrees and sunny.<turn|>
চিন্তাভাবনার সাথে ফাংশন কলিং
একটি অভ্যন্তরীণ যুক্তি প্রক্রিয়া ব্যবহারের মাধ্যমে, মডেলটি তার ফাংশন-কল করার নির্ভুলতা উল্লেখযোগ্যভাবে বৃদ্ধি করে। এর ফলে কখন কোনো টুল চালু করতে হবে এবং তার প্যারামিটারগুলো কীভাবে নির্ধারণ করতে হবে, সে বিষয়ে আরও সুনির্দিষ্ট সিদ্ধান্ত নেওয়া সম্ভব হয়।
prompt = "Hey, I'm in Seoul. Is it good for running now?"
message = [
{
"role": "system", "content": "You are a helpful assistant."
},
{
"role": "user", "content": prompt
},
]
text = processor.apply_chat_template(message, tools=tools, tokenize=False, add_generation_prompt=True, enable_thinking=True)
inputs = processor(text=text, return_tensors="pt").to(model.device)
input_len = inputs["input_ids"].shape[-1]
out = model.generate(**inputs, max_new_tokens=1024)
output = processor.decode(out[0][input_len:], skip_special_tokens=False)
result = processor.parse_response(output)
for key, value in result.items():
if key == "role":
print(f"Role: {value}")
elif key == "thinking":
print(f"\n=== Thoughts ===\n{value}")
elif key == "content":
print(f"\n=== Answer ===\n{value}")
elif key == "tool_calls":
print(f"\n=== Tool Calls ===\n{value}")
else:
print(f"\n{key}: {value}...\n")
Role: assistant
=== Thoughts ===
1. **Analyze the Request:** The user is asking if it's "good for running now" in "Seoul".
2. **Identify Necessary Information:** To determine if it's good for running, I need current weather information (temperature, precipitation, etc.) for Seoul.
3. **Examine Available Tools:** The available tool is `get_current_weather(location, unit)`.
4. **Determine Tool Arguments:**
* `location`: The user specified "Seoul".
* `unit`: The user did not specify a unit (Celsius or Fahrenheit).
5. **Formulate the Tool Call:** I need to call `get_current_weather` with the location. Since the user didn't specify a unit, I can either omit it (if the tool defaults are acceptable) or choose a common one. However, the tool definition requires `location` but `unit` is optional.
6. **Construct the Response Strategy:**
* Call the tool to get the weather data for Seoul.
* Once the data is received, I can advise the user on whether it's suitable for running.
7. **Generate Tool Call:**
```json
{
"toolSpec": {
"name": "get_current_weather",
"args": {
"location": "Seoul"
}
}
}
```
(Self-correction: The `unit` parameter is optional in the definition, so just providing the location is sufficient to proceed.)
8. **Final Output Generation:** Present the tool call to the user/system.
=== Tool Calls ===
[{'type': 'function', 'function': {'name': 'get_current_weather', 'arguments': {'location': 'Seoul'} } }]
টুল কলটি প্রক্রিয়া করুন এবং চূড়ান্ত উত্তরটি নিন।
calls = extract_tool_calls(output)
if calls:
# Call the function and get the result
#####################################
# WARNING: This is a demonstration. #
#####################################
# Using globals() to call functions dynamically can be dangerous in
# production. In a real application, you should implement a secure way to
# map function names to actual function calls, such as a predefined
# dictionary of allowed tools and their implementations.
results = [
{"name": c['name'], "response": globals()[c['name']](**c['arguments'])}
for c in calls
]
message.append({
"role": "assistant",
"tool_calls": [
{"function": call} for call in calls
],
"tool_responses": results
})
text = processor.apply_chat_template(message, tools=tools, tokenize=False, add_generation_prompt=True)
inputs = processor(text=text, return_tensors="pt").to(model.device)
out = model.generate(**inputs, max_new_tokens=128)
generated_tokens = out[0][len(inputs["input_ids"][0]):]
output = processor.decode(generated_tokens, skip_special_tokens=True)
print(f"Output: {output}")
message[-1]["content"] = output
print("-"*80)
print("Full History")
print("-"*80)
print(json.dumps(message, indent=2))
Output: The current weather in Seoul is 15 degrees Celsius and sunny. That sounds like great weather for a run!
--------------------------------------------------------------------------------
Full History
--------------------------------------------------------------------------------
[
{
"role": "system",
"content": "You are a helpful assistant."
},
{
"role": "user",
"content": "Hey, I'm in Seoul. Is it good for running now?"
},
{
"role": "assistant",
"tool_calls": [
{
"function": {
"name": "get_current_weather",
"arguments": {
"location": "Seoul"
}
}
}
],
"tool_responses": [
{
"name": "get_current_weather",
"response": {
"temperature": 15,
"weather": "sunny"
}
}
],
"content": "The current weather in Seoul is 15 degrees Celsius and sunny. That sounds like great weather for a run!"
}
]
গুরুত্বপূর্ণ সতর্কতা: স্বয়ংক্রিয় বনাম ম্যানুয়াল স্কিমা
পাইথন ফাংশন থেকে JSON স্কিমাতে স্বয়ংক্রিয় রূপান্তরের উপর নির্ভর করলে, জটিল প্যারামিটারগুলির ক্ষেত্রে উৎপন্ন আউটপুট সবসময় নির্দিষ্ট প্রত্যাশা পূরণ নাও করতে পারে।
যদি কোনো ফাংশন আর্গুমেন্ট হিসেবে একটি কাস্টম অবজেক্ট (যেমন একটি Config ক্লাস) ব্যবহার করে, তাহলে স্বয়ংক্রিয় কনভার্টারটি এর অভ্যন্তরীণ বৈশিষ্ট্যগুলির বিস্তারিত বিবরণ না দিয়ে এটিকে কেবল একটি জেনেরিক "অবজেক্ট" হিসাবে বর্ণনা করতে পারে।
এইসব ক্ষেত্রে, মডেলের জন্য নেস্টেড প্রোপার্টিগুলো (যেমন একটি কনফিগ অবজেক্টের ভেতরের থিম বা ফন্ট_সাইজ) যেন সুস্পষ্টভাবে সংজ্ঞায়িত হয়, তা নিশ্চিত করতে JSON স্কিমা ম্যানুয়ালি নির্ধারণ করাই শ্রেয়।
import json
from transformers.utils import get_json_schema
class Config:
def __init__(self):
self.theme = "light"
self.font_size = 14
def update_config(config: Config):
"""
Updates the configuration of the system.
Args:
config: A Config object
Returns:
True if the configuration was successfully updated, False otherwise.
"""
update_config_schema = {
"type": "function",
"function": {
"name": "update_config",
"description": "Updates the configuration of the system.",
"parameters": {
"type": "object",
"properties": {
"config": {
"type": "object",
"description": "A Config object",
"properties": {"theme": {"type": "string"}, "font_size": {"type": "number"} },
},
},
"required": ["config"],
},
},
}
print(f"--- [Automatic] ---")
print(json.dumps(get_json_schema(update_config), indent=2))
print(f"\n--- [Manual Schemas] ---")
print(json.dumps(update_config_schema, indent=2))
--- [Automatic] ---
{
"type": "function",
"function": {
"name": "update_config",
"description": "Updates the configuration of the system.",
"parameters": {
"type": "object",
"properties": {
"config": {
"type": "object",
"description": "A Config object"
}
},
"required": [
"config"
]
}
}
}
--- [Manual Schemas] ---
{
"type": "function",
"function": {
"name": "update_config",
"description": "Updates the configuration of the system.",
"parameters": {
"type": "object",
"properties": {
"config": {
"type": "object",
"description": "A Config object",
"properties": {
"theme": {
"type": "string"
},
"font_size": {
"type": "number"
}
}
}
},
"required": [
"config"
]
}
}
}
সারসংক্ষেপ এবং পরবর্তী পদক্ষেপ
আপনি জেমা ৪ ব্যবহার করে ফাংশন কল করতে পারে এমন একটি অ্যাপ্লিকেশন কীভাবে তৈরি করতে হয় তা নির্ধারণ করেছেন। এই কার্যপ্রবাহটি একটি চার-পর্যায়ের চক্রের মাধ্যমে প্রতিষ্ঠিত হয়:
- টুলস নির্ধারণ করুন : আপনার মডেল যে ফাংশনগুলো ব্যবহার করতে পারবে, সেগুলো তৈরি করুন এবং আর্গুমেন্ট ও বিবরণ উল্লেখ করুন (যেমন, একটি আবহাওয়া অনুসন্ধান ফাংশন)।
- মডেলের পালা : মডেলটি ব্যবহারকারীর নির্দেশ এবং উপলব্ধ সরঞ্জামগুলির একটি তালিকা গ্রহণ করে এবং সাধারণ টেক্সটের পরিবর্তে একটি কাঠামোগত ফাংশন কল অবজেক্ট ফেরত দেয়।
- ডেভেলপারের পালা : ডেভেলপার রেগুলার এক্সপ্রেশন ব্যবহার করে এই আউটপুটটি পার্স করে ফাংশনের নাম ও আর্গুমেন্টগুলো বের করেন, প্রকৃত পাইথন কোডটি এক্সিকিউট করেন এবং নির্দিষ্ট টুল রোল ব্যবহার করে ফলাফলগুলো চ্যাট হিস্ট্রিতে যুক্ত করেন।
- চূড়ান্ত প্রতিক্রিয়া : মডেলটি টুলটির কার্য সম্পাদনের ফলাফল প্রক্রিয়াজাত করে ব্যবহারকারীর জন্য একটি চূড়ান্ত, স্বাভাবিক ভাষার উত্তর তৈরি করে।
আরও বিস্তারিত জানার জন্য নিম্নলিখিত ডকুমেন্টেশনটি দেখুন।
গুগল কোলাবে চালান
গিটহাবে উৎস দেখুন