عينات Agent2Agent (A2A)

مرحبًا بك في العينات البرمجية الرسمية والعروض التوضيحية لـ بروتوكول Agent2Agent (A2A).

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

لماذا Agent2Agent؟

في عالم من أطر عمل وأنظمة الذكاء الاصطناعي المتنوعة، يحتاج الوكلاء إلى لغة مشتركة للتواصل والتعاون وتفويض المهام بشكل آمن. يضع بروتوكول A2A معيارًا مفتوحًا وموحدًا لتشغيل الوكلاء المتعددين معًا.

توضح عيناتنا كيف يمكن حل مشاكل الوكلاء المتعددين المعقدة بسهولة عبر لغات وتطبيقات مستضيفة مختلفة.

بدء سريع

ابدأ فورًا بتشغيل وكيل Helloworld والتواصل معه عبر مضيف CLI الخاص بنا بلغة بايثون.

• تشغيل خادم الوكيل:

``bash cd samples/python/agents/helloworld uv run . `

• تشغيل عميل المضيف:

`bash cd samples/python/agents/helloworld uv run test_client.py ``

هيكلية المستودع

يتم تنظيم المستودع في عدة أدلة رئيسية حسب اللغة:

| الدليل | الوصف | | --- | --- | | samples | عينات A2A الأساسية منظمة حسب لغة البرمجة. | | samples/python | توضح تنفيذات الوكلاء بلغة بايثون باستخدام A2A Python SDK. | | samples/go | توضح تنفيذات الوكلاء بلغة Go باستخدام A2A Go SDK. | | samples/dotnet | توضح تنفيذات الوكلاء بلغة C# باستخدام A2A .NET SDK. | | samples/java | توضح تنفيذات الوكلاء بلغة جافا باستخدام A2A Java SDK. | | samples/js | توضح تنفيذات الوكلاء بلغة Node.js باستخدام A2A JavaScript SDK. |

المساهمة

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

الحصول على المساعدة

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

المستودعات ذات الصلة

| المستودع | الفئة | الوصف | | --- | --- | --- | | A2A | المواصفة الأساسية | مواصفة ووثائق A2A. | | a2a-inspector | الأدوات | أداة واجهة مستخدم لفحص الوكلاء الداعمين لـ A2A. | | a2a-tck | الاختبار | مجموعة اختبارات للتحقق من التوافق مع بروتوكول A2A. | | a2a-itk | الاختبار | مجموعة أدوات للتحقق من التوافق بين إصدارات وتنفيذات A2A SDK المختلفة باستخدام نموذج التنقل متعدد القفزات وبروتوكولات نقل متنوعة. | | a2a-python | SDK (بايثون) | مكتبة SDK الرسمية لـ A2A بلغة بايثون. | | a2a-go | SDK (Go) | مكتبة SDK الرسمية لـ A2A بلغة Go. | | a2a-java | SDK (جافا) | مكتبة SDK الرسمية لـ A2A بلغة جافا. | | a2a-js | SDK (جافا سكريبت) | مكتبة SDK الرسمية لـ A2A بلغة Node.js/جافا سكريبت. | | a2a-dotnet | SDK (C#/.NET) | مكتبة SDK الرسمية لـ A2A بلغة C#/.NET. | | a2a-rs | SDK (Rust) | مكتبة SDK الرسمية لـ A2A بلغة Rust. |

إخلاء المسؤولية

هام: الكود البرمجي التجريبي المقدم هو لأغراض التوضيح فقط ويشرح آلية بروتوكول التواصل بين الوكلاء (A2A). عند بناء تطبيقات الإنتاج، من الضروري اعتبار أي وكيل يعمل خارج نطاق سيطرتك المباشرة ككيان غير موثوق به محتمل.

يجب التعامل مع جميع البيانات المستلمة من وكيل خارجي—بما في ذلك بطاقة الوكيل، الرسائل، القطع الفنية، وحالات المهام—كمدخلات غير موثوق بها. على سبيل المثال، قد يقدم وكيل خبيث بطاقة وكيل تحتوي على بيانات مصطنعة في حقولها (مثل الوصف، الاسم، skills.description). إذا تم استخدام هذه البيانات بدون تنقيح لبناء مطالبات لنموذج اللغة الكبير (LLM)، فقد تعرض تطبيقك لهجمات حقن المطالبات. عدم التحقق والتنقية السليمة لهذه البيانات قبل الاستخدام يمكن أن يؤدي إلى ثغرات أمنية في تطبيقك.

يتحمل المطورون مسؤولية تنفيذ تدابير الأمان المناسبة، مثل التحقق من صحة المدخلات

والتعامل الآمن مع بيانات الاعتماد لحماية أنظمتهم ومستخدميهم.

--- Tranlated By Open Ai Tx | Last indexed: 2026-05-21 ---