Phase 13: Tools & Protocols

A2A Ajan-Ajan Protokolü

Type: Build

Languages: Python (stdlib, Agent Card + Task harness)

Prerequisites: Phase 13 · 06 (MCP fundamentals), Phase 13 · 08 (MCP client)

Time: ~75 minutes

Öğrenme Hedefleri

• Ajan-a-ağent (A2A) kullanım durumlarından ajan-a-ağent (MCP) kullanımı ayırt edin.
• Bir ajan kartı yayınlayın ./.well-known/agent-card.jsonyetenekleri ve supportedInterfacesMetadata.
• Görev yaşam döngüsünü izleyin: TASK_STATE_SUBMITTED- Evet .TASK_STATE_WORKING- Evet .TASK_STATE_INPUT_REQUIRED, ve terminal durumları TASK_STATE_COMPLETED- Evet .TASK_STATE_FAILED- Evet .TASK_STATE_CANCELED- Evet .TASK_STATE_REJECTED- Evet .
• Her bir kısmının bir tane olduğu Mesajları kullan text- Evet .raw- Evet .urlveyadata, ve çıkış olarak eserler.

Sorun

Müşteri hizmetleri ajanı rapor yazmayı uzman bir yazar ajanına devretmelidir.

• Yapısal REST API'si çalışır ama her çiftleme bir kerelik.
• Ortak kod tabanı. İki ajanın aynı çerçeveyi çalıştırmasını gerektirir.
• MCP, iki ajanın birbirleriyle işbirliği yaparak her bir ajanın iç mantığını koruduğu halde, çağrı araçları için değil.

A2A boşluğu dolduruyor. Bir ajanın bir görevi diğerine gönderdiği etkileşimi, bir yaşam döngüsü, mesajlar ve eserlerle modellediyor. Çağrılan ajanın iç durumu netsiz kalır.

A2A, "cadre arası ajanların birbirleriyle konuşmasına izin verin" protokolüdür.

Anlaşım

Ajan Kartı

A2A ' ya uygun her ajan bir kart yayınlar ./.well-known/agent-card.json- ...

jsonCopy{
  "name": "research-agent",
  "description": "Summarizes academic papers and drafts citations.",
  "version": "1.2.0",
  "supportedInterfaces": [
    {
      "url": "https:TOK0
      "protocolBinding": "JSONRPC",
      "protocolVersion": "1.0"
    }
  ],
  "capabilities": {"streaming": true, "pushNotifications": true},
  "securitySchemes": {
    "bearer": {"httpAuthSecurityScheme": {"scheme": "Bearer"}}
  },
  "securityRequirements": [{"schemes": {"bearer": {"list": []}}}],
  "defaultInputModes": ["text/plain"],
  "defaultOutputModes": ["text/markdown"],
  "skills": [
    {
      "id": "summarize_paper",
      "name": "Summarize a paper",
      "description": "Read a paper PDF and produce a 3-paragraph summary.",
      "tags": ["research", "summarization"],
      "inputModes": ["text/plain", "application/pdf"],
      "outputModes": ["text/markdown"]
    }
  ]
}

Bulma URL tabanlı: kartı getir, ilkini seç supportedInterfacesKayıtıprotocolBindingBu, bir iletişim ortamı olarak kullanılır.

İmzalanmış Ajan Kartları

Bir kart bir kart taşıyabilir .signaturesArray. Her giriş bir JWS (RFC 7515) kartın RFC 8785 kanonik JSON üzerinden hesaplanmıştır, signaturesKullanıcılar aynı şekilde kartı kanonikalize eder ve doğrulayır.

Görev yaşam döngüsü

textCopyTASK_STATE_SUBMITTED
  -> TASK_STATE_WORKING
  -> TASK_STATE_COMPLETED | TASK_STATE_FAILED | TASK_STATE_CANCELED | TASK_STATE_REJECTED

TASK_STATE_WORKING
  -> TASK_STATE_INPUT_REQUIRED
  -> TASK_STATE_WORKING (the client sends a message with the same taskId)

Müşteriler başlıyor SendMessageAdı ajanları devletler arasında geçiyor, müşteriler ile sorgu yapıyor.GetTaskveya SSE üzerinden akış SendStreamingMessageve SubscribeToTaskAkıntı taşıyor .statusUpdateve artifactUpdateBu durum, görevlerin son durumuna ulaştığında gerçekleşir ve kapanır.finalBayrak.

Mesajlar ve Bölümler

Bir mesajın bir messageId, a role(ROLE_USERveya ROLE_AGENT), ve bir veya daha fazla Bölüm. Her Bölüm tam olarak bir içerik alanı içerir ve bu alan adı türdür.kind- Alan.

• text: basit içerik.
• raw: dosya baytları, JSON'da base64, genellikle ilefilenameve mediaType- Evet .
• urlDosya içeriğine bir bağlantı.
• data: yapılandırılmış JSON payload (sırhlanan ajan için yapılandırılmış giriş).

Örnek:

jsonCopy{
  "messageId": "msg-001",
  "role": "ROLE_USER",
  "parts": [
    {"text": "Summarize this paper."},
    {"raw": "...", "filename": "paper.pdf", "mediaType": "application/pdf"},
    {"data": {"targetLength": "3 paragraphs"}, "mediaType": "application/json"}
  ]
}

Sanat eserleri

Çıktıkları çiğ ip değil, eserler.

jsonCopy{
  "artifactId": "art-001",
  "name": "summary",
  "parts": [{"text": "...", "mediaType": "text/markdown"}]
}

Sanat eserleri parça olarak akışabilir.artifactUpdateOlay , eser ve artfaktı taşıyor .appendve lastChunk- Arayan toplanıyor.

Üç protokol bağlaması

1. JSON-RPC 2.0 over HTTP(JSONRPC) POST istekler için, SSE akış için.SendMessage- Evet .SendStreamingMessage- Evet .GetTask- Evet .ListTasks- Evet .CancelTask- Evet .SubscribeToTask- Evet .CreateTaskPushNotificationConfig- Evet .GetTaskPushNotificationConfig- Evet .ListTaskPushNotificationConfigs- Evet .DeleteTaskPushNotificationConfigveGetExtendedAgentCard- Evet .
2. gRPC(GRPC) GRPC'nin yerli olduğu işletme ortamları için.
3. HTTP+JSON/REST(HTTP+JSON). gibi kaynak URL'leriPOST /message:sendve GET /tasks/{id}- Evet .

Üç bağlama da aynı veri modelini taşır.supportedInterfacesGiriş isimleri bir bağlayıcı ve onun protocolVersionMüşteriler başlığı gönderir .A2A-Version: 1.0Her istek için, çünkü bir sunucu, istek olmadan bir istekleri 0.3 sürümü olarak okuyor.

httpCopyPOST /a2a HTTP/1.1
Host: research.example.com
Content-Type: application/json
A2A-Version: 1.0

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "SendMessage",
  "params": {
    "message": {
      "messageId": "msg-001",
      "role": "ROLE_USER",
      "parts": [{"text": "Summarize this paper."}]
    }
  }
}

Açıklık koruma

Ana tasarım prensibi: çağrılan ajanın iç durumu açık değildir. Çağrılan görev durumunu ve eserleri görür. çağrılan ajanın düşünce zinciri, araç çağrıları, alt ajan delegasyonu hepsi görünmez. Bu, araç çağrılarının şeffaf olduğu MCP'den farklıdır.

A2A, rekabetçilerin içsel bilgileri açığa çıkarmadan işbirliği yapmasını sağlar. A2A, arama yapanın hizmeti nasıl uyguladığını öğrenmeden "bu müşteri hizmetleri ajanını arayın" olabilir.

Zaman çizgisi

• 2025-04-09.Google A2A'yı duyurdu.
• 2025-06-23.Linux Vakfına bağışlanmış.
• 2025-08.IBM'in ACP'ini emiriyor.
• 2025-09.AP2 uzatma (Agent Ödeme) gemileri.
• 2026-04.150+ destekleyici organizasyonla yayınlanan v1.0.

MCP ile ilişki

Bir özel aracı çağrıştırmak istediğinizde MCP kullanın. Bir tüm görevi başka bir ajan'a devretmek istediğinizde A2A kullanın. Birçok üretim sistemi her ikisini de kullanır: bir ajan araç katmanı için MCP'yi ve işbirliği katmanı için A2A'yı kullanır.

Kullan

code/main.pyA2A harnesini en az uyguluyor: yazar ajanı kartını yayınlıyor, araştırma ajanı ona bir SendMessagePDF bir parçası ve metin talimatı ile başvurun ve görev devam eder TASK_STATE_WORKING→ TASK_STATE_INPUT_REQUIRED→ TASK_STATE_WORKING→ TASK_STATE_COMPLETEDTüm stdlib; mesaj şekillerine odaklanmak için bir hafıza taşıyıcısı kullanır.

Neye bakılır:

• Ajan Kartı JSON şekli.
• Sunucu tarafındaki görev kimliği ve durum geçişleri.
• İçerik alanının bulunduğu bölümler.
• TASK_STATE_INPUT_REQUIRED- Ara sıra.
• Artifak tamamlandığında geri döner.

Gönder

Bu ders bize çok yararlı .outputs/skill-a2a-agent-spec.md. Diğer ajanlar tarafından çağrılabilir olan yeni bir ajan verildiğinde, yetenek Agent Kart JSON, yetenek skemi ve son nokta çizelgesini üretir.

Egzersizler

1. Çık .code/main.py.Task'ın tüm yaşam döngüsünü takip edin, TASK_STATE_INPUT_REQUIREDÇağrılan ajan açıklama istediğinde dur.

1. İmzalanmış bir ajan kartı ekle.signatures- Evet .alg ayarlanmıştırHS256, kartın kanonik JSON'unu imzalamak signaturesBir doğrulama yaz ve mutasyonlu bir kartta başarısız olduğunu onayla.

1. Görev akışı ile uygulayın SendStreamingMessage: yazar ajanı task, üç .artifactUpdateparçalar ve bir statusUpdate- Evet .TASK_STATE_COMPLETEDSonra akış kapanır.

1. Bir MCP sunucusuyla bir A2A ajanı tasarlayın. Her MCP aracı bir A2A yeteneğine göre bir harita yapın.

1. A2A v1.0 duyuruyu okuyun ve Nisan 2026 itibariyle herhangi bir çerçeve tarafından henüz uygulanmayan tek özelliği belirleyin.

Anahtar Terimler

Daha Fazla Okumak

• a2a-protocol.org Kanonik A2A spesifikasyonu
• a2aproject/A2A — GitHub Referans uygulamalar ve SDK'lar
• A2A v1.0.1 releaseEtiketlenmişdocs/specification.mdve düzenlemeler.specification/a2a.protoBu ders
• Linux Foundation — A2A launch press release Haziran 2025 yönetim transfer
• Google Cloud — A2A protocol upgrade Yol haritası ve ortakların hareketi
• Google Dev — A2A 1.0 milestone v1.0 serbest bırakma notları ve geriye doğru kompak rehberlik

This free lesson is part of the AI Engineering from Scratch curriculum. Read the full explanation, run the lesson code, and verify the result in the interactive reader or from the repository source.

Browse the complete course catalog or open this lesson on GitHub.