اجعل النموذج يستدعي دالة
هذا القسم يفعل شيئًا واحدًا فقط: نعطي النموذج وصفًا لدالة "الجمع"، ونطرح عليه مسألة جمع، ونرى كيف يجيب. بعد الانتهاء ستفهم اللبنة الأساسية في أي Agent.
لنبدأ بتشبيه
أنت المدير، ولديك مساعد بارع في الكلام لكن لا يملك آلة حاسبة. تعطيه ورقة ملاحظات مكتوبًا فيها: "عندما تحتاج إلى حساب جمع، اكتب قسيمة مكتوبًا عليها 'احسب a زائد b' وسلّمها لي، وأنا سأضغط على الآلة الحاسبة نيابة عنك."
لذلك فهو لا يخمّن الإجابة بنفسه، بل يناولك قسومة: "احسب 3829 زائد 9471."
النموذج هو هذا المساعد، واستدعاء الدالة هو تلك القسومة. النموذج نفسه لا ينفّذ أي دالة، بل يقول فقط، وفق الصيغة التي أعطيتها له، "أي دالة أريد استدعاءها وما هي معاملاتها". أما من ينفّذ فعليًا فهو البرنامج الذي كتبته أنت.
الكود
نزّل ملف step1_call.py، أو اكتبه بنفسك:
import json, os
from openai import OpenAI
client = OpenAI(base_url=os.environ.get("AGENT_BASE_URL", "http://localhost:11434/v1"),
api_key=os.environ.get("AGENT_API_KEY", "ollama"))
MODEL = os.environ.get("AGENT_MODEL", "qwen3:8b")
tools = [{
"type": "function",
"function": {
"name": "add",
"description": "计算两个数的和",
"parameters": {
"type": "object",
"properties": {"a": {"type": "number"}, "b": {"type": "number"}},
"required": ["a", "b"],
},
},
}]
resp = client.chat.completions.create(
model=MODEL,
messages=[{"role": "user", "content": "3829 加 9471 等于多少?"}],
tools=tools,
)
msg = resp.choices[0].message
print("finish_reason:", resp.choices[0].finish_reason)
print("content:", msg.content)
for call in msg.tool_calls or []:
print("tool_call:", call.function.name, call.function.arguments)شغّله:
python step1_call.pyالمفترض أن ترى (على جهاز محلي qwen3:8b، خلال 3.7 ثانية):
finish_reason: tool_calls
content:
tool_call: add {"a":3829,"b":9471}فهم هذه الأسطر الثلاثة
finish_reason: tool_calls: توقف النموذج في هذه الجولة لأنه يريد استدعاء أداة، لا لأنه انتهى من كلامه.contentفارغ: لم يجب مباشرة بـ 13300، بل ناولك "القسومة".tool_call: add {"a":3829,"b":9471}: اختار الدالةadd، ومعاملاتها سلسلة JSON. لاحظ أنargumentsهيسلسلة نصية، ويجب تطبيقjson.loadsعليها قبل الاستخدام.
شغّلنا نفس الكود على نموذج GLM السحابي، وكان الناتج متطابقًا، مع فارق وحيد وهو وجود مسافات في JSON: add {"a": 3829, "b": 9471}.
كيف تكتب وصف الدالة
كل عنصر في tools يخبر النموذج بدالة واحدة:
| الحقل | الوظيفة |
|---|---|
name | اسم الدالة. النموذج يستخدم هذا الاسم عند الاستدعاء |
description | ماذا تفعل هذه الدالة. النموذج يعتمد عليها لتحديدمتى يجب استخدامها |
parameters | الـ JSON Schema للمعاملات: ما هي المعاملات وما أنواعها وأيها إلزامي |
جودة كتابة description تحدد مباشرة ما إذا كان النموذج سيستخدمها في الوقت المناسب. كتابتها كـ "حساب مجموع رقمين" أفضل بكثير من كتابتها كـ "الأداة 1".
- 1?
- 2?
- 3?
- 4?
اضغط عليها واحدة تلو الأخرى حسب الترتيب.
اختبر معرفتكعندما يعيد النموذج tool_calls، هل تُنفَّذ الدالة؟
تحقق من نفسك
- حصلت على
finish_reason: tool_callsوعلىtool_callواحد - أستطيع أن أشرح ما الذي يتحكم به كل من
nameوdescriptionوparameters - أعرف أن
argumentsسلسلة نصية، وأن النموذج لا ينفّذ الدوال بنفسه
القسم التالي: كتابة حلقة الـ Agent.