نمونههای 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 | پیادهسازیهای ایجنت پایتون با استفاده از SDK پایتون A2A را نمایش میدهد. | | samples/go | پیادهسازیهای ایجنت Go با استفاده از SDK Go A2A را نمایش میدهد. | | samples/dotnet | پیادهسازیهای ایجنت C# با استفاده از SDK داتنت A2A را نمایش میدهد. | | samples/java | پیادهسازیهای ایجنت جاوا با استفاده از SDK جاوا A2A را نمایش میدهد. | | samples/js | پیادهسازیهای ایجنت Node.js با استفاده از SDK جاوااسکریپت A2A را نمایش میدهد. |
مشارکت
ما از مشارکت همه افراد با هر سطح مهارتی استقبال و حمایت میکنیم! اگر ایدهای برای یک نمونه جدید، رفع اشکال یا بهبود مستندات دارید، لطفاً به راهنمای مشارکت ما مراجعه کنید.
دریافت کمک
ما متعهد به فراهم آوردن یک جامعه خوشآمدگو و حمایتکننده هستیم. اگر سؤال، بازخورد یا مشکلی داشتید، لطفاً در صفحه مسائل با ما در ارتباط باشید.
مخازن مرتبط
| مخزن | دستهبندی | توضیحات | | --- | --- | --- | | A2A | مشخصات اصلی | مستندات و مشخصات A2A. | | a2a-inspector | ابزارها | ابزار UI برای بازرسی ایجنتهای فعال شده با A2A. | | a2a-tck | آزمون | مجموعه تست برای اعتبارسنجی انطباق با پروتکل A2A. | | a2a-itk | آزمون | جعبه ابزار برای بررسی سازگاری میان پیادهسازیها و نسخههای مختلف SDKهای A2A با استفاده از مدل عبور چندمرحلهای و پروتکلهای انتقال متنوع. | | a2a-python | SDK (پایتون) | SDK رسمی پایتون برای A2A. | | a2a-go | SDK (Go) | SDK رسمی Go برای A2A. | | a2a-java | SDK (جاوا) | SDK رسمی جاوا برای A2A. | | a2a-js | SDK (جاوااسکریپت) | SDK رسمی Node.js/جاوااسکریپت برای A2A. | | a2a-dotnet | SDK (C#/.NET) | SDK رسمی C#/.NET برای A2A. | | a2a-rs | SDK (راست) | SDK رسمی راست برای A2A. |
سلب مسئولیت
مهم: کدهای نمونه ارائهشده فقط برای اهداف نمایشی بوده و سازوکارهای
پروتکل Agent-to-Agent (A2A). هنگام ساخت برنامههای تولیدی، بسیار مهم است که هر عاملی که خارج از کنترل مستقیم شما عمل میکند، به عنوان یک موجودیت بالقوه غیرقابل اعتماد در نظر گرفته شود.
تمام دادههایی که از یک عامل خارجی دریافت میشود — از جمله اما نه محدود به AgentCard، پیامها، مصنوعات و وضعیتهای وظیفه — باید به عنوان ورودی غیرقابل اعتماد پردازش شود. به عنوان مثال، یک عامل مخرب میتواند AgentCard را با دادههای ساختگی در فیلدهای آن (مانند توضیحات، نام، skills.description) ارائه کند. اگر این دادهها بدون پاکسازی برای ساخت پرامپتهای یک مدل زبانی بزرگ (LLM) استفاده شوند، ممکن است برنامه شما را در معرض حملات تزریق پرامپت قرار دهند. عدم اعتبارسنجی و پاکسازی صحیح این دادهها قبل از استفاده میتواند آسیبپذیریهای امنیتی را در برنامه شما ایجاد کند.
توسعهدهندگان مسئول پیادهسازی تدابیر امنیتی مناسب، مانند اعتبارسنجی ورودی و مدیریت امن اعتبارنامهها برای محافظت از سیستمها و کاربران خود هستند.
--- Tranlated By Open Ai Tx | Last indexed: 2026-05-21 ---