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: