ADK-Rust

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

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

البدء

  • مقدمة - نظرة عامة على ADK-Rust وبنيته ومفاهيمه الأساسية
  • بدء سريع - أنشئ وكيلك الأول وشغّله واختبره في واجهة المستخدم المضمّنة خلال أقل من 5 دقائق
  • بدء سريع لـ A2UI - أصدِر A2UI بصيغة JSONL واعرضه في React
  • الترحيل من 1.0 ← 2.0 - قائمة كاملة بالتغييرات غير المتوافقة مع توضيح الشيفرة قبل التغيير وبعده

النواة

  • الأنواع الأساسية - الأنواع الأساسية: Content وPart وسمة Agent وسمة Tool والسياقات
  • المشغّل - بيئة تشغيل الوكلاء وإعداداتها
  • الإضافات - خطافات دورة الحياة لاعتراض الأدوات والنماذج والبرمجيات الوسيطة

النماذج

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

الوكلاء

وكيل البرمجة

وكيل برمجة أصلي: قراءة التعليمات البرمجية وتحريرها وتشغيلها في مساحة عمل معزولة، ووضع الأهداف المستقل، وسير عمل المراجعة فائقة الجودة المتوازي.

  • نظرة عامة - ابدأ من هنا: المكوّنات، والتثبيت، والبدء السريع خلال 60 ثانية
  • أدوات التطوير - adk-devtools: القراءة/الكتابة/التحرير/glob/grep/bash + Workspace المعزول
  • الهيكل التنفيذي - CodingAgent (ميزة coding)، وحلقة التخطيط، وwrite_todos
  • CLI - adk-rust code / goal (متين، قابل للاستئناف) / ultracode
  • سير العمل - المراجعة فائقة الجودة على adk-graph: مراجعون متوازون + تجميع المدخلات
  • أمثلة - حزم الأمثلة الثلاثة القابلة للتشغيل

الآني ومتعدد الوسائط

دليل مخصص وسهل للمبتدئين لبناء وكلاء صوتيين ومتعددي الوسائط — يتناول البنية والمفاهيم والأمثلة القابلة للتشغيل.

  • نظرة عامة - ابدأ من هنا: النموذج الذهني، والتثبيت، والبدء السريع خلال 60 ثانية
  • البنية - الطبقات الأربع، وحلقة الأحداث، ومسار الصوت، ودورة حياة الدور
  • المزوّدون - نماذج OpenAI Realtime وGemini Live، والأصوات، وكيفية الاختيار
  • الأدوات - الإجراءات من جانب الخادم: المعالجات الأصلية، وadk_core::Tools الموصولة، والاستدعاءات المتوازية
  • متعدد الوسائط - إدخال الفيديو عبر send_video_frame والتقاط الكاميرا في المتصفح
  • الحوار العاطفي - استجابات واعية بالعواطف على Gemini native-audio
  • الذاكرة - حقن السياق، وتخزين الأدوار، والتنظيم الذاتي لرسم المعرفة
  • بناء تطبيقات الويب - الجسر من جانب الخادم، وبروتوكول WS، وWeb Audio
  • أمثلة - الأمثلة الأربعة القابلة للتشغيل ومسار التعلم المقترح

الأدوات

بروتوكول عميل الوكيل

استخدم وكيل برمجة خارجيًا من ADK-Rust، أو اعرض وكيل ADK-Rust على محرر من خلال ACP المستقر v1.

  • البنية والمفاهيم - أدوار العميل/المضيف ووكيل البرمجة، والجلسات، والإمكانات، وتدفق البروتوكول
  • عميل ومضيف ACP - التفويض، والجلسات المستمرة، والبث، والإلغاء، والأذونات، والملفات، والمحطات الطرفية، وMCP
  • خادم الوكيل ACP - إتاحة Runner والأدوات والجلسات والأحداث المباشرة عبر stdio
  • مصفوفة الاختبار والدعم - قابلية التشغيل البيني التي تم التحقق منها والميزات غير المُعلنة عمدًا

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

الذاكرة

ذاكرة طويلة الأمد تتجاوز عمر الجلسة — النظير المستمر لحالة الجلسة. دليل مخصص وسهل للمبتدئين حول كلٍّ من المخزن الدلالي والرسم البياني للمعرفة ثنائي الزمن.

  • نظرة عامة - ابدأ من هنا: نوعا الذاكرة، والنموذج الذهني، والتثبيت، والبدء السريع
  • المفاهيم - MemoryEntry، وواجهة MemoryService، والبحث، وتحديد نطاق المشروع، ومحو البيانات وفقًا للائحة GDPR
  • الواجهات الخلفية - المخازن الستة (InMemory وSQLite وPostgres+pgvector وRedis وMongoDB وNeo4j) وكيفية الاختيار بينها
  • الرسم البياني للمعرفة - GraphMemoryService: الكيانات، والملاحظات، والعلاقات، وسبب أهمية العامل ثنائي الزمن
  • الأدوات والوكلاء - ربط الذاكرة بالوكلاء؛ remember/relate وأدوات الذاكرة

الاستدعاءات والأحداث

المصنوعات

قابلية الرصد

النشر

التقييم

الوكلاء المُدارون

الأمان

الامتثال

  • عمليات النشر عبر Vertex فقط - ضمان عدم مرور أي حركة مرور من Gemini Studio (generativelanguage.googleapis.com) لأحمال العمل الخاصة بـ HIPAA وموقع البيانات

الاستوديو

التطوير

حالة التحقق

تتحقق scripts/check-doc-examples.sh من أوامر Cargo ومقتطفات التبعيات التي يمكن نسخها ولصقها في README والوثائق الرسمية. كما تتحقق CI من هياكل cargo-adk باستخدام scripts/check-cargo-adk-templates.sh، وترفض أسماء أهداف الأمثلة المكررة باستخدام scripts/check-example-name-collisions.sh، وتُجمّع أمثلة مساحة العمل باستخدام cargo check --workspace --examples.