Phase 16: Multi-Agent & Swarms

A2A Ajan-Ajan Protokolü

Type: Learn + Build

Languages: Python (stdlib, http.server, json)

Prerequisites: Phase 16 · 04 (Primitive Model)

Time: ~75 minutes

Sorun

Bu nedenle, bir diğer ajanın diğer bir sistemdeki başka bir ajanı araması gerekir. Nasıl? HTTP bir son noktasını ortaya koyabilir, özel bir JSON şeması tanımlayabilir ve diğer tarafın konuşmasını umarsınız. Her çift ajan özel bir entegrasyon haline gelir.

A2A, bu çağrı için evrensel kablo protokolüdür. Standart keşif, standart görev modeli, standart ulaşım, standart eserler. HTTP+REST gibi ama birinci sınıf vatandaşlar olarak ajanlar için.

Anlam

Dört unsur

Agent Card.JSON belgesini /.well-known/agent-card.jsonajanın tanımlanması: isim, beceriler, supportedInterfaces(Son nokta URL, protokol bağlaması, protokol sürümü), varsayılan giriş ve çıkış medya türleri ve oth gereklilikleri (securitySchemesEk olarak .securityRequirementsKartayı okuyarak keşfetmek mümkündür.

httpCopyGET /.well-known/agent-card.json HTTP/1.1
Host: agent.example.com

jsonCopy{
  "name": "code-review-agent",
  "description": "Reviews Python and TypeScript code.",
  "version": "1.0.0",
  "supportedInterfaces": [
    {
      "url": "https:TOK0
      "protocolBinding": "HTTP+JSON",
      "protocolVersion": "1.0"
    }
  ],
  "capabilities": {"streaming": false, "pushNotifications": false},
  "securitySchemes": {
    "bearer": {"httpAuthSecurityScheme": {"scheme": "Bearer"}}
  },
  "securityRequirements": [{"schemes": {"bearer": {"list": []}}}],
  "defaultInputModes": ["text/plain", "application/json"],
  "defaultOutputModes": ["application/json"],
  "skills": [
    {
      "id": "review-python",
      "name": "Review Python",
      "description": "Reviews Python code.",
      "tags": ["code-review", "python"]
    },
    {
      "id": "review-typescript",
      "name": "Review TypeScript",
      "description": "Reviews TypeScript code.",
      "tags": ["code-review", "typescript"]
    }
  ]
}

Task.İş birimi. Hayat döngüsü olan asynk, durumlu bir nesne:TASK_STATE_SUBMITTED→ TASK_STATE_WORKING→ TASK_STATE_COMPLETED- Ne ?TASK_STATE_FAILED- Ne ?TASK_STATE_CANCELEDBir istemci bir mesaj gönderir, sunucu görevi oluşturur ve istemci sondajlar yapar veya güncellemelere abone olur.

Artifact.Bir görev tarafından üretilen sonuç türü. Metin, yapılandırılmış JSON, görüntü, video, ses.text- Evet .raw- Evet .urlveyadatave adını verebilir.mediaTypeBu yüzden farklı modaliteler birinci sınıf.

Opaque lifecycle.A2A, uzaktan ajanın görevi nasıl çözeceğini belirlemez. Müşteri, durum geçişlerini ve eserleri görür; uygulamanın herhangi bir çerçeveyi kullanması özgürdür.

MCP/A2A bölümü

• MCP(Deneyim 13): ajan aracı. ajan bir araç sunucusuna JSON-RPC üzerinden okur/yazır. Öntanımlı olarak devletsiz.
• A2A-Agent Agent.Per protokolü; her iki taraf da kendi akıl yürütme ile ajanlar.

Bir A2A eşleri tarafında MCP araçları çağırır.

Bulma akışı

sequenceDiagram
    participant C as Client
    participant S as Agent server
    C->>S: GET /.well-known/agent-card.json
    S-->>C: Agent Card JSON
    C->>S: POST /message:send (returnImmediately)
    S-->>C: task, TASK_STATE_SUBMITTED
    C->>S: GET /tasks/{id}
    S-->>C: TASK_STATE_WORKING
    C->>S: GET /tasks/{id}
    S-->>C: TASK_STATE_COMPLETED, artifacts

Bunlar HTTP+JSON bağlayıcı yolları ve her istek taşıyor A2A-Version: 1.0- Öntanımlı olarak .SendMessageBu nedenle, bir oylama istemcisi, görevin bir terminal veya kesinti durumuna ulaşana kadar bloklar.configuration.returnImmediatelyGörevini hemen geri almak için.

Ya da akışla:POST /message:streamServer Gönderilen Olayları gönderir (a taskÖnce, sonra.statusUpdateve artifactUpdateolaylar) ve /tasks/{id}:subscribeÇalışma bir göreve yeniden bağlanır. Görev bir terminal durumuna ulaştığında akım kapanır; hiçbir finalBayrak.

Müellif

A2A üç ortak örneği destekler:

• Bearer token: OAuth2 veya açık olmayan (httpAuthSecuritySchemeveya oauth2SecurityScheme)
• mTLS: karşılıklı TLS; kuruluşlar birbirlerine kimliklerini kanıtlar (mtlsSecurityScheme)
• API key: bir başlık, sorgu parametri veya çerez (apiKeySecurityScheme)

Autür , ajan kartında belirtilmiştir:securitySchemesHer bir programın adı ve securityRequirementsMüşteriler bulup kabul etmeleri gerekenleri belirler.

150'den fazla kuruluş Nisan 2026'a kadar

İşletme kurulumu A2A ölçeğini hızlandırdı. Başlık: A2A, işletme ajan sistemlerinin güven sınırlarını geçmesinin yolu haline geldi. Google Cloud Vertex AI Agent Builder A2A desteğini gönderdi; Microsoft Agent Framework onu destekler; çoğu ana çerçeve (LangGraph, CrewAI, AutoGen) A2A adaptörlerini gönderdi.

A2A'nın kazandığı yer

• Cross-organization calls.A şirketindeki ajan B şirketindeki ajanı arıyor. A2A olmadan her çift özel bir sözleşme olur.
• Heterogeneous frameworks.LangGraph ajanı CrewAI ajanı özel Python ajanı arıyor.
• Typed artifacts.Video sonucu, yapılandırılmış JSON, ses hepsi birinci sınıf.
• Long-running tasks.Çürük yaşam döngüsü + anketler saatlerce süren görevleri kolaylaştırır.

A2A'nın mücadele ettiği yer

• Latency-sensitive micro-calls.A2A'nın yaşam döngüsü asynk. Sub-millisecond ajan-a-agent uyumlu değil; doğrudan RPC kullanın.
• Tight-coupled in-process agents.Eğer her iki ajan da aynı Python işleminde çalışırsa, A2A'nın HTTP geri dönüş yolculuğu aşırı derecede.
• Small teams.Spec overhead gerçek; sadece içsel ajanlar için resmiye ihtiyaç duyulmayabilir.

A2A vs ACP, ANP, NLIP

2024-2026 yıllarında ilgili birkaç özellik ortaya çıktı:

• ACP(IBM/Linux Vakfı) A2A'nın öncesi, daha dar kapsam.
• ANP(Agent Network Protocol) Eş-Kahtap-Kahtap-Kahtap, Merkezsiz-İlk.
• NLIP(Ecma Doğal Dil İşbirliği Protokolü, standartlaştırılmış Aralık 2025) Doğal dil içerik türü.

A2A, Nisan 2026 itibariyle en çok kabul edilen eşler arası protokoldür. karşılaştırma için arXiv:2505.02279 (Liu et al., "A Survey of Agent Interoperability Protocols") bakınız.

Yapın

code/main.pyA2A-minimal bir sunucu ve istemci uyguluyor http.serverve JSON, 1.0 HTTP + JSON bağlamasında.

• Açıklamalar/.well-known/agent-card.json- Evet .
• kabul eder .POST /message:send- Evet .
• Görev durumu yönetir,
• Artefakları geri gönderir .GET /tasks/{id}- Evet .

Müşteri:

• Ajan kartını alır.
• ile bir mesaj gönderir returnImmediately- Evet .
• Seçimler tamamlanana kadar,
• - Bu eser okur.

Çık:

Copypython3 code/main.py

Skenar, sunucuyu arka plan bir ipçeye başlatır, sonra da istemciyi ona karşı çalışır.

Kullan

outputs/skill-a2a-integrator.mdA2A entegrasyonu tasarlıyor: Agent Kart içeriği, görev skemeleri, yazar seçimi, akış ve anket.

Gönder

Kontrol listesini:

• Pin the spec version.A2A hala gelişmekte .supportedInterfacesGiriş , kendi protocolVersion, ve müşteriler gönderir .A2A-Version: 1.0- Evet .
• Idempotent task creation.Tekrar gönderilen (ağ tekrar deneme) bir görev oluşturmalıdır.messageId- Evet .
• Artifact schemas.Ajanın hangi şekilleri gönderdiğini bildirin; tüketicilerin onaylaması gerekir.
• Rate limits + auth.A2A kamuya yöneliktir; standart web güvenliği uygulayın.
• Dead-letter for failed tasks.Sürekli aralıklı arıza türleri için zaman içinde kalıpları kontrol edin.

Egzersizler

1. Çık .code/main.pyMüşteri sunucuyu keşfettiğini ve doğru eseri aldığını onaylayın.
2. Bir ikinci beceri sunucuya ekleyin (örneğin, "cümle edin"). Ajan Kartı güncelleyin. Görev türüne göre beceri seçen bir istemci yazın. 1.0 talebi beceri alanı yoktur, bu nedenle sunucu mesaj parçalarına yönlendiriyor.
3. UygulamaPOST /message:stream: cevap sunucu gönderilen olaylar ile (a taskÖnce, sonra.statusUpdateBu nedenle, müşterinin farklı bir şekilde ne yapması gerekir?
4. A2A takvimini okuyun (https://a2a-protocol.org/latest/specification/Bu demo'nun uygulandığı üç konuyu belirleyin.
5. A2A (Agent Card keşfi) ile MCP (server tarafı yetenek listesi üzerinden) karşılaştırın listToolsKendini tanımlayan ajanlar ile yetenek denetleme arasındaki fark nedir?

Anahtar Terimler

Daha Fazla Okumak

• A2A specification Kanonik özellik
• A2A v1.0.1 releaseEtiketlenmişdocs/specification.mdve specification/a2a.protoBu ders
• Google Developers Blog — A2A announcement Nisan 2025'te başlatma tarihi
• A2A GitHub repo Referans uygulamalar ve SDK'lar
• Liu et al. — A Survey of Agent Interoperability Protocols MCP, ACP, A2A, ANP karşılaştırması

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.