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

دع نماذج المحادثة في Venice تستدعي أدوات ودوال تطبيقك عبر استدعاء الدوال المتوافق مع OpenAI ومخططات الأدوات وواجهة /chat/completions.

يتيح استدعاء الدوال للنموذج اختيار استدعاءات أدوات مُهيكلة يمكن لتطبيقك تنفيذها. لا يشغّل النموذج الدالة بنفسه، بل يُعيد اسم الدالة ومعامِلاتها، ثم يشغّل الكود لديك الدالة، ثم ترسل النتيجة مرة أخرى إلى النموذج.

استخدم استدعاء الدوال عندما يحتاج النموذج إلى بيانات حيّة، أو إجراءات في التطبيق، أو استعلامات قاعدة بيانات، أو حسابات حتمية.

​

تعريف الأداة الأساسي

عرّف الأدوات باستخدام مصفوفة tools المتوافقة مع OpenAI:

Python

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["VENICE_API_KEY"],
    base_url="https://api.venice.ai/api/v1",
)

tools = [
    {
        "type": "function",
        "function": {
            "name": "get_weather",
            "description": "Get the current weather in a location",
            "parameters": {
                "type": "object",
                "properties": {
                    "location": {
                        "type": "string",
                        "description": "City and state, such as San Francisco, CA",
                    }
                },
                "required": ["location"],
            },
        },
    }
]

response = client.chat.completions.create(
    model="zai-org-glm-5",
    messages=[{"role": "user", "content": "What is the weather in San Francisco?"}],
    tools=tools,
)

print(response.choices[0].message.tool_calls)

​

تنفيذ الأداة

عندما يختار النموذج أداة، افحص message.tool_calls، وحلّل المعامِلات، ونفّذ دالة تطبيقك، ثم أرسل النتيجة مرة أخرى بوصفها رسالة tool.

Python

import json

message = response.choices[0].message
tool_call = message.tool_calls[0]
arguments = json.loads(tool_call.function.arguments)

weather = get_weather(arguments["location"])

follow_up = client.chat.completions.create(
    model="zai-org-glm-5",
    messages=[
        {"role": "user", "content": "What is the weather in San Francisco?"},
        message.model_dump(),
        {
            "role": "tool",
            "tool_call_id": tool_call.id,
            "content": json.dumps(weather),
        },
    ],
    tools=tools,
)

print(follow_up.choices[0].message.content)

​

اختيار النموذج

يعتمد دعم استدعاء الدوال على النموذج. استخدم صفحة النماذج النصية أو واجهة برمجة تطبيقات النماذج للعثور على النماذج التي تحمل supportsFunctionCalling.

تعامَل مع معامِلات الأدوات على أنها مدخلات غير موثوقة. تحقّق من صحّة المعامِلات قبل استخدامها في استعلامات قاعدة البيانات، أو أوامر الصدَفة، أو المدفوعات، أو أي عمليات ذات آثار جانبية.

​

خطوة أبعد

يتوقّف المثال أعلاه بعد جولة واحدة ذهابًا وإيابًا. أما الوكلاء الحقيقيون فيواصلون العمل، لأن النموذج عادةً ما يحتاج إلى عدة أدوات قبل أن يتمكّن من الإجابة. يمرّ دليل بناء وكيل يستخدم الأدوات عبر استدعاء الدوال بالحلقة كاملةً في مواجهة قاعدة بيانات لم يرَها النموذج من قبل، بما في ذلك استدعاءات الأدوات المتوازية، وإعادة الأخطاء التي يتعافى منها النموذج، والفرق بين نموذج يرفض من تلقاء نفسه وحماية لا يستطيع تجاوزها.

​

نصائح للتصميم

• اجعل أسماء الأدوات وأوصافها قصيرة وحرفية.
• استخدم JSON Schema لتسهيل إنتاج معامِلات صحيحة من قِبل النموذج.
• فضّل الأدوات الضيّقة ذات المدخلات الواضحة على أداة واحدة عريضة ذات سلوكيات اختيارية كثيرة.
• أعِد نتائج أدوات موجزة بحيث يمتلك الجواب النهائي سياقًا كافيًا دون هدر الرموز.

​

موارد ذات صلة

• بناء وكيل يستخدم الأدوات عبر استدعاء الدوال
• واجهة برمجة تطبيقات Chat Completions
• النماذج النصية
• دليل الاستجابات المُهيكلة
• LangChain