Günümüzdeki çoğu yapay zeka sistemi tekil aracılardır. Tek bir model, tek bir istem döngüsü, tek bir araç seti. Bu durum, iş tek bir aracı için çok büyük hale gelene veya aracınızın halledemediği bir adımı başka bir ekip tarafından oluşturulmuş bir aracının ele alması gerekene kadar işe yarar. İşte o zaman bir duvara çarparsınız: iki bağımsız aracının birbirini bulması, iş değişimi yapması ve sonuçları bildirmesi için standart bir yol yoktur. Agent2Agent (A2A), bu duvarı ortadan kaldırmak için geliştirilmiş protokoldür.
Bu rehber, A2A'nın ne olduğunu, çözdüğü problemi, perde arkasında nasıl çalıştığını ve MCP'den nasıl farklılaştığını açıklar. Bunu okuduktan sonra bir A2A aracısını test etmek isterseniz, Apidog A2A Hata Ayıklayıcı rehberi bu yazının bittiği yerden devam eder.
Agent2Agent (A2A) Nedir?
Agent2Agent (A2A), yapay zeka aracıları arasında iletişim için açık bir protokoldür. Bir aracının yeteneklerini nasıl duyurduğunu, başka bir aracının ona nasıl bağlandığını, ikisinin nasıl mesaj ve dosya alışverişi yaptığını ve görev durumunun çağrı yapana nasıl geri aktığını tanımlar.
Anahtar kelime arasındakidir. A2A, bir aracıya daha fazla araç vermekle ilgili değildir. Farklı çerçevelerle farklı ekipler tarafından oluşturulmuş ayrı ajanların, her iki tarafın da diğerinin iç işleyişini bilmeden birlikte çalışabilmesini sağlamakla ilgilidir.
Bunu, ajan trafiği için HTTP gibi düşünün. HTTP, bir tarayıcının, sunucunun hangi dilde çalıştığını umursamadan herhangi bir web sunucusuyla konuşmasına izin verir. A2A, bir LangGraph aracısının, nasıl inşa edildiğini umursamadan bir CrewAI aracısıyla konuşmasına olanak tanır. Her iki taraf zarf konusunda anlaşır; hiçbir taraf kendi uygulamasını sızdırmaz.
Google, A2A'yı 2025'te tanıttı ve daha sonra satıcıdan bağımsız bir proje olarak Linux Vakfı'na taşıdı. Spesifikasyon, A2A GitHub deposunda açık bir şekilde yer almaktadır ve referans uygulamaları A2A proje sitesinde yayınlanmaktadır.
A2A'nın Çözdüğü Problem
A2A'dan önce, iki ajanı birbirine bağlamak yapıştırıcı kodu yazmak anlamına geliyordu. Her eşleştirme özeldi. Eğer ajanınız bir ortak ekibin araştırma ajanını araması gerekiyorsa, birisi özel bir istemci yazdı, bir yük şekli seçti, bir kimlik doğrulama şeması icat etti ve bunların hepsini elle sürdürdü. Bir sonraki eşleştirme yine sıfırdan başladı.
Bu yaklaşım hızla çöker:
- Keşif yok. Bir aracının iş göndermeden önce "ne yapabilirsin?" diye sorması için standart bir yol yoktu.
- Ortak görev modeli yok. Bir ajan düz bir dize döndürürken, diğeri özel bir JSON bloğu döndürüyor, üçüncüsü akış belirteçleri gönderiyordu. Çağıranın her birini özel olarak ele alması gerekiyordu.
- Ortak kimlik doğrulama yok. Her entegrasyon, kimlik bilgilerini ve başlıkları yeniden icat ediyordu.
- Birlikte çalışabilirlik yok. AutoGen üzerinde inşa edilmiş bir ajan, aynı işi yapsalar bile LangGraph üzerinde inşa edilmiş bir ajanın yerine geçemezdi.
A2A, REST entegrasyonlarını OpenAPI'nin düzelttiği gibi düzeltir: tek bir üzerinde anlaşmaya varılmış sözleşme, böylece uyumlu herhangi bir ajan diğer uyumlu ajanla konuşabilir.
A2A Nasıl Çalışır
A2A'nın dört temel konsepti vardır. Onları bir kez öğrendiğinizde, tüm protokol zihninize sığar.
Aracı Kartı
Aracı Kartı, bir aracının kendisini tanımlamak için yayınladığı bir JSON belgesidir. Keşif giriş noktasıdır. Aracının adını, açıklamasını, yeteneklerini, beyan edilen becerilerini, desteklenen giriş ve çıkış türlerini, kimlik doğrulama gereksinimlerini ve protokol sürümünü listeler.
Geleneksel olarak kart, iyi bilinen bir yolda, genellikle https://your-agent.example.com/.well-known/agent.json adresinde bulunur. Çağıran bir ajan önce o URL'yi alır, kartı okur ve tek bir mesaj göndermeden önce tam olarak ne isteyebileceğini öğrenir.
Görevler
Bir görev, A2A'daki iş birimidir. Bir aracı diğerinden bir şey yapmasını istediğinde, bu istek kendi kimliğine ve submitted, working, input-required ve completed gibi durumlar arasında hareket eden bir statüye sahip bir görev haline gelir. Çağıran, görevi sorgulayabilir veya güncellemelere abone olabilir. Bu paylaşılan görev modeli, A2A ajanlarını değiştirilebilir kılan şeydir; çağıran, işi kimin yaptığına bakılmaksızın statüyü aynı şekilde ele alır.
Mesajlar ve Yapıtlar
Bir mesaj, aracılar arasında gerçek içeriği taşır. Bir mesaj parçalardan oluşur: metin parçası, dosya parçası, yapılandırılmış veri veya bunların bir karışımı. Alan aracı, becerisinin ihtiyaç duyduğu parçaları okur.
Aracı işini bitirdiğinde, çıktıları, yani görevin yapılandırılmış çıktılarını döndürür. Bir çıktı, oluşturulmuş bir belge, bir veri tablosu, bir özet veya bir dosya referansı olabilir. Çıktılar da parçalardan oluşturulur, bu nedenle format her iki yönde de tutarlı kalır.
Akış ve Güncellemeler
Uzun süren görevlerin engellemesi gerekmez. A2A, sunucu tarafından gönderilen olayları destekler, böylece bir aracı, iş ilerledikçe kısmi sonuçları ve durum değişikliklerini yayınlayabilir. Bir araştırma ajanı, nihai raporu yayınlamadan önce "3 kaynak bulundu" bilgisini yayabilir. Çağıran, bir döndürücüye bakmak yerine ilerlemeyi gösterir.
Bir araya getirildiğinde, tipik bir A2A alışverişi şöyle görünür:
- A Aracı, B Aracının Aracı Kartını alır ve yeteneklerini okur.
- A Aracı, bir görev oluşturan bir mesaj gönderir.
- B Aracı görevi yapar ve durum güncellemelerini akışla yayınlar.
- B Aracı, görev
completeddurumuna ulaştığında çıktıları döndürür. - A Aracı çıktıları tüketir ve devam eder.
Tüm konuşma HTTP üzerinden JSON'dur. Egzotik hiçbir şey yok.
A2A ve MCP Karşılaştırması
A2A ve Model Bağlam Protokolü (MCP), her ikisi de ajanları içerdiği ve açık protokoller olduğu için sürekli karıştırılırlar. Ancak farklı sorunları çözerler.
| A2A | MCP | |
|---|---|---|
| Bağlar | Ajan ile ajan | Ajan ile araçlar ve veriler |
| Cevapladığı soru | "Başka bir ajan bu adımı benim için yapabilir mi?" | "Bu ajan hangi araçlara ve kaynaklara ulaşabilir?" |
| Tipik kullanım | Ekipler arası çoklu-ajan iş akışları | Tek bir ajanın bir veritabanını, dosya sistemini veya API'yi çağırması |
| Değişim birimi | Görevler, mesajlar, yapıtlar | Araç çağrıları, kaynaklar, istemler |
MCP, bir ajanın harici sistemlere ulaşma şeklidir. A2A ise bir ajanın başka bir ajana ulaşma şeklidir. Gerçek bir üretim sistemi genellikle her ikisini de kullanır: bir ajan bir veritabanını sorgulamak için MCP'yi kullanır ve bir alt görevi uzman bir ajana devretmek için A2A'yı kullanır. MCP sunucusu ve A2A karşılaştırması kararı derinlemesine ele alır ve Apidog'un MCP istemcisi hata ayıklayıcısı MCP tarafını pratikte gösterir.
Vahşi Doğada Çoklu Ajan İşbirliği
A2A, ajanların işbirliği yapmasının bir yoludur, ancak tek yolu değildir. Bazı sistemler bunun yerine doğrudan orkestrasyon kullanır; burada bir ajan işi planlar ve açıkça diğerine devreder.
Açık kaynaklı net bir örnek, OpenAI Codex ve Claude Code arasında gerçek zamanlı bir iş akışını koordine eden Codex-Claude-Collab becerisidir. Codex görevi planlar, uygulamayı Claude Code'a devreder, ardından farkı gözden geçirir ve sonucu doğrular ve ardından kullanıcıya yanıt verir. Bu, iki farklı kodlama ajanı arasında sıkı bir planlayıcı ve oluşturucu döngüsüdür.
Bu desen, donanım temelli bir orkestrasyondur; bir taraf diğerinin kim olduğunu tam olarak bilir. A2A aynı fikri genelleştirir: Codex'in özellikle Claude Code'u çağırdığını bilmek yerine, bir A2A çağırıcısı bir Aracı Kartı okur ve uyumlu herhangi bir ajanla çalışır. Orkestrasyon, her iki ucu da kontrol ettiğinizde harikadır. A2A ise ajanlar bağımsız, farklı ekiplere ait veya değiştirilebilir olması gerektiğinde istediğiniz şeydir. Çoğu olgun sistemde her ikisi de bulunur: bir ekip içinde orkestrasyon, ekipler arası ise A2A.
Bir A2A Aracısı Nasıl Test Edilir
Bir A2A aracısı oluşturduğunuzda veya kullandığınızda, trafiği görmeniz gerekir. Konsol günlükleri yapılandırılmış alanları gizler ve özel test komut dosyaları çürür. İşte burada görsel bir A2A hata ayıklayıcısının yeri önem kazanır.
Apidog, standart istemcisinde bir A2A Hata Ayıklayıcısı sunar. Bir Aracı Kartı URL'sini yapıştırır, Bağlan'a tıklarsınız ve Apidog kartı okuyarak aracının adını, yeteneklerini ve becerilerini gösterir. Bir test mesajı gönderir, dosyaları ekler, meta veriler ekler ve yanıtı üç görünümde okursunuz: okunabilir bir önizleme, ham içerik ve tam JSON-RPC yükü. Bearer Token, Temel Kimlik Doğrulama ve API anahtarı başlıklarını curl olmadan işler.
Mesele izolasyondur. Bir aracı yanlış davrandığında, taşımanın mı yanlış yoksa aracının mantığının mı yanlış olduğunu bilmek istersiniz. Tam kablo yükünü görmek, bunu saniyeler içinde yanıtlar. Apidog A2A Hata Ayıklayıcı rehberi, tam bir bağla-gönder-oku döngüsünü adım adım anlatır ve API'lerinizi çağıran yapay zeka ajanlarını test etme prensibi, aynı önce-kabloyu-doğrula disiplinini uygular.
A2A'ya Başlarken
Bir A2A aracısı oluşturmak veya bağlamak isterseniz, kısa bir yol şöyledir:
- Gerekli Aracı Kartı alanlarını ve görev yaşam döngüsünü öğrenmek için A2A spesifikasyonunu okuyun.
- Referans örnek ajanlarından birini yerel olarak çalıştırın. Çoğu birkaç dakika içinde başlar ve çalışan bir Aracı Kartı yayınlar.
- Bir A2A hata ayıklayıcısını örneğin Aracı Kartı URL'sine yöneltin ve bir "merhaba" mesajı gönderin. Gidiş-dönüşü görebildiğinizi onaylayın.
- Kendi aracınızı oluşturun, geçerli bir Aracı Kartı yayınlayın ve bir iş akışına bağlamadan önce aynı şekilde test edin.
- Düz metin yolu çalıştığında kimlik doğrulama, dosya ekleri ve akışı ekleyin.
A2A genç olmasına rağmen, satıcıdan bağımsız bir vakıf ve büyüyen bir çerçeve entegrasyonları listesi tarafından desteklenmektedir. Ajan trafiğini şimdi birinci sınıf bir protokol olarak ele almak, daha sonra özel yapıştırıcıyı yeniden yazma zahmetinden sizi kurtarır. Yapay zeka ajanları yeni API tüketicileridir yazısı daha geniş kapsamlı bir durum incelemesi yapar ve yapay zeka ajanları için API tasarlamak, tüketicinizin bir insan yerine bir ajan olduğunda nelerin değiştiğini kapsar.
Sık Sorulan Sorular
A2A Google tarafından mı yapıldı?
Google, A2A'yı 2025 yılında tanıttı, ardından satıcıdan bağımsız bir açık proje olarak Linux Vakfı'na bağışladı. Spesifikasyon açık olarak geliştirilmektedir ve herhangi bir satıcı bunu uygulayabilir.
Sadece tek bir ajanım varsa A2A'ya ihtiyacım var mı?
Hayır. A2A, ajandan ajana iletişimi çözer. Bir araç setine sahip tek bir ajan, A2A'ya değil, MCP'ye ihtiyaç duyar. İkinci bir ajan devreye girdiğinde A2A'ya başvurursunuz.
Hangi çerçeveler A2A'yı destekler?
A2A, tasarım gereği çerçeveden bağımsızdır. Geçerli bir Aracı Kartı yayınlayan ve protokolü konuşan herhangi bir aracı katılabilir, bu nedenle LangGraph, CrewAI, AutoGen ve özel aracılar hepsi çalışır. Aracının dahili çerçevesi çağrı yapanlar için görünmezdir.
A2A, MCP ile aynı mı?
Hayır. MCP, bir ajanı araçlara ve veri kaynaklarına bağlar. A2A ise ajanları birbirine bağlar. Bunlar tamamlayıcıdır ve birçok sistemde her ikisi birden çalışır.
Bir A2A entegrasyonunda hata ayıklamayı nasıl yaparım?
Apidog A2A Hata Ayıklayıcı gibi görsel bir A2A hata ayıklayıcısı kullanın. Aracı Kartı URL'sini yapıştırın, test mesajları gönderin ve ham isteği ve yanıtı inceleyerek taşıma hatalarını ajan mantık hatalarından ayırabilirsiniz.
A2A, uzun süreli görevleri destekliyor mu?
Evet. Görev modeli açık durum durumlarına sahiptir ve protokol, kısmi sonuçları ve ilerleme güncellemelerini akışla iletmek için sunucu tarafından gönderilen olayları destekler, böylece uzun süreli işler çağrı yapanı engellemez.