وثائق ADK-Rust الرسمية

مرحباً بك في الوثائق الرسمية لـ ADK-Rust (مجموعة تطوير العملاء لـ Rust). توفر هذه الوثائق أدلة ومراجع شاملة لبناء عملاء الذكاء الاصطناعي باستخدام تطبيق Rust لإطار عمل ADK.

البدء

• مقدمة - نظرة عامة على ADK-Rust، وهيكله، ومفاهيمه الرئيسية
• البدء السريع - ابنِ عميلك الأول في أقل من 10 دقائق

الأساس

• أنواع أساسية - أنواع جوهرية: Content, Part, Agent trait, Tool trait, contexts
• Runner - وقت تشغيل Agent وتكوينه

النماذج

• موفرو النماذج - تكاملات LLM: Gemini, OpenAI, Anthropic, DeepSeek, Groq, Ollama
• Ollama - الاستدلال المحلي مع Ollama
• تكامل mistral.rs - mistral.rs الأصلي للاستدلال المحلي عالي الأداء

العملاء

• LlmAgent - نوع العميل الأساسي الذي يستخدم نماذج اللغات الكبيرة
• عملاء سير العمل - عملاء حتميون: Sequential, Parallel, Loop
• أنظمة متعددة العملاء - بناء تسلسلات هرمية للعملاء باستخدام عملاء فرعيين
• عملاء الرسم البياني - تنظيم سير العمل على غرار LangGraph
• عملاء الوقت الفعلي - عملاء مدعمون بالصوت مع OpenAI/Gemini

الأدوات

• أدوات الوظائف - إنشاء أدوات مخصصة باستخدام دوال async Rust
• أدوات مدمجة - أدوات جاهزة مثل GoogleSearchTool
• أدوات MCP - تكامل بروتوكول سياق النموذج
• أدوات المتصفح - 46 أداة WebDriver لأتمتة الويب
• أدوات واجهة المستخدم - توليد واجهة مستخدم ديناميكية باستخدام النماذج والبطاقات والمخططات

الجلسات والحالة

• Sessions - إدارة ودورة حياة Session
• إدارة الحالة - إدارة حالة المحادثة باستخدام البادئات

ردود الاتصال والأحداث

• ردود الاتصال - اعتراض وتخصيص سلوك العميل
• الأحداث - فهم نظام الأحداث وسجل المحادثة

البيانات الاصطناعية

• البيانات الاصطناعية - تخزين واسترجاع البيانات الثنائية

قابلية الملاحظة

• القياس عن بعد - التسجيل، التتبع، والمراقبة

النشر

• المُشغّل - تشغيل العملاء في وضع وحدة التحكم أو الخادم
• الخادم - تكامل REST API وواجهة المستخدم للويب
• بروتوكول A2A - اتصال العميل بالعميل

التقييم

• تقييم العميل - اختبار سلوك العميل والتحقق منه

الأمان

• التحكم في الوصول - أذونات قائمة على الأدوار وتسجيل التدقيق
• حواجز الحماية - إخفاء معلومات PII، تصفية المحتوى، التحقق من صحة المخطط
• الذاكرة - ذاكرة دلالية طويلة المدى للعملاء

الاستوديو

• ADK Studio - بيئة تطوير مرئية لبناء العملاء

التطوير

• إرشادات التطوير - دليل المساهمة وأفضل الممارسات

---

حالة التحقق

جميع أمثلة التعليمات البرمجية في هذه الوثائق تم التحقق منها من خلال أمثلة عملية في حزم official_docs_examples/. تحتوي كل صفحة توثيق على أمثلة مقابلة تُترجم وتُنفذ بنجاح.