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

Агентська картка — це машиночитаний документ, який використовується в протоколі 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: