A2A Protokolü Açıklaması: Wellknown’da Agent Card ve İndeksleme
A2A protokolü, Agent Card’lar ve Wellknown’un A2A ajanlarını nasıl indekslediğini öğrenin.
A2A protokolü, yani Agent2Agent protokolü, yapay zeka ajanlarının birbirini keşfetmesini ve JSON-RPC kullanarak görev alışverişi yapmasını sağlayan açık bir standarttır. Bu protokolün merkezinde, A2A ajanı tarafından /.well-known/agent-card.json yolunda yayımlanan bir JSON belgesi olan Agent Card bulunur. Bu kart, ajanın adını, yeteneklerini, uç nokta URL’sini ve güvenlik şemalarını tanımlar; böylece diğer ajanlar ve indeksler onunla etkileşim kurabilir ve anlayabilir.
Önemli noktalar
- A2A protokolü, ajan keşfi ve görev alışverişini JSON-RPC üzerinden kolaylaştırır.
- Agent Card, ajanın alan adında
/.well-known/agent-card.jsonadresinde bulunur. - Agent Card, ajanın kimliğini, yeteneklerini, uç noktasını ve güvenlik yapılarını tanımlar.
- Wellknown, 2.749 A2A protokol kaydını indeksler ve bunlardan 2.153’ü şu anda aktif (live) durumdadır.
- Ajanlar, kendi kendine gönderim veya Agent Card keşfi yoluyla Wellknown indeksine dahil edilir.
A2A protokolü nedir?
A2A protokolü, Agent2Agent protokolünün kısaltmasıdır. Yapay zeka ajanlarının birbirini keşfetmesini ve görev alışverişi yapmasını sağlamak için tasarlanmış açık bir protokoldür. Ajanlar, alan adlarında standart bir konumda Agent Card adlı standart bir JSON belgesi yayımlarlar. Ajanlar arasındaki iletişim, JSON biçiminde kodlanmış uzak prosedür çağrısı protokolü olan JSON-RPC üzerinden gerçekleşir.
Bu protokol, ajanların dinamik olarak eşlerini bulmasını ve yapılandırılmış şekilde görev ve yanıt göndererek iş birliği yapmasını sağlar. MCP (Model Context Protocol) gibi, yapay zeka uygulamalarını araçlar ve verilerle bağlamaya odaklanan diğer protokollerden farklıdır.
Agent Card nedir ve nerede bulunur?
Agent Card, bir A2A ajanının alan adında /.well-known/agent-card.json yolunda yayımladığı JSON belgesidir. Bu konum standartlaştırılmıştır, böylece diğer ajanlar ve indeksler nereden bakacaklarını bilir.
Agent Card şunları tanımlar:
- Ajanın adı
- Ajanın yetenekleri veya kabiliyetleri
- Ajanla iletişim kurulabilecek uç nokta URL’si
- Ajanın desteklediği güvenlik şemaları
Bu bilgilerle Agent Card, ajanın keşfedilmesini ve onunla etkileşim kurulmasını sağlar. Wellknown gibi indekslerin ajanları listeleyip kategorize etmek için okuyabileceği bir kendini tanıtma belgesi işlevi görür.
Wellknown Agent Card’ları nasıl okur ve indeksler?
Wellknown, yapay zeka ajanları, MCP sunucuları ve araçların canlı bir indeksidir ve uç noktalarını aktif olarak kontrol eder. Agent Card’ları, ajanın alan adından /.well-known/agent-card.json dosyasını çekerek okur. Böylece ajanın adı, yetenekleri ve uç noktası gibi beyan edilen meta verileri çıkarır.
Wellknown, beyan edilen meta verileri (yayıncının bildirdiği) gözlemlenen verilerden (Wellknown’un uç noktayı kontrol ederek ölçtüğü) ayırır. Bu, ajanın mevcut erişilebilirliği ve güvenilirliği hakkında şeffaflık sağlar.
Wellknown kaç A2A kaydı tutuyor ve kaç tanesi canlı?
2026-10-31 tarihli en son veri anlık görüntüsüne göre, Wellknown A2A protokolü için 2.749 kayıt tutmaktadır. Bunların 2.153’ü şu anda canlıdır, yani son 24 saat içinde yapılan kontrol başarılı olmuştur. Bu, ağda erişilebilir aktif A2A ajanlarının yüksek seviyede olduğunu gösterir.
Karşılaştırma için, Wellknown’un toplam indeks büyüklüğü 79.658 kayıt olup, bunlardan 24.496’sı genel olarak canlıdır. A2A protokolü bu ekosistemin önemli bir alt kümesini oluşturur.
Ajan Wellknown indeksine nasıl gönderilir veya bulunur?
Ajanlar, kendi kendine gönderim veya otomatik keşif yoluyla Wellknown indeksine dahil edilir:
Kendi kendine gönderim: Yayıncılar, alan adı veya depo kontrolünü kanıtlayarak ajanlarını gönderebilirler. Kanıt yöntemleri arasında
_wellknown.YOUR-DOMAINadresinde DNS TXT kaydı oluşturmak,https://YOUR-DOMAIN/.well-known/wellknown-verify.txtadresinde doğrulama dosyası barındırmak veya depo kökünde.wellknown-verifydosyası bulundurmak yer alır.Keşif: Wellknown, MCP kaydı, npm, PyPI, GitHub gibi bilinen kaynakları tarayarak ve özellikle
/.well-known/agent-card.jsonadresinden Agent Card’ları çekerek ajanları keşfeder (kaynak etiketia2a_cardolarak belirtilir).
Bir ajan indekslendikten sonra, Wellknown’un HTTP API uç noktaları ve MCP sunucu araçları aracılığıyla aranabilir, çözümlenebilir ve durumu kontrol edilebilir.
Özet
A2A protokolü, yapay zeka ajanlarının standart bir konumda Agent Card yayımlayarak birbirini bulmasını ve iletişim kurmasını sağlar. Wellknown bu Agent Card’ları okuyarak ajanları indeksler; şu anda 2.749 A2A kaydı ve 2.153 canlı ajan bulunmaktadır. Ajanlar, alan adı kontrolü doğrulamasıyla kendi kendine gönderim veya keşif yoluyla indekse girer. Bu, geliştiriciler için canlı A2A ajanlarını ve yeteneklerini bulmada Wellknown’u değerli bir kaynak yapar.
Bu veriler 2026-10-31 tarihli anlık görüntüdür.