قوالب المشاريع القابلة للتركيب

cargo adk new ينشئ مشروع Rust عاملًا من ثلاثة خيارات:

يحدد القالب شكل الوكيل أو سير العمل؛
تضيف الإضافات إمكانات مثل الجلسات وMCP أو القياس عن بُعد؛ و
يحدد النمط المؤسسي قالبًا ومجموعةً مُراجَعة من الإضافات لشكل منتج شائع.

يُعدّ CLI المثبّت المرجعَ المعتمد، لأن أدلة القوالب المخصصة يمكنها توسيع السجل المضمّن أو استبداله.

cargo adk templates
cargo adk addons
cargo adk new --help

إنشاء مشروع

# One LLM agent
cargo adk new support-agent --template llm

# A tool-using agent with operating capabilities
cargo adk new support-agent \
  --template tools \
  --addon sessions \
  --addon telemetry \
  --addon guardrails

# Preview generated files without writing them
cargo adk new support-agent --template graph --dry-run

يظل basic اسمًا مستعارًا لـ llm. استخدم الاسم الصريح llm في الوثائق الجديدة وعمليات التشغيل الآلية.

القوالب المضمّنة

يحتوي السجل المضمّن حاليًا على 13 قالبًا.

القالب	ما الذي ينشئه	اختره عندما
`llm`	`LlmAgent` واحد للمحادثة	يمكن لوكيل واحد تولّي الطلب واستدعاء الأدوات حسب الحاجة
`tools`	وكيل LLM بالإضافة إلى أمثلة `#[tool]` مكتوبة النوع	تكون أول خطوة مفيدة هي استدعاء أداة Rust مرئي
`rag`	وكيل ذو مسار معرفة للبحث المتجهي	يجب أن تستخدم الإجابات مستندًا خاصًا أو مجموعة معارف
`api`	وكيل متاح من خلال HTTP API	سيستدعي تطبيق آخر الوكيل عبر الشبكة
`openai`	وكيل LLM مُكوّن لـ OpenAI	OpenAI هو موفّر البدء المقصود
`sequential`	وكلاء متعددون يُنفَّذون بترتيب ثابت	تعتمد كل مرحلة على عمل المرحلة السابقة
`parallel`	اختصاصيون متزامنون مع نتائج مجمّعة	يمكن تنفيذ العمل المستقل في الوقت نفسه
`loop`	تنفيذ متكرر حتى استيفاء شرط	تحتاج دورة المراجعة أو الإصلاح أو التحسين إلى حلقة محدودة
`conditional`	توجيه قائم على القرارات بين الوكلاء	تحتاج الطلبات المختلفة إلى اختصاصيين أو مسارات مختلفة
`graph`	سير عمل متشعب مع نقاط تحقق	يجب استئناف العمل أو تشعيبه أو دمجه أو أن يظل قائمًا رغم فشل العملية
`realtime`	معالجة الصوت والفيديو ثنائية الاتجاه	يحتاج المنتج إلى محادثة صوتية مباشرة أو متعددة الوسائط
`custom`	تنفيذ يدوي لسمة `Agent`	لا يمكن التعبير عن عقد التنفيذ بواسطة وكيل مضمّن
`agent-engine`	حاوية BYOC لـ Gemini Enterprise Agent Engine مع `Dockerfile` و`deploy/terraform/`	يُنشر الوكيل إلى Agent Runtime كحاوية مُنشأة مسبقًا

اختر شكل التنفيذ أولًا. أضف الجلسات وMCP والقياس عن بُعد أو إمكانات المنتج الأخرى لاحقًا، بدلًا من استخدامها لتحديد سير العمل.

إضافات الإمكانات

كرّر --addon لتركيب الإمكانات. يحلّ المولّد أعلام الميزات والاستيرادات وأجزاء التهيئة وأمثلة البيئة والملفات المُنشأة الخاصة بها بترتيب أولوية ثابت.

الإضافة	ما تضيفه	السبب المعتاد لاستخدامها
`telemetry`	إعداد تتبع OpenTelemetry	تتبّع الطلبات عبر حدود النموذج والوكيل والأداة
`auth`	البنية الأساسية لمصادقة API-key وJWT	حماية نقطة نهاية وكيل منشورة
`sessions`	إعداد خدمة حالة الجلسة	متابعة محادثة أو سير عمل باستخدام الحالة المخزنة
`memory`	تكامل الذاكرة الدلالية وRAG	استرداد المعرفة ذات الصلة بما يتجاوز المحادثة الحالية
`mcp`	توصيل ميزات MCP ونقطة بدء العميل	ربط الإمكانات التي تملكها عملية أو خدمة أخرى
`guardrails`	خطافات التحقق من صحة الإدخال والإخراج	فرض قواعد المنتج قبل تنفيذ الوكيل وبعده
`eval`	هياكل اختبار التقييم	قياس السلوك مقابل حالات قابلة للتكرار قبل الإصدار
`browser`	تكامل أتمتة المتصفح	السماح لوكيل معتمد بتشغيل واجهة ويب
`server`	إعداد خادم Axum HTTP وA2A	إتاحة الوكيل للمتصلين عن بُعد
`docker`	ملفات بناء حاوية متعددة المراحل (`Dockerfile` و`Dockerfile.static` و`.dockerignore`)	حزم الوكيل في صورة حاوية مصغّرة

مثال:

cargo adk new order-agent \
  --template tools \
  --addon mcp \
  --addon sessions \
  --addon server \
  --addon auth \
  --addon telemetry

يُعدّ رمز القدرة المُنشأ نقطة بداية. استبدل نقاط النهاية النائبة، وبيانات الاعتماد، والسياسات، والخدمات الموجودة في الذاكرة بخيارات مملوكة للنشر قبل الإصدار.

الأنماط المؤسسية المركبة

تظهر الأنماط في مساحة الأسماء --template نفسها التي تستخدمها القوالب العادية. ولا توجد علامة --pattern منفصلة.

النمط	التركيب	نقطة بدء المنتج
`multi-agent`	`sequential` + القياس عن بُعد	سير عمل مرئي متعدد المراحل
`production`	`llm` + الخادم + المصادقة + الجلسات + القياس عن بُعد	خدمة وكيل موثَّقة وقابلة للمراقبة
`pipeline`	`sequential` + الجلسات + القياس عن بُعد	خط أنابيب معالجة ذي حالة
`chatbot`	`llm` + الجلسات + الذاكرة + الخادم	منتج HTTP حواري مزوّد بميزة الاستدعاء
`a2a-server`	`llm` + الخادم + الجلسات	وكيل A2A مستقل النشر

a2a يظل اسمًا مستعارًا لـ a2a-server.

cargo adk new operations-agent --template production
cargo adk new research-team --template multi-agent --addon eval
cargo adk new public-specialist --template a2a-server --addon auth

اختيار الموفر والنموذج

تحتوي القوالب على موفر افتراضي، ولكن يمكن لـ CLI تجاوزه دون تغيير بنية التنفيذ.

cargo adk new support-agent \
  --template tools \
  --provider openai \
  --model company-approved-model

استخدم --non-interactive في CI لكي تؤدي الخيارات المفقودة إلى فشل العملية بدلًا من فتح موجه. استخدم --json-output عندما يحتاج برنامج آخر إلى نتيجة التوليد.

القوالب المخصصة

مرّر دليلًا يحتوي على بيانات TOML عندما تحتاج المؤسسة إلى نقطة بداية قابلة لإعادة الاستخدام تتجاوز السجل المضمّن.

cargo adk new finance-agent \
  --template company-finance \
  --template-dir ./agent-templates

يستبدل القالب المخصص الذي يحمل الاسم نفسه لقالب مضمّن ذلك القالب عند استدعاء CLI. احتفظ ببيانات التعريف في نظام التحكم بالإصدارات، واختبر المشاريع المولّدة في CI.

name = "company-finance"
description = "Company finance agent with approved defaults"
provider = "openai"
features = ["minimal", "tools"]
imports = ["use std::sync::Arc;"]

التحقق من المشروع المولّد

cd support-agent
cargo adk build
cargo run

يقوم cargo adk build بتجميع المشروع المولّد والتحقق منه دون نشره. أودِع المصدر المولّد، وراجع الميزات المفعّلة ومتطلبات البيئة، واحتفظ بالأمر نفسه كبوابة في CI.

إبقاء الأتمتة محدّثة

يمكن أن تتغير محتويات السجل بين الإصدارات. قبل ترقية عملية توليد المشاريع المؤتمتة:

cargo adk templates
cargo adk addons
cargo adk new smoke-agent --template tools --addon mcp --dry-run

يتحقق هذا من الأسماء والتوافق مقابل ملف cargo-adk الثنائي الدقيق المثبّت في بيئة البناء.