Spraw, by Twój agent był wykrywalny
Jasna Agent Card daje klientom A2A wiarygodny punkt wyjścia: do kogo należy agent, gdzie się znajduje i jakie powiązania protokołów oraz wersje obsługuje.
Co generator Agent Card tworzy dla Twojego agenta AI
Agent Card to publiczny opis interfejsu agenta A2A. Zanim inny agent zdecyduje, czy wywołać Twoją usługę, potrzebuje czegoś więcej niż adresu URL: potrzebuje wiarygodnego opisu przeznaczenia agenta, jego kontraktu technicznego, umiejętności i wymagań dostępu.
Ten generator Agent Card zamienia te szczegóły implementacji na czytelny JSON w formacie A2A v1.0, trzymając podejmowanie decyzji blisko formularza. Użyj go po zbudowaniu podstawowej logiki agenta i przed jego wdrożeniem lub opublikowaniem — w miejscu, gdzie ręcznie napisany plik JSON zwykle się psuje.
Opisz użyteczny interfejs
Uchwyć preferowany interfejs, tryby treści, zachowanie strumieniowania i obsługę powiadomień push, których inny agent potrzebuje przed wykonaniem wywołania.
Ustal oczekiwania dotyczące dostępu
Udokumentuj, czy usługa jest publiczna, używa klucza API, czy wymaga OAuth 2.0, aby integracje mogły wybrać właściwy przepływ uwierzytelniania — nigdy nie umieszczając poświadczeń w Agent Card.
Zamień umiejętności w jasne kontrakty
Nazwij pracę, którą może wykonać Twój agent, dodaj tagi wymagane przez v1.0 oraz przydatne przykłady, i spraw, by jego granice były zrozumiałe dla ludzi, marketplace'ów i klientów AI.
Jak działa Generator Agent Card
Od szczegółów usługi do publikowalnej Agent Card
Generator Agent Card zamienia szczegóły usługi w jasny, publikowalny dokument JSON. Postępuj zgodnie z tym krótkim przepływem pracy przed wysłaniem Agent Card na produkcję.
- 1
Zacznij od prawdziwej usługi
Dodaj publiczny endpoint A2A, powiązanie protokołu, dane dostawcy, wersję agenta oraz typy treści, które Twój serwer akceptuje i zwraca.
- 2
Zdefiniuj granice możliwości i umiejętności
Wybierz tylko te możliwości, które obsługuje Twoja implementacja, a następnie opisz jedną reprezentatywną umiejętność prostym, konkretnym językiem.
- 3
Sprawdź wygenerowany JSON
Użyj podglądu na żywo, aby wykryć brakujące pola, przykładowe adresy URL, lub opisy, które nie odzwierciedlają dokładnie wdrożonej usługi.
- 4
Zwaliduj i opublikuj
Przepuść Agent Card przez walidator, a następnie umieść zweryfikowany dokument pod adresem /.well-known/agent-card.json w domenie swojej usługi.
Kto korzysta z Generatora Agent Card
Stworzony dla każdego, kto tworzy, publikuje lub weryfikuje Agent Card
Generator Agent Card pomaga twórcom, zespołom platformowym i recenzentom tworzyć spójne metadane agentów A2A bez zaczynania od pustego pliku JSON.
Deweloperzy AI i niezależni
Zastąp ręcznie napisany agent-card.json kompletnym punktem wyjścia zgodnym ze specyfikacją podczas uruchamiania agenta kompatybilnego z A2A.
Inżynierowie promptów i menedżerowie produktu
Sporządź wiarygodny dokument wykrywania na podstawie opisu usługi bez dotykania składni JSON, a następnie przekaż go inżynierii do weryfikacji.
Zespoły platformowe i DevOps
Ustandaryzuj sposób, w jaki wewnętrzni agenci opisują endpointy, uwierzytelnianie i umiejętności, zanim trafią do firmowego katalogu agentów lub potoku CI.
Wydawcy marketplace
Przygotuj metadane dostawcy, tagi umiejętności i deklaracje bezpieczeństwa, które recenzenci i systemy rankingowe będą w stanie faktycznie przetworzyć.
FAQ
Pytania o generator Agent Card
Dopilnuj podstaw, zanim klient A2A znajdzie Twój endpoint.
Czym jest A2A Agent Card?
A2A Agent Card to dokument wykrywania JSON dla agenta AI. Przekazuje potencjalnym klientom tożsamość, informacje o dostawcy, obsługiwane interfejsy, możliwości, umiejętności, akceptowane tryby treści i wymagania bezpieczeństwa — odpowiednik README plus przegląd API w relacji agent-agent.
Dlaczego używać generatora Agent Card zamiast pisać JSON ręcznie?
Ręcznie napisane Agent Card rutynowo mają brakujące wymagane pola, nazwy pól sprzed v1.0, lub błędy składni. Generator tworzy aktualną formę A2A v1.0 — supportedInterfaces, provider.organization, wymagane tagi umiejętności — i waliduje w trakcie pisania, więc błędy strukturalne nigdy nie trafiają na produkcję.
Na którą wersję A2A celuje wygenerowana Agent Card?
Generator emituje strukturę A2A v1.0: uporządkowaną tablicę supportedInterfaces z protocolBinding i protocolVersion dla każdego interfejsu, najwyższego poziomu version agenta, oraz capabilities obejmujące extendedAgentCard. Agent Card z polami url lub preferredTransport na najwyższym poziomie pochodzą sprzed v1.0.
Czy wygenerowany JSON wymaga przeglądu przed produkcją?
Tak. Generator tworzy praktyczny dokument wyjściowy, a nie substytut Twojego wdrożonego kontraktu. Potwierdź, że endpointy, powiązania protokołów, umiejętności i uwierzytelnianie odpowiadają usłudze, do której użytkownicy faktycznie będą mieć dostęp.
Gdzie publikuję Agent Card?
Opublikuj zweryfikowany JSON w tej samej domenie co Twoja usługa A2A pod adresem https://twoja-domena/.well-known/agent-card.json, czyli ścieżce well-known zarejestrowanej przez specyfikację A2A. Wiele starszych integracji sprawdza również /.well-known/agent.json, więc serwowanie obu jest bezpieczną strategią przejściową.
Gotowe do publikacji
Wróć do Generatora Agent Card przed publikacją.
Dokończ szczegóły, sprawdź wygenerowany JSON, i użyj walidacji na żywo przed opublikowaniem swojej Agent Card.