ADK-Rust

أمثلة على وكلاء البرمجة

ثلاثة أمثلة قابلة للتشغيل في examples/، كل منها وكيل حقيقي (بدون محاكاة) يقوم بالعمل ثم يتحقق بشكل مستقل من النتيجة عن طريق تشغيل الكود المنتج. جميعها تستخدم نموذج Gemini 3 افتراضيًا؛ قم بتعيين مفتاح أولاً:

export GOOGLE_API_KEY=…          # or GEMINI_API_KEY
# or: CODING_PROVIDER=openai OPENAI_API_KEY=…

coding_agent

النظام قيد العمل، بأربعة أوضاع:

# Multi-language demo (Rust, Python, JavaScript) in a temp workspace:
cargo run --manifest-path examples/coding_agent/Cargo.toml

# Build a medium program over a persistent multi-turn session:
cargo run --manifest-path examples/coding_agent/Cargo.toml -- multiturn

# Scenario tour — increasing complexity, each independently verified:
cargo run --manifest-path examples/coding_agent/Cargo.toml -- tour

# A single task in your own directory:
cargo run --manifest-path examples/coding_agent/Cargo.toml -- ./some/dir "make tests pass"
  • demo — مهام أحادية اللقطة عبر اللغات (يكتب ويشغل rustc/python3/node).
  • tour — خمسة سيناريوهات ذات تعقيد متزايد (hello ← multifile ← fixtest ← debug ← refactor)، كل منها يتم التحقق منه ذاتيًا بملخص PASS/FAIL.
  • multiturn — وكيل/مشغل/جلسة واحدة تنمي todo CLI بلغة Python على مدار خمس جولات (إضافة/قائمة ← تم ← إزالة ← أخطاء قوية ← اختبارات)، بناءً على عملها السابق؛ يتم التحقق من ذلك عن طريق تشغيل مجموعة الاختبارات الخاصة بها.

اقرأها من أجل: نظام CodingAgent، حلقة plan→act→observe، الاحتفاظ بالسياق متعدد الجولات.

coding_graph

سير عمل المراجعة الفائقة workflow كـ adk-graph StateGraph: تنفيذ ← مراجعو صحة/حالات حافة/نمط متوازيون ← توليف (تجميع مؤجل) ← حلقة مراجعة ← إنهاء.

cargo run --manifest-path examples/coding_graph/Cargo.toml

اقرأها من أجل: الوكلاء المتوازيين في خطوة واحدة فائقة، تجميع add_deferred_node_fn، التوجيه الدوري الشرطي. يتم التحقق من ذلك عن طريق استيراد الدالة المنتجة والتأكيد على المواصفات + حالات الحافة.

coding_goal

وضع /goal المستقل مع حفظ نقاط التحقق الدائم: يزرع وحدة بها أخطاء + اختبار فاشل، يكرر plan→act→verify حتى ينجح python3 test_stats.py، يطبع نقطة التحقق المستمرة، ثم يوضح الاستئناف (الهدف المكتمل لا يقوم بأي عملية).

cargo run --manifest-path examples/coding_goal/Cargo.toml

اقرأها من أجل: حلقة الهدف المقيدة بالمدقق، حفظ نقاط التحقق لحالة الهدف الذرية، والاستئناف بعد إعادة التشغيل.

streaming_bash

واجهة مستخدم ويب (Axum + WebSocket) تعرض نشاط أداة LlmAgent مباشرة من EventStream واحد: بث bash stdout/stderr بالإضافة إلى نتائج read_file / grep / glob أحادية اللقطة، كل منها كبطاقة خاصة به.

cargo run --manifest-path examples/streaming_bash/Cargo.toml      # web UI
cargo run --manifest-path examples/streaming_bash/Cargo.toml -- cli

اقرأها من أجل: بث ToolContext::emit_progress، و وصول Event::tool_calls() / Event::tool_results() / event.tool_progress_stream() من الدرجة الأولى التي تسمح لواجهة المستخدم بعرض مخرجات أي أداة بشكل عام. انظر Streaming Tool Progress.

مسار مقترح

  1. coding_agent (tour) — شاهد النظام يحل مهامًا ذات تعقيد متزايد.
  2. coding_agent (multiturn) — راقبه وهو يبني برنامجًا على مدار جلسة.
  3. coding_goal — وضع هدف مستقل، مقيد بالمدقق، ودائم.
  4. coding_graph — تنسيق المراجعة الفائقة المتوازية.

تقوم CLI (code / goal / ultracode) بتجميع هذه الأنماط كأوامر من الدرجة الأولى.

← العودة إلى نظرة عامة على وكيل البرمجة