M365Con 2027 – bezpłatna konferencja online · 11–22 Jan 2027 · 120 sessions m365con.net

Agent card

Concept

W protokole A2A karta agenta to dokument czytelny maszynowo, publikowany pod dobrze znanym adresem URL, który opisuje nazwę agenta, jego możliwości, umiejętności, punkt końcowy, wymagania dotyczące uwierzytelniania oraz formaty danych wejściowych i wyjściowych, dzięki czemu inne agenty mogą go odnaleźć.

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

Omawiane również

W odcinkach na temat Agent card pojawiają się też: Microsoft Purview Information Barriers, Context window, Front matter, Agent kill switch, AI red teaming i AI Center of Excellence.

Opis

Karta agenta to maszynowo czytelny dokument wykorzystywany w protokole Agent2Agent (A2A) do opisywania agenta. Jest publikowana pod dobrze znanym adresem URL i zawiera metadane, takie jak nazwa agenta, opis, wersja, możliwości, umiejętności, punkt końcowy, wymagania dotyczące uwierzytelniania oraz obsługiwane formaty wejścia i wyjścia. Jej główne zadanie to wykrywanie: klient lub inny agent może odczytać kartę, aby dowiedzieć się, co agent oferuje, zanim wyśle do niego jakiekolwiek żądanie.

Protokół A2A zapewnia interoperacyjność między agentami, kładąc nacisk na standardowy język, co eliminuje potrzebę tworzenia niestandardowego kodu dla każdej interakcji między agentami. Karta agenta jest elementem tego podejścia, który pozwala agentowi ogłaszać swoją tożsamość i możliwości. Zamiast na sztywno zakładać cechy zdalnego agenta, wywołujący agent odczytuje opublikowaną kartę i ustala, jak dotrzeć do agenta oraz jakie rodzaje danych może wymieniać.

Strona Microsoft Learn dotycząca hostowania A2A w Microsoft Agent Framework pokazuje, jak to wygląda w praktyce. W przykładzie hostowania w ASP.NET Core karta jest udostępniana pod dobrze znaną ścieżką kończącą się na agent-card.json. Metoda mapująca, która udostępnia kartę, pochodzi z pakietu A2A SDK, a nie z pakietów hostingowych Agent Framework. Przykładowa karta określa nazwę, opis i wersję, domyślne tryby wejścia i wyjścia oraz obsługiwany interfejs, który zawiera adres URL, powiązanie protokołu i wersję protokołu. Strona zaleca, aby w środowisku produkcyjnym karta była w pełni uzupełniona, tak aby klienci otrzymywali kompletne informacje o agencie, którego zamierzają wywołać.

Praktyczne ograniczenie opisane w dokumentacji dotyczy hostowania. Pojedynczy host może opublikować tylko jedną kartę agenta pod dobrze znaną ścieżką, co oznacza, że w tym miejscu wykrywalny jest tylko jeden agent. Inne agenty hostowane obok niego pozostają osiągalne pod własnymi adresami URL, ale klienci muszą już znać te punkty końcowe, ponieważ wspólna dobrze znana lokalizacja ich nie wymienia. Planując wdrożenie z wieloma agentami, należy to uwzględnić, projektując mechanizm wykrywania i sposób udostępniania informacji o punktach końcowych konsumentom. Strona dokumentacji nie omawia umiejętności, szczegółów uwierzytelniania ani podpisów kart, dlatego te aspekty karty są tutaj opisane jedynie na poziomie ogólnej definicji.

Odcinek "Agent-to-Agent (A2A) Communication - Simply Explained" porusza tę koncepcję w ramach szerszej dyskusji o interoperacyjności. Przedstawia kartę agenta jako mechanizm, dzięki któremu agenty ogłaszają swoją tożsamość i możliwości, co ułatwia wykrywanie i interakcję. Ten sam odcinek łączy to z ustrukturyzowaną komunikacją, w której agenty wymieniają różne typy danych, co wspiera współpracę i śledzenie stanu zadań. Podkreśla też, że prywatność i bezpieczeństwo są kluczowymi kwestiami w komunikacji między agentami i że każdy pracujący z tymi systemami powinien być świadomy ryzyka związanego z obsługą danych. Ponieważ karta agenta publikuje informacje o agencie i o tym, jak do niego dotrzeć, decyzja o tym, co się w niej znajdzie i jak kontrolowany jest dostęp, jest częścią szerszych rozważań dotyczących bezpieczeństwa.

Podsumowując, karta agenta pełni funkcję publicznego opisu agenta A2A. Jest odczytywana przez klientów, zanim zostanie wysłane jakiekolwiek zadanie, jest udostępniana z przewidywalnej lokalizacji i w środowisku produkcyjnym powinna być kompletna i poprawna. Ograniczenie jednej karty na dobrze znaną ścieżkę w przykładzie hostowania w ASP.NET Core jest kwestią projektową, którą trzeba uwzględnić zawsze, gdy z jednego hosta udostępnianych jest więcej niż jeden agent.

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

TypConcept
KindFormat

Często zadawane pytania

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

Czym jest karta agenta w protokole A2A? (AI)

Jest to maszynowo czytelny dokument, publikowany pod dobrze znanym adresem URL, który opisuje nazwę agenta, jego możliwości, umiejętności, punkt końcowy, wymagania dotyczące uwierzytelniania oraz formaty wejścia i wyjścia, aby inne agenty mogły go wykryć.

Gdzie karta agenta jest udostępniana w przykładzie Microsoft Agent Framework? (AI)

W przykładzie hostowania w ASP.NET Core jest udostępniana pod dobrze znaną ścieżką kończącą się na agent-card.json, przy użyciu metody mapującej z pakietu A2A SDK, a nie z pakietów hostingowych Agent Framework.

Czy jeden host może opublikować kilka kart agentów? (AI)

Według strony Microsoft Learn pojedynczy host może opublikować tylko jedną kartę agenta pod dobrze znaną ścieżką, więc wykrywalny jest tam tylko jeden agent; inne agenty pozostają osiągalne pod własnymi adresami URL, które klienci muszą już znać.

Słownik

Community wiki

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

Eksperci i firmy w tym temacie

Nikt jeszcze nie wskazał tego tematu. Dodaj go do swojego profilu.

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