M365Con 2027 – مؤتمر مجاني عبر الإنترنت · 11–22 Jan 2027 · 120 sessions m365con.net

Agent card

Concept

في بروتوكول A2A، بطاقة الوكيل (agent card) هي وثيقة مقروءة آليًا تُنشر على عنوان URL معروف مسبقًا، وتصف اسم الوكيل وقدراته ومهاراته ونقطة الوصول الخاصة به ومتطلبات المصادقة وتنسيقات المدخلات والمخرجات، حتى يتمكن الوكلاء الآخرون من اكتشافه.

✦ CONCEPTAgent cardM365.FM
Title graphic: Agent card (Concept)

مواضيع تُناقش أيضًا

في الحلقات التي تتناول Agent card تُناقش أيضًا: Microsoft Purview Information Barriers، Context window، Front matter، Agent kill switch، AI red teaming وAI Center of Excellence.

Description

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

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

توضح صفحة Microsoft Learn الخاصة باستضافة A2A في Microsoft Agent Framework كيف يبدو ذلك عمليًا. ففي مثال الاستضافة باستخدام ASP.NET Core، تُقدَّم البطاقة على مسار معروف ينتهي بـ agent-card.json. وتأتي طريقة الربط التي تعرض البطاقة من حزمة A2A SDK لا من حزم استضافة Agent Framework. وتحدد البطاقة النموذجية اسمًا ووصفًا وإصدارًا، ووضعَي الإدخال والإخراج الافتراضيين، وواجهة مدعومة تتضمن عنوان URL وربط البروتوكول وإصدار البروتوكول. وتوصي الصفحة بأن تُستكمل البطاقة بالكامل في بيئات الإنتاج، حتى يحصل العملاء على معلومات كاملة عن الوكيل الذي سيستدعونه.

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

تتطرق حلقة "Agent-to-Agent (A2A) Communication - Simply Explained" إلى هذا المفهوم ضمن نقاش أوسع عن قابلية التشغيل البيني. وتقدم بطاقة الوكيل بوصفها الآلية التي يعلن الوكلاء من خلالها عن هويتهم وقدراتهم، مما يسهل الاكتشاف والتفاعل. وتربط الحلقة ذلك أيضًا بالتواصل المنظم، حيث يتبادل الوكلاء أنواعًا مختلفة من البيانات، وهو ما يدعم التعاون وتتبع حالة المهام. كما تؤكد أن قضايا الخصوصية والأمان محورية في التواصل بين الوكلاء، وأن على العاملين في هذه الأنظمة أن يدركوا المخاطر المرتبطة بمعالجة البيانات. ولأن بطاقة الوكيل تنشر معلومات عن الوكيل وكيفية الوصول إليه، فإن تحديد ما يُدرج فيها وكيفية التحكم في الوصول إليها جزء من اعتبارات الأمان الأوسع هذه.

خلاصة القول إن بطاقة الوكيل تؤدي دور الوصف العام لوكيل A2A. يقرؤها العملاء قبل إرسال أي مهمة، وتُقدَّم من موقع يمكن التنبؤ به، ويجب أن تكون كاملة ودقيقة في بيئات الإنتاج. وقيد بطاقة واحدة لكل مسار معروف في مثال استضافة ASP.NET Core هو اعتبار تصميمي ينبغي أخذه في الحسبان كلما عُرض أكثر من وكيل من المضيف نفسه.

Overview compiled with AI from M365.FM episodes and the facts on this page. You can improve it with the edit button below.

TypeConcept
KindFormat

Frequently asked questions

Questions marked with AI were written with AI from the facts on this page.

ما هي بطاقة الوكيل في بروتوكول A2A؟ (AI)

هي وثيقة مقروءة آليًا تُنشر على عنوان URL معروف، وتصف اسم الوكيل وقدراته ومهاراته ونقطة نهايته ومتطلبات المصادقة وتنسيقات الإدخال والإخراج، حتى يتمكن الوكلاء الآخرون من اكتشافه.

أين تُقدَّم بطاقة الوكيل في مثال Microsoft Agent Framework؟ (AI)

في مثال الاستضافة باستخدام ASP.NET Core تُقدَّم على مسار معروف ينتهي بـ agent-card.json، باستخدام طريقة ربط من حزمة A2A SDK لا من حزم استضافة Agent Framework.

هل يمكن لمضيف واحد نشر عدة بطاقات وكلاء؟ (AI)

بحسب صفحة Microsoft Learn، لا يستطيع المضيف الواحد نشر أكثر من بطاقة وكيل واحدة على المسار المعروف، لذلك لا يمكن اكتشاف إلا وكيل واحد هناك؛ أما الوكلاء الآخرون فيظلون متاحين عبر عناوين URL خاصة بهم يجب أن يكون العملاء على علم بها مسبقًا.

Glossary

Community wiki

Short info above, community knowledge below: add practical tips, examples or corrections. New contributions are reviewed first; trusted members publish directly.

Experts and companies for this topic

Nobody has listed this topic yet. Add it to your profile.

Maintained by Mirko Peters (Microsoft MVP) · Last updated: