ADK-Rust 2.0

إطار عمل Rust لـعالية الأداء، جاهزة للإنتاجوكلاء الذكاء الاصطناعي.

يوفر ADK-Rust الوكلاء المكتوبين والأدوات والحالة الدائمة والوسائط في الوقت الفعلي والبروتوكولات المفتوحة في وقت تشغيل واحد غير متزامن - حتى تتمكن من الانتقال من وكيل مركّز إلى نظام يمكنك تشغيله بثقة.

قم ببناء وكيلك الأول انظر كيف يتناسب وقت التشغيل معًا

ابدأ بوحدة العمل

ما هو وكيل الذكاء الاصطناعي من حيث ADK-Rust؟

الوكيل هو مكون Rust غير متزامن. يتلقى سياق استدعاء، وينفذ العمل باستخدام النماذج أو الأدوات، ويصدر أحداثًا مكتوبة أثناء تقدمه. يستخدم وكلاء LLM وسير العمل ووكلاء الوقت الفعلي ووكلاء الترميز ووكلاء Rust المخصصون هذا العقد المشترك.

ما يجعل ADK-Rust مقنعًا هو أن الوكيل يظل جزءًا من نظام برمجي يمكنك فهمه والتحكم فيه. تتضمن استدعاءات النماذج ومدخلات الأدوات وتغييرات الحالة والموافقات والأحداث المتدفقة عقود Rust واضحة. يمكن أن يدعم وقت التشغيل نفسه مساعدًا مركّزًا، أو سير عمل متين متعدد الوكلاء، أو تجربة صوتية في الوقت الفعلي، أو وكيل يعمل عبر الخدمات - مع الحفاظ على الأداء والتزامن وقابلية النقل والانضباط التشغيلي الذي تتوقعه فرق Rust.

إذا كنت تعرف LangGraph، أو Google ADK، أو OpenAI Agents SDK، أو CrewAI، فسوف تتعرف على الأدوات وعمليات التسليم وسير العمل والذاكرة وحواجز الحماية والتتبع. يجلب ADK-Rust هذه الأفكار إلى وقت تشغيل Rust الأصلي ويربطها بوسائط الوقت الفعلي وتنفيذ التعليمات البرمجية وRAG والمصنوعات والبروتوكولات المفتوحة مثل MCP وA2A وACP وAWP. يعمل الإصدار 2 على توسيع هذا الأساس من خلال الرسم البياني والوقت الفعلي والتشفير ووكلاء CodeAct؛ مخططات الأدوات المدركة للموفر؛ قوالب المشروع القابلة للتركيب و بناء إعلان البضائع; ضوابط الدولة والتشغيل أقوى؛ ومسار أحداث مكتوب ومتسق من استدعاء النموذج الأول إلى الإنتاج.

كيفية قراءة الهندسة المعمارية

اتبع الرسم البياني من اليسار إلى اليمين. يرسل سطح المنتج طلبًا إلى Runner. يقوم Runner بإرفاق حالة الجلسة وسياق الاستدعاء، ثم يستدعي الوكيل المحدد. تدعم النماذج والأدوات والحالة العمل بينما تحمل أحداث محددة الأنواع التقدم والنتائج.

داخل وقت التشغيل

Runner، الوكلاء، أحداث محددة الأنواع، حلقات النموذج/الأداة، الجلسات، عمليات الاسترجاعات، التحويلات، والإلغاء.

عند الحدود

MCP، A2A، ACP، AWP، HTTP، SSE، وعمليات النقل في الوقت الفعلي تربط الأنظمة المنفصلة ومناطق الثقة.

خارج الإطار

تستهلك Studio وUI وPlayground ومستوى التحكم ADK-Rust؛ لا تعمل داخل Runner.

سطح الإطار

القدرات وراء الهندسة المعمارية.

يجمع ADK-Rust دورة حياة الوكيل الكاملة في إطار عمل واحد: إنشاء سلوك الوكيل، وتزويده بالأدوات، والحفاظ على السياق، وتوصيله بأنظمة أخرى، وتشغيله بأمان في الإنتاج. توضح المجموعات أدناه كيف تتلاءم هذه القدرات معًا.

إنشاء عوامل LLM وسير العمل والرسم البياني والوقت الفعلي والترميز؛ تزويدهم بالأدوات محددة الأنواع، MCP، RAG، الذاكرة، الجلسات، والتحف؛ توصيلها من خلال REST، A2A، ACP، وAWP؛ ثم قم بإضافة الترخيص، والدرابزين، والقياس عن بعد، وتقييم الإنتاج.

يؤلف

يؤلف capability

LlmAgent

The main model-driven agent. Give it instructions, an LLM, tools, callbacks, and optional sub-agents; the Runner streams its work as typed events.

قانون

قانون capability

#[tool]

Turns a typed async Rust function into a model-callable tool and derives the argument schema from Rust types.

تذكر

تذكر capability

sessions

Keep conversation events and application state together so a user can continue the same interaction over multiple turns.

الاتصال

الاتصال capability

REST

Exposes familiar HTTP endpoints for clients that send a request and receive a structured response.

تشغيل

تشغيل capability

auth

Establishes who is calling the system through API keys, OAuth, OIDC, SSO, and application identity.

بناء

بناء capability

12 templates

Generate working starting shapes for focused agents, tools, retrieval, APIs, workflows, realtime sessions, and custom logic.

انظر كيف يعمل

اعرض العمل أثناء حدوثه.

يعمل Runner على حل الجلسة، وإنشاء سياق الاستدعاء، وتشغيل الوكيل، وتدفق عمل النموذج والأداة، وتطبيق تغييرات الحالة، واستمرار الأحداث الدائمة، وإرجاع التقدم إلى المتصل فور حدوثه.

يمكن لهذا المسار نفسه تغذية محطة طرفية أو واجهة مستخدم ويب أو عميل API أو تقييم أو محادثة في الوقت الفعلي.

اتبع الطلب الحقيقي

يسأل أحد العملاء: "لماذا فشلت دفعتي؟" يفتح Runner الجلسة الصحيحة، ويتدفق مخرجات النموذج ونشاط الأداة، ويسجل تغييرات الحالة، ويعيد كل حدث مفيد إلى الواجهة. يرى المستخدم التقدم بينما يحصل المشغل على سجل تنفيذ كامل.

يؤلف السلوك

عندما يكبر العمل، قم بتقسيم العمل دون فقدان الخيط.

دراسة الأنماط المتعددة الوكلاء

يحدد جهاز التوجيه العمل الذي يجب القيام به. يتعامل المتخصصون مع الأجزاء التي يفهمونها بشكل أفضل. تتحكم مسارات العمل التسلسلية والمتوازية في ترتيب التنفيذ، بينما تحتفظ نقاط فحص الرسم البياني بالأدلة والموافقات والتقدم المرتبط بنفس الوظيفة.

لا يطلب الرسم البياني من وكيل واحد أن يرتجل كل شيء. يعمل التوجيه على تضييق المشكلة، ويقوم المتخصصون بالتحقيق بشكل متزامن، وتحافظ الحالة المشتركة على تماسك أدلةهم، ويظل الإجراء التبعي وراء حدود الموافقة الصريحة.

LlmAgent

الاستدلال المركز

النموذج والتعليمات والأدوات وعمليات الاسترجاعات والمخرجات المتدفقة - المركز الصغير والمفيد لمعظم الأنظمة.

Sequential · Parallel · Loop

العمل الحتمي

التعبير عن شروط الطلب والتزامن والتكرار والخروج مباشرة في برنامج Rust.

GraphAgent

تنسيق دائم

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

CodingAgent · CodeActAgent

البرمجيات كإجراء

اسمح للوكيل بفحص التعليمات البرمجية وتحريرها وتشغيلها داخل مساحة العمل وحدود صندوق الحماية الذي تتحكم فيه.

RealtimeAgent

محادثة حية

احمل الصوت والنصوص وإطارات الفيديو والانقطاعات والأدوات من جانب الخادم من خلال جلسة مباشرة واحدة.

CustomAgent

منطق وقت التشغيل الخاص بك

قم بتنفيذ عقد الوكيل للسلوك الخاص بالمنتج المكتوب مباشرة في Rust.

النظام حول الوكيل

النموذج هو جزء واحد من المنتج.

يحتاج الوكلاء المفيدون إلى الأدوات والحالة والواجهات والحدود والأدلة. يعرض ADK-Rust كل قطعة من خلال واجهات Rust القابلة للتركيب والتي تمتلكها.

منتج واحد ومسؤوليات متعددة

في منتج دعم العملاء، يقوم النموذج بصياغة الاستجابة، وتقوم الأدوات بفحص الطلب، وتحمل الجلسة سياق العميل، ويتحكم التفويض في المبالغ المستردة، وتخزن قطعة أثرية الإيصال، ويسجل القياس عن بعد النتيجة. تظل كل مسؤولية مرئية في وقت التشغيل.

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

نماذج

تغيير النموذج دون إعادة تصميم الوكيل.

النماذج الحدودية المستضافة، ونماذج التوجيه السريع، وOllama المحلية، واستدلال Mistral.rs الأصلي تكمن وراء عقد Llm مشترك.

Gemini · OpenAI · Anthropic · OpenRouter · DeepSeek · Groq · Ollama · Bedrock · Azure AI · نقاط النهاية المتوافقة

أدوات

تستخدم الأدوات عقودًا واضحة وقابلة للفحص.

قم بتحويل وظيفة Rust المكتوبة، أو خادم MCP، أو المهارة، أو جلسة المتصفح، أو وكيل الترميز، أو عملية وضع الحماية إلى قدرة يمكن لوقت التشغيل فحصها واستدعاءها.

#[tool] · FunctionTool · MCP · ACP · المهارات · المتصفح · الكود

الدولة

حافظ على المحادثة والعمل الذي أنتجته.

جلسات تحمل تاريخ الحدث. الذاكرة تستعيد المعرفة المفيدة. القطع الأثرية تحافظ على الملفات. تجعل نقاط فحص الرسم البياني العمل الطويل قابلاً للاستئناف.

SQLite · PostgreSQL · Redis · MongoDB · Firestore · Neo4j · الجلسات المشفرة

الوقت الحقيقي

الوكيل المباشر هو أكثر من مجرد نقطة نهاية للكلام.

يحتفظ ADK-Rust بالصوت والنصوص وإطارات الفيديو واستدعاءات الأدوات والانقطاع وتغيير السياق داخل الجلسة المملوكة لـ Rust.

OpenAI Realtime · Gemini Live · Vertex Live · LiveKit · WebRTC اختياري

المعرفة

جلب الاسترجاع إلى نفس مسار التنفيذ.

قم بتجميع المستندات وتضمينها والبحث في مخازن المتجهات وإعادة ترتيب النتائج وعزل الذاكرة حسب المشروع قبل إجابات النموذج.

خطوط أنابيب RAG · الذاكرة الدلالية · الرسم البياني للمعرفة · خمسة تطبيقات مخزن المتجهات

السيطرة

ضع الموافقة حيث يحدث الإجراء.

يشكل التفويض وعمليات الاسترجاعات وحواجز الحماية وملفات تعريف وضع الحماية والإلغاء والقياس عن بعد والتقييم حدود تنفيذ الإنتاج.

RBAC · OAuth/OIDC · تأكيد الأداة · حواجز حماية PII · القياس المفتوح · التقييم

اختر الحدود

استخدم البروتوكول الذي يطابق المسافة.

ابدأ بالمكان الذي تعمل فيه القدرة.

احتفظ بالوكلاء الفرعيين داخل وقت تشغيل ADK-Rust واحد عندما يشاركون النشر والحالة والثقة. قدِّم بروتوكولًا عندما يكون للقدرة أو الوكيل أو مساحة عمل الترميز أو موقع الويب حدود نشر أو عملية أو ملكية أو ثقة خاصة بها.

نفس عملية Rust

وكيل أو وكيل فرعي أو أداة

الأدوات أو الموارد الخارجية

MCP

وكيل منتشر بشكل مستقل

A2A

عملية الترميز أو IDE

ACP

موقع ويب يمكن قراءته بواسطة الوكيل

AWP

MCP

بروتوكول السياق النموذجي

منح الوكيل إمكانيات تعيش في مكان آخر.

What is MCP?

طريقة قياسية لخادم خارجي لنشر الأدوات التي يمكن للوكيل الاتصال بها والموارد التي يمكنه قراءتها.

Why use this protocol?: أنت تتجنب كتابة محول مخصص لكل قاعدة بيانات أو منتج SaaS أو نظام ملفات أو مصدر معرفة - ويمكن للخادم نفسه أن يخدم أكثر من وكيل واحد.
How does ADK-Rust use MCP?: يقوم McpToolset بتوصيل الخادم بعقد أداة ADK-Rust. يكتشف وقت التشغيل مخططاته، ويقوم بتطبيعها لموفر النموذج المحدد، ويمكنه قراءة موارد MCP أو إدارة عمليات خادم MCP المحلية.
When should I choose MCP?: استخدم MCP عندما تنتمي الإمكانية إلى عملية منفصلة، أو تحتوي بالفعل على خادم MCP، أو يجب مشاركتها عبر العديد من الوكلاء والتطبيقات.
What connects through MCP?: The other side is an MCP server: for example a database gateway, business API, document store, developer tool, or internal service.

Explore MCP in ADK-Rust

A2A

بروتوكول وكيل إلى وكيل

دع العملاء المنتشرين بشكل مستقل يعملون معًا.

What is A2A?

بروتوكول شبكة لاكتشاف وكيل بعيد وإرساله للعمل ومتابعة التقدم وتلقي النتائج عبر حدود HTTP.

Why use this protocol?: يمكن للمتخصص الاحتفاظ بنموذجه وأدواته وحالته ودورة الإصدار والنشر وحدود الأمان الخاصة به.
How does ADK-Rust use A2A?: يمكن لـ ADK-Rust الكشف عن وكيل من خلال خادم A2A v1 وعمليات المهام. يمكن للمنسق بعد ذلك التعامل مع هذه الخدمة عن بعد كمتخصص بينما تحافظ الأحداث المتدفقة على تقدم المهمة.
When should I choose A2A?: استخدم A2A عندما يتم نشر الوكيل أو توسيع نطاقه أو امتلاكه أو تأمينه بشكل منفصل. احتفظ بالوكلاء الفرعيين العاديين قيد التشغيل في حالة عدم وجود أي من هذه الحدود.
What connects through A2A?: The other side is another agent service—perhaps a research specialist, finance agent, partner agent, or a system owned by another team.

Explore A2A in ADK-Rust

ACP

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

تفويض العمل البرمجي إلى وكيل ترميز حقيقي.

What is ACP?

بروتوكول يعمل على توحيد الجلسات بين وكلاء التشفير والعملاء الذين يستضيفونهم، بما في ذلك المحررين وCLI وأنظمة التنسيق.

Why use this protocol?: يحتاج عمل البرمجة إلى سياق مساحة العمل، والتقدم المتدفق، والإلغاء، وقرارات الأذونات طوال الجلسة.
How does ADK-Rust use ACP?: يسمح AcpAgentTool وAcpToolset لوكيل ADK-Rust ببدء عملية ACP أو الاتصال بها، وإنشاء جلسة، ودفق عملها، وإرجاع النتيجة كاستدعاء أداة. يمكن أن يعرض جانب الخادم الاختياري وكيل ADK-Rust لعملاء ACP.
When should I choose ACP?: استخدم ACP لاستكشاف المستودع أو تنفيذه أو إعادة البناء أو الاختبار أو أي مهمة مفوضة يجب أن تحدث داخل مساحة عمل تطوير متحكم فيها.
What connects through ACP?: The other side is an ACP-compatible coding agent or client, such as Codex, Claude Code, an IDE, or your own ACP implementation.

Explore ACP in ADK-Rust

AWP

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

اجعل موقع الويب مفهومًا قبل أن يقوم الوكيل بإلغاءه.

What is AWP?

بروتوكول ويب ينشر الموقع من خلاله هويته، وما يمكن للوكلاء فعله، والسياسات المطبقة، وما إذا كانت الخدمات التي يواجهها الوكلاء سليمة.

Why use this protocol?: يشرح HTML الصفحة للمتصفح، ولكنه نادرًا ما يشرح إمكانات العمل أو الموافقة أو الثقة أو الحدود أو الأحداث لوكيل مستقل.
How does ADK-Rust use AWP?: يقوم adk-awp بتحميل سياق الأعمال، وإنشاء بيانات الاكتشاف والقدرة، وإضافة مسارات Axum ذات الإصدار لحدود المعدلات المدركة للثقة، والموافقة، واشتراكات الأحداث، ومراقبة السلامة.
When should I choose AWP?: استخدم AWP عندما يكون موقع الويب أو الخدمة قابلاً للاكتشاف والاستخدام عن قصد من قبل الوكلاء دون الاعتماد على تفسير الصفحات الهشة فقط.
What connects through AWP?: The other side is a visiting personal agent, enterprise agent, partner system, or agent-aware client that discovers and respects the site's published contract.

Explore AWP in ADK-Rust

بداية سريعة للمطور

من محطة طرفية إلى وكيل عامل، قرار واحد في كل مرة.

ابدأ بمشروع Rust صغير وعملي. توضح الخطوات الإرشادية أدناه ما يضيفه المولد، وكيفية تجميع المشروع محليًا، ومكان توسيعه مع نمو منتجك.

ماذا سيكون لديك في النهاية

وكيل Rust مُجمَّع مع أداة مكتوبة، وجلسة Launcher تفاعلية، وإعداد القياس عن بعد، ونقاط تكامل الجلسة والدرابزين، واستجابة نموذجية حقيقية في المحطة. المشروع الذي تم إنشاؤه هو مصدر Rust عادي يمكنك قراءته وتغييره وتوسيعه.

قبل أن تبدأ

مطلوب شيئين على جهازك

Rust 1.95 أو أحدث.
التثبيت مع الصدأ أو تحديث سلسلة الأدوات المستقرة.

مفتاح موديل API.
يستخدم هذا المسار GOOGLE_API_KEY; ويمكن اختيار مزود آخر في وقت لاحق.

تثبيت منشئ مشروع ADK

تضيف ميزة "cargo-adk" أوامر "cargo adk" المستخدمة لإنشاء مشاريع الوكيل وفحصها وإنشائها ونشرها.

cargo install cargo-adk

قم بإنشاء وكيل بداية مفيد

ابدأ بوكيل يمكنه الاتصال بأدوات Rust المكتوبة. قم بإضافة إمكانية المراقبة وحالة الجلسة وخطافات الحماية أثناء إنشاء المشروع.

cargo adk new support-agent --template tools \
  --addon telemetry --addon sessions --addon guardrails

أضف بيانات اعتماد النموذج الخاص بك

يستخدم المثال الذي تم إنشاؤه Gemini بشكل افتراضي. انسخ ملف المثال الآمن، ثم ضع مفتاحك في ملف .env الذي لم يتم تعقبه.

cd support-agent
cp .env.example .env
# set GOOGLE_API_KEY in .env

تجميع قبل التشغيل

يتحقق بناء adk الخاص بالحمولة من التبعيات التي تم إنشاؤها ومجموعة الميزات وأنواع Rust وإصدار الملف الثنائي دون نشر أي شيء.

cargo adk build

تشغيل والتحدث مع الوكيل

قم بتشغيل وحدة التحكم التي تم إنشاؤها، وأدخل رسالة، وشاهد نفس وقت التشغيل المكتوب الذي يمكنه لاحقًا تشغيل API أو سير العمل أو منتج الوقت الفعلي.

cargo run

وكيل الدعم - zsh

تثبيت مرة واحدة

$ cargo install cargo-adk

إنشاء المشروع

$ cargo adk new support-agent \
+  --template tools \
+  --addon telemetry \
+  --addon sessions \
+  --addon guardrails

تم إنشاؤه support-agent/
├── Cargo.toml التبعيات + أعلام الميزات
├── src/main.rs وكيل + أداة مكتوبة
├── .env.example التكوين المطلوب
└── التمهيدي.md تعليمات خاصة بالمشروع

تكوين النموذج

$ cd support-agent
  cp .env.example .env
  # Add GOOGLE_API_KEY to .env

التحقق ثم التشغيل

$ cargo adk build
  cargo run

تشغيل الإصدار الثاني الفعلي · استدعاء الأداة المكتوبة

  ADK-Rust — support-agent
    Type a message to chat. Type 'exit' to quit.

  You > Greet Ada casually.

  [tool] greet({"name":"Ada","style":"casual"})
  Hey Ada! What's up?

  You > exit

  Goodbye.

اختر هذا متى

اختره للتنسيق الحتمي، أو أجهزة الحالة الموجودة، أو أوقات تشغيل المجال، أو السلوك الذي يحتاج إلى التحكم الكامل في Rust.

نقطة البداية التي تم إنشاؤها

هيكل سمة الوكيل · InvocationContext · نقطة دخول EventStream

cargo adk new my-agent --template custom

يتضمن سجل CLI أيضًا ملفًا خاصًا بالموفر openai القالب، خمسة أنماط المؤسسة، و basic و a2a الأسماء المستعارة والوظائف الإضافية القابلة للتركيب.

cargo adk templatescargo adk addons

تجميع ما تحتاجه

ابدأ صغيرًا. أضف النظام عندما يطلب المنتج ذلك.

قم أولاً باختيار قالب لشكل تنفيذ المشروع. ثم حدد طبقة ميزات للإمكانيات المجمعة في الملف الثنائي.

تتحكم طبقات الميزات في التبعيات، ووقت الترجمة، والسطح الثنائي، والإطار المتاح APIs. تظل قواعد البيانات الدائمة، وMCP، ومديري السرية السحابية، وعمليات النقل المحددة في الوقت الفعلي اختيارات صريحة.

01 · ابدأ هنا

الحد الأدنى

الوكلاء · Gemini · Runner · الجلسات

وكيل مركّز بأصغر سطح افتراضي.

02 · بناء منتج

قياسي

الأدوات · الذاكرة · الرسم البياني · الخادم · المصادقة · التقييم · القياس عن بعد

معظم APIs وأنظمة سير العمل ومنتجات الوكيل الداخلي.

03 · توسيع النظام

مؤسسة

قاعدة الوقت الحقيقي · المتصفح · RAG · المدفوعات · AWP

المنتجات التي تحتاج إلى تفاعل أكثر ثراءً وقابلية للتشغيل البيني.

04 · سطح متخصص

كامل

الصوت · تنفيذ التعليمات البرمجية · وضع الحماية

الاشتراك في أثقل القدرات المحلية والتنفيذية.

adk-rust = { version = "2.0.0", features = ["standard"] }

البناء باستخدام ADK-Rust

أنشئ وكيلًا عاملاً وافهم وقت تشغيله وطوّره بثقة.

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

ابدأ التشغيل السريع الموجه استكشاف المصدر