Skip to content

اجعل النموذج يستدعي دالة ​

هذا القسم يفعل شيئًا واحدًا فقط: نعطي النموذج وصفًا لدالة "الجمع"، ونطرح عليه مسألة جمع، ونرى كيف يجيب. بعد الانتهاء ستفهم اللبنة الأساسية في أي Agent.

لنبدأ بتشبيه ​

أنت المدير، ولديك مساعد بارع في الكلام لكن لا يملك آلة حاسبة. تعطيه ورقة ملاحظات مكتوبًا فيها: "عندما تحتاج إلى حساب جمع، اكتب قسيمة مكتوبًا عليها 'احسب a زائد b' وسلّمها لي، وأنا سأضغط على الآلة الحاسبة نيابة عنك."

لذلك فهو لا يخمّن الإجابة بنفسه، بل يناولك قسومة: "احسب 3829 زائد 9471."

النموذج هو هذا المساعد، واستدعاء الدالة هو تلك القسومة. النموذج نفسه لا ينفّذ أي دالة، بل يقول فقط، وفق الصيغة التي أعطيتها له، "أي دالة أريد استدعاءها وما هي معاملاتها". أما من ينفّذ فعليًا فهو البرنامج الذي كتبته أنت.

الكود ​

نزّل ملف step1_call.py، أو اكتبه بنفسك:

python
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)

شغّله:

bash
python step1_call.py

المفترض أن ترى (على جهاز محلي qwen3:8b، خلال 3.7 ثانية):

text
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. 1?
  2. 2?
  3. 3?
  4. 4?

اضغط عليها واحدة تلو الأخرى حسب الترتيب.

اختبر معرفتكعندما يعيد النموذج tool_calls، هل تُنفَّذ الدالة؟

تحقق من نفسك ​

  • حصلت على finish_reason: tool_calls وعلى tool_call واحد
  • أستطيع أن أشرح ما الذي يتحكم به كل من name و description و parameters
  • أعرف أن arguments سلسلة نصية، وأن النموذج لا ينفّذ الدوال بنفسه

القسم التالي: كتابة حلقة الـ Agent.

gaodong.aiAboutPrivacyContact

Independent tutorials, not affiliated with any product mentioned. Product names and trademarks belong to their owners. Check official pages for prices and policies.