يوفر نظام التتبع في OpenAI Agents SDK رؤية واضحة لسير عمل الذكاء الاصطناعي، حيث يلتقط الأحداث المهمة لمساعدة المطورين على مراقبة تطبيقاتهم وتصحيح أخطائها بفعالية.
ما هو OpenAI Agents SDK؟
OpenAI Agents SDK هي مجموعة أدوات Python تُبسّط تطوير وكلاء الذكاء الاصطناعي. هذا التطور الجاهز للإنتاج من مشروع SWARM التابع لـ OpenAI يوفر ميزات لبناء أنظمة ذكاء اصطناعي تعاونية وآمنة وقابلة للتوسع. في جوهرها، تعتمد على وكلاء يعملون بنماذج لغوية كبيرة (LLMs) قابلة للتكوين بتعليمات وأدوات محددة، مع دعم أدوار مخصصة والتوافق مع نماذج OpenAI (o1, o3-mini, gpt-4o) ونماذج الطرف الثالث التي تستخدم واجهات برمجة تطبيقات متوافقة مع OpenAI.
الميزات الرئيسية لـ OpenAI Agents SDK
الأدوات والإضافات الوظيفية:
- استدعاء الوظائف: تحويل دوال Python إلى أدوات باستخدام المزخرف
@function_tool، مع إنشاء تلقائي للمخططات والتحقق من الصحة باستخدام Pydantic - حلقة الوكيل المدمجة: معالجة استدعاءات الأدوات، وردود النتائج، وحلقات المهام لضمان تفاعل سلس بين الوكلاء والنماذج اللغوية الكبيرة
- تفويض المهام: السماح للوكلاء بتفويض المهام إلى وكلاء متخصصين آخرين، مما يتيح التعاون متعدد الوكلاء
آليات الأمان والمراقبة:
- الحواجز: فحص الإدخال لمنع المحتوى الضار، بينما يضمن التحقق من المخرجات جودة الاستجابات وملاءمتها
- أدوات التتبع: وظيفة تتبع مدمجة تُصور وتراقب تدفق الوكيل بالكامل، مما يساعد في تصحيح الأخطاء وتحسين الأداء
ميزات صديقة للمطورين:
- أساليب Python الأصلية: الاستفادة من ميزات لغة Python في تنسيق الوكلاء وتسلسلهم، مما يقلل الحاجة إلى تعلم تجريدات جديدة
- قابلية تخصيص عالية: توفير أدوات مخصصة، وأنواع مخرجات منظمة، وقدرات دمج موفري نماذج لغوية كبيرة خارجية
- تصميم خفيف: مجموعة بديهية ولكنها قوية من العناصر الأساسية تتطلب منحنى تعلم بسيط
فوائد OpenAI Agents SDK
كفاءة التطوير
- تبسيط عمليات الإعداد، وتسريع تطوير تطبيقات الوكيل، وخفض حاجز الدخول لتطوير وكلاء الذكاء الاصطناعي
تعزيز قدرات النظام:
- دعم تنفيذ المهام المعقدة والتعاون الفعال بين وكلاء متعددين
- إنشاء أنظمة تعاونية متخصصة لحل المشكلات المعقدة
- دمج نماذج لغوية كبيرة خارجية لمزيد من المرونة
الأمان والموثوقية:
- الحواجز تضمن تفاعلات آمنة للذكاء الاصطناعي
- تعزيز موثوقية نظام وكلاء الذكاء الاصطناعي وسلوكه المناسب
- تبسيط إعداد تطبيقات وكلاء الذكاء الاصطناعي لبيئات الإنتاج
التحليل والتحسين:
- نظام التتبع يوفر رؤى حول سلوك الوكيل
- تحسين تحليل أنماط المستخدم وتحديد الاختناقات
- تعزيز قدرات تصحيح الأخطاء وتحسين سير العمل
مثال على استخدام OpenAI Agents SDK
الخطوة 1: إعداد الوكيل
قم بتهيئة الوكيل عن طريق إنشاء مساعد افتراضي باسم AccountingAssistant مع تعليمات واضحة لوظائفه.
الخطوة 2: دمج الأدوات
دمج الأدوات الأساسية، بما في ذلك:
- أداة البحث على الويب: استرداد تحديثات الضرائب.
- استدعاءات API: تحليل البيانات المالية.
- أداة البحث في الملفات: تحديد المستندات ذات الصلة.
الخطوة 3: تحديد المهام
تقسيم سير العمل إلى مهام محددة:
- المهمة 1: استرداد أحدث تحديثات الضرائب.
- المهمة 2: تحليل البيانات المالية باستخدام API.
- المهمة 3: إنشاء تقارير بناءً على أحدث البيانات.
الخطوة 4: تنفيذ المهام
تشغيل المهام بالتسلسل أو بالتوازي. على سبيل المثال:
Runner.run_sync(agent, "إنشاء تقرير بناءً على أحدث قوانين الضرائب والبيانات المالية.")
الخطوة 5: المراقبة وتصحيح الأخطاء
استخدام أدوات التتبع لمراقبة تنفيذ المهام وتحديد المشكلات المحتملة لتصحيح الأخطاء.
كيفية دمج Novita AI مع OpenAI Agents SDK؟
1. إعداد بيئة Python وتثبيت Agents SDK.
python -m venv env
source env/bin/activate
pip install openai-agents
2. إعداد مفتاح Novita API الخاص بك.
الذهاب إلى لوحة التحكم والحصول على أرصدة مجانية
3. مثال على التفويض (Handoffs)
import os
from openai import AsyncOpenAI
from agents import (
Agent,
Runner,
set_default_openai_api,
set_default_openai_client,
set_tracing_disabled,
)
BASE_URL = "https://api.novita.ai/v3/openai"
API_KEY = os.getenv("NOVITA_API_KEY")
MODEL_NAME = os.getenv("MODEL_NAME")
# نظرًا لأن Novita لا تدعم واجهة برمجة التطبيقات responses API، فإننا نستخدم chat completions API بدلاً من ذلك.
set_default_openai_api("chat_completions")
set_default_openai_client(AsyncOpenAI(base_url=BASE_URL, api_key=API_KEY))
# تعطيل التتبع لهذا المثال
# راجع https://openai.github.io/openai-agents-python/tracing/#external-tracing-processors-list لاستخدام النطاقات المخصصة.
set_tracing_disabled(disabled=True)
agent = Agent(name="Assistant",
instructions="أنت مساعد مفيد", model=MODEL_NAME)
result = Runner.run_sync(
agent, "اكتب هايكو حول التكرار في البرمجة.")
print(result.final_output)
# Code within the code,
# Functions calling themselves,
# Infinite loop's dance.
بفضل إمكانيات التتبع المرنة، يمكن للمطورين تتبع سلوك الوكيل من خلال الوظائف المدمجة وعمليات التكامل مع الطرف الثالث، مما يضمن أداءً وموثوقية أفضل.
الأسئلة الشائعة
ما نماذج LLM التي يمكنني استخدامها مع OpenAI Agents SDK؟
متوافق مع نماذج OpenAI (o1, o3-mini, gpt-4o) ونماذج الطرف الثالث ذات واجهات برمجة التطبيقات المتوافقة مع OpenAI مثل Novita AI.
كيف يتعامل OpenAI Agents SDK مع تكامل الأدوات؟
تحويل دوال Python إلى أدوات باستخدام المزخرف @function_tool مع إنشاء تلقائي للمخططات والتحقق من الصحة باستخدام Pydantic.
هل OpenAI Agents SDK مناسب لبيئات الإنتاج؟
نعم، يتضمن ميزات أمان مثل الحواجز، وتتبع شامل، وقدرات مراقبة.
Novita AI هي منصة سحابية للذكاء الاصطناعي تقدم للمطورين طريقة سهلة لنشر نماذج الذكاء الاصطناعي باستخدام واجهة برمجة تطبيقات بسيطة، كما توفر سحابة GPU موثوقة وبأسعار معقولة لبناء النماذج وتوسيع نطاقها.
