> ## Documentation Index
> Fetch the complete documentation index at: https://phaseo.app/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# نظرة عامة على Agent SDK

> أنشئ حلقات وكلاء محلية قابلة للاستئناف باستخدام Phaseo Gateway وبلغات Agent SDK المدعومة.

استخدم Agent SDK من Phaseo عندما يحتاج تطبيقك إلى أكثر من عملية إنشاء واحدة:

* حلقات أدوات متعددة الخطوات
* أدوات وقت تشغيل محلية
* أدوار نماذج عبر Gateway
* حالة تشغيل قابلة للاستئناف يديرها التطبيق
* الموافقة على استدعاءات محددة، وأدوات بمشاركة بشرية، وأدوات يدوية، ومتابعة قابلة للاستئناف
* التحقق وقت التشغيل، وأدوات تعرض التقدم، وأخطاء أدوات قابلة للاستعادة
* بث مخرجات النماذج مع مستهلكي أحداث يمكن إعادة تشغيلها
* إعداد ديناميكي للأدوار، وشروط إيقاف قابلة للتركيب، واستخدام/تكلفة موحدان
* إعادة محاولات النماذج، ومهل الأدوات، وتزامن أدوات محدود، وأحداث دورة الحياة
* التقاط محلي باستخدام Phaseo Devtools
* توجيه متسق للطلبات باللغات نفسها التي تدعمها SDKs العميل الأساسية

## اللغات المدعومة

تطابق مجموعة لغات Agent SDK الحالية مجموعة SDKs العميل الأساسية في البدء السريع لـ Phaseo:

* [TypeScript](../typescript/agent-sdk.mdx)
* [Python](../python/agent-sdk.mdx)
* [Go](../go/agent-sdk.mdx)
* [C#](../csharp/agent-sdk.mdx)
* [PHP](../php/agent-sdk.mdx)
* [Ruby](../ruby/agent-sdk.mdx)
* [Rust](../rust/agent-sdk.mdx)

## النموذج المشترك

تحافظ كل Agent SDK على نموذج وقت التشغيل نفسه:

* تعريف وكيل واحد
* تعريف صفر أو أكثر من الأدوات المحلية
* إنشاء عميل نموذج متصل بـ Gateway
* تشغيل حلقة محدودة فوق واجهة API `responses`
* فحص أحداث دورة الحياة أو أثر Devtools
* حفظ التشغيل الناتج واستئنافه بعد اتخاذ شخص قرارًا

TypeScript هو التصميم المرجعي لواجهة API. وتوفّر Python وGo وC# وPHP وRuby العقد الأوسع بين اللغات باستخدام callbacks وبدائيات أصلية للغة للتزامن والمهل والإلغاء. أما Rust فهو وقت تشغيل متزامن مدعوم، ويتضمن أدوات محلية وخارجية، وموافقات بمعرّف دقيق، ومراجعة بشرية، وإعادة محاولات النماذج، وحالة تشغيل قابلة للتسلسل، وcallbacks لدورة الحياة، وتجميع الاستخدام. ولا يزال Java وC++ قيد التطوير.

<Note>
  يُنشر Rust Agent SDK باسم `phaseo-agent`. ولا يتضمن بعد البث أو التنفيذ غير المتزامن أو الأدوات المحلية المتزامنة أو التحقق من المخططات وقت التشغيل أو التقاط Devtools.
</Note>

## عقد الإمكانات بين اللغات

| الإمكانية | TypeScript | Python | Go | C# | PHP | Ruby | Rust |
| - | - | - | - | - | - | - | - |
| أدوات قابلة للتنفيذ وأخطاء أدوات قابلة للاستعادة | نعم | نعم | نعم | نعم | نعم | نعم | متزامن |
| موافقات بالمعرّف الدقيق وHITL ومخرجات يدوية | نعم | نعم | نعم | نعم | نعم | نعم | نعم |
| تقدم أولي للأدوات | مولّد غير متزامن | مكرّر أو callback | callback | callback | callback | callback | غير متاح بعد |
| بث النماذج ومستهلكون قابلون لإعادة التشغيل | قابل للتكرار غير المتزامن | مكرّر | قناة | قابل للعد غير المتزامن | قابل للتكرار | معدّد | غير متاح بعد |
| شروط إيقاف قابلة للتركيب | نعم | نعم | نعم | نعم | نعم | نعم | حد للخطوات |
| أدوار ديناميكية وسياق قابل للتغيير | نعم | نعم | نعم | نعم | نعم | نعم | نموذج وحد خطوات وسياق لكل تشغيل |
| حالة تشغيل محفوظة يديرها التطبيق | نعم | نعم | نعم | نعم | نعم | نعم | `RunResult` قابل للتسلسل |
| استخدام وتكلفة موحدان | نعم | نعم | نعم | نعم | نعم | نعم | رموز؛ تكلفة العميل المخصص في `0.1` فقط |

تعرض PHP وRuby أحداث بث المزوّد من خلال واجهات التكرار المتزامن المعتادة. ولا تحتاجان إلى وقت تشغيل مستضاف أو خدمة خلفية من Phaseo.

## Client SDK وAgent SDK وواجهة API

| الاستخدام | اختر | ما الذي يديره |
| - | - | - |
| طلب API واحد أو تغطية كاملة لنقاط النهاية | Client SDK | أنواع API المولدة والنقل |
| منطق تطبيق متعدد الخطوات يستخدم الأدوات | Agent SDK | الحلقة المحلية والأدوات ونقاط الحفظ والمراجعة والأحداث وDevtools |
| نقل مخصص أو لغة غير مدعومة | واجهة API مباشرة | معالجة طلب واستجابة HTTP |

تفوض محولات Gateway في Agent SDK أدوار النماذج إلى Client SDK المطابقة. ويمكن للغات التي تدعم hook باسم `requestOptions` أو ما يعادله تمرير حقول إضافية من Responses API، بينما تستمر Agent SDK في إدارة `model` و`input` و`instructions` وأدوات الدوال المحلية. ويرسل محول Rust `0.1` حاليًا حقول الوكيل الموحدة دون hook إضافي لخيارات الطلب.

## وصفات العمل

يتضمن الدليل وصفات TypeScript ونقاط بداية خاصة بكل لغة:

* [أنشئ حلقة وكيل مستمرة](../../cookbook/agent-sdk-durable-loop.mdx)
* [ابحث باستخدام البحث على الويب المدعوم بالوكلاء](../../cookbook/agent-sdk-research-brief.mdx)
* [صنّف طلبات الدعم باستخدام وكلاء تعتمد على الإعدادات المسبقة](../../cookbook/agent-sdk-support-triage.mdx)
* [راجع الشيفرة باستخدام أدوات وقت تشغيل محلية](../../cookbook/agent-sdk-coding-review.mdx)
* [شغّل الأدوات المحلية بالتوازي](../../cookbook/agent-sdk-parallel-tools.mdx)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.