Install
Use ADK with your preferred languageلمن يناسب
هذه المهارة تناسب من يريد مجموعة أدوات مفتوحة المصدر، الشفرة أولاً، لبناء وكلاء ذكاء معقّدين وتقييمهم ونشرهم. الاسم الرسمي هو Agent Development Kit（ADK）. تناسب أيضًا من لديه أصلًا لغة برمجة مفضلة ويستعد للبدء من مدخل «اللغة المفضلة» الرسمي. النص الأصلي يقول إنه يمكن استخدام ADK بلغتك المفضلة، لكن هذه الفقرة لا تعطي عناوين لغات ملموسة.
لا تناسب معاملة هذا المستودع كأمر تثبيت. هنا مستودع وثائق. ADK محسَّن لـ Gemini ونظام Google، لكنه مكتوب كمستقل عن النموذج وعن النشر، ومتوافق مع أطر أخرى. إن أردت قراءة الوثائق أولاً ولم ترد بعد نشرًا في حاويات، فلا تبدأ بـ Cloud Run أو GKE.
المستودع الرسمي هو https://github.com/google/adk-docs اعمل بالملاحظات المكتوبة أصلًا. لا تختلق مثبّتًا ولا عنوان وثائق لم يظهر.
إنهاء المحاولة الأولى في 3 دقائق
اسلك فقط مسار الوثائق الرسمية: اختر أولاً لغتك المفضلة، ثم ابحث عن المدخل الموافق في الشرح الرسمي، بدل تشغيل أمر تثبيت لم يظهر.
شرط مسبق: تستطيع فتح مستودع الوثائق الرسمي ولديك أصلًا لغة تعتزم استخدامها. في المرة الأولى لا تنشر ولا تكتب أسرارًا في الحوار.
موضع التثبيت: افتح https://github.com/google/adk-docs اتبع «استخدم ADK بلغتك المفضلة» لإيجاد المدخل الرسمي. النص الأصلي لا يكتب أوامر pip أو npm؛ لا تُكملها.
مهمة منخفضة المخاطر: اجعل الوكيل يقرأ ويلخّص ثلاثة وقائع فقط — هو حزمة أدوات الشفرة أولاً؛ رغم التحسين لـ Gemini ونظام Google فهو مستقل عن النموذج وعن النشر؛ ويوفّر سياق وثائق محسَّنًا متوافقًا مع محررات شفرة الذكاء. لا تدعه يختلق عناوين ملفات وثائق ولا ينشر إلى Cloud Run أو GKE أو Agent Runtime.
إشارة النجاح: تستطيع أن تشير إلى أن الخطوة التالية يجب أن تعود إلى الوثائق الرسمية وتبدأ بلغتك، ولم يُنفَّذ أمر تثبيت مختلق. إن أعطى الوكيل عنوانًا أو اسم حزمة لم يظهر فتوقف.
حالات الاستخدام
الحالة الأولى: ابدأ صنع وكيل بلغة تعرفها. النص الأصلي يقول إنه يمكن استخدام لغة مفضلة. يناسب من يختار اللغة أولاً ثم يفتح صفحة المدخل الرسمية فقط. إن لم يظهر مسار اللغة الملموس في الشرح الحالي فقف عند مقابلة دليل المستودع؛ لا تختلق عنوان get-started.
الحالة الثانية: أعطِ محرر شفرة ذكاء سياق وثائق محسَّنًا. النص الأصلي يقول إن ADK يوفّر سياق وثائق محسَّنًا متوافقًا مع محررات شفرة الذكاء لتسريع التطوير. يناسب من يستخدم محررًا أصلًا ويريد فقط تأكيد أنه يجب تحميل الوثائق الرسمية المحسَّنة لا لصق مدونة عشوائية. إن لم تُسرد أسماء الملفات والعناوين فلا تختلقها.
حدود الاستخدام
هذا المستودع وثائق لا مثبّت. لا تكتب أمر مدير حزم لم يظهر في المسار الرئيس. التغطية هي البناء والتقييم والنشر. في جانب النشر يكتب فقط أنه يمكن وضعه في حاوية ووضعه على Cloud Run أو GKE، أو توسيعه بـ Agent Runtime. لذلك آثار جانبية ولا يصلح كمحاولة أولى.
محسَّن لـ Gemini ونظام Google، لكن الرسمي يكتب أيضًا أنه مستقل عن النموذج وعن النشر ومتوافق مع أطر أخرى. لا تكتبه «Gemini فقط». سياق الوثائق المحسَّن متوافق مع محررات شفرة الذكاء، لكن لا توجد قائمة عملاء. الصفحة الرسمية هي https://github.com/google/adk-docs إن خالف عنوان أو أمر يقترحه الوكيل تلك الصفحة، فتلك الصفحة هي المرجع.