ADK-Rust

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

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

البدء

النواة

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

النماذج

الوكلاء

وكيل البرمجة

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

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

الوقت الحقيقي ومتعدد الوسائط

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

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

الأدوات

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

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

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

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

الذاكرة

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

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

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

المخرجات

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

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

النشر

التقييم

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

الأمان

الاستوديو

التطوير

حالة التحقق

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