يوفر نظام التتبّع في OpenAI Agents SDK رؤية واضحة لسير عمل الذكاء الاصطناعي، حيث يلتقط الأحداث المهمة لمساعدة المطورين على مراقبة تطبيقاتهم وتصحيح أخطائها بفعالية.
ما هو OpenAI Agents SDK؟
OpenAI Agents SDK عبارة عن مجموعة أدوات بلغة Python تبسّط تطوير وكلاء الذكاء الاصطناعي. يوفر هذا التطور الجاهز للإنتاج من مشروع SWARM من OpenAI ميزات لبناء أنظمة ذكاء اصطناعي تعاونية وآمنة. في جوهره، يعتمد على وكلاء قائمين على نماذج LLM يمكن تهيئتهم بتعليمات وأدوات محددة، مع دعم الأدوار المخصصة والتوافق مع نماذج OpenAI (o1, o3-mini, gpt-4o) ونماذج الطرف الثالث المتوافقة مع واجهات برمجة تطبيقات OpenAI.
الميزات الرئيسية لـ OpenAI Agents SDK
الأدوات والإضافات الوظيفية:
- استدعاء الدوال: تحويل دوال Python إلى أدوات باستخدام مصمم
@function_tool، مع إنشاء تلقائي للمخططات والتحقق عبر Pydantic. - حلقة الوكيل المدمجة: معالجة استدعاءات الأدوات، وردود النتائج، وحلقات المهام لضمان تفاعل سلس بين الوكلاء ونماذج LLM.
- تسليم المهام: السماح للوكلاء بتفويض المهام إلى وكلاء متخصصين آخرين، مما يتيح التعاون بين عدة وكلاء.
آليات الأمان والمراقبة:
- الحواجز الوقائية: فحص المدخلات يمنع المحتوى الضار، بينما يضمن التحقق من المخرجات جودة الاستجابات وملاءمتها.
- أدوات التتبّع: وظيفة التتبّع المدمجة تعرض وتراقب تدفق الوكيل بالكامل، مما يساعد في تصحيح الأخطاء وتحسين الأداء.
ميزات سهلة للمطورين:
- طرق أصلية في Python: الاستفادة من مزايا لغة Python لتنسيق الوكلاء وربطهم، مما يقلل الحاجة لتعلم تجريدات جديدة.
- قابلية تخصيص عالية: توفير أدوات مخصصة، وأنواع مخرجات منظمة، وقدرات تكامل مع مزودي LLM خارجيين.
- تصميم خفيف: مجموعة بدائية بسيطة لكنها قوية تتطلب منحنى تعلم بسيطًا.
فوائد OpenAI Agents SDK
كفاءة التطوير
- يبسّط عمليات الإعداد، ويحسّن تطوير تطبيقات الوكلاء، ويخفض حاجز الدخول لتطوير وكلاء الذكاء الاصطناعي.
إمكانات نظام محسّنة:
- يدعم تنفيذ المهام المعقدة والتعاون الفعّال بين عدة وكلاء.
- ينشئ أنظمة تعاونية متخصصة لحل المشكلات المعقدة.
- يدمج نماذج LLM خارجية لمرونة أكبر.
الأمان والموثوقية:
- تضمن الحواجز الوقائية تفاعلات آمنة للذكاء الاصطناعي.
- يعزز موثوقية أنظمة وكلاء الذكاء الاصطناعي وسلوكها المناسب.
- يبسّط تجهيز تطبيقات وكلاء الذكاء الاصطناعي لبيئات الإنتاج.
التحليل والتحسين:
- يوفر نظام التتبّع رؤى حول سلوك الوكيل.
- يحسّن تحليل أنماط المستخدمين وتحديد الاختناقات.
- يعزز قدرات تصحيح الأخطاء وتحسين سير العمل.
مثال على OpenAI Agents SDK
الخطوة 1: إعداد الوكيل
قم بتهيئة الوكيل عن طريق إنشاء مساعد افتراضي باسم AccountingAssistant مع تعليمات واضحة لوظائفه.
الخطوة 2: دمج الأدوات
دمج الأدوات الأساسية، بما في ذلك:
- أداة البحث في الويب: استرجاع تحديثات الضرائب.
- استدعاءات API: تحليل البيانات المالية.
- أداة البحث في الملفات: تحديد موقع المستندات ذات الصلة.
الخطوة 3: تحديد المهام
تقسيم سير العمل إلى مهام محددة:
- المهمة 1: استرجاع أحدث تحديثات الضرائب.
- المهمة 2: تحليل البيانات المالية باستخدام API.
- المهمة 3: إنشاء تقارير بناءً على أحدث البيانات.
الخطوة 4: تنفيذ المهام
نفّذ المهام بشكل تسلسلي أو بالتوازي. على سبيل المثال:
Runner.run_sync(agent, "Generate a report based on the latest tax laws and financial data.")
الخطوة 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. مثال على تسليم المهام
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")
# Because Novita not support the responses API so we use the chat completions API instead.
set_default_openai_api("chat_completions")
set_default_openai_client(AsyncOpenAI(base_url=BASE_URL, api_key=API_KEY))
# Disable tracing for this example
# Refer to https://openai.github.io/openai-agents-python/tracing/#external-tracing-processors-list to use the custom spans.
set_tracing_disabled(disabled=True)
agent = Agent(name="Assistant",
instructions="You are a helpful assistant", model=MODEL_NAME)
result = Runner.run_sync(
agent, "Write a haiku about recursion in programming.")
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 موثوقة وبأسعار معقولة للبناء والتوسع.
