Skip to main content

> tpl_air_049

Ajan Birlikte Çalışabilirlik ve Protokol Karar Kaydı

Ajanlar arası iletişim standartlarını, Anthropic Model Context Protocol (MCP) mimarisini, gRPC ve JSON-RPC iletim katmanlarını, ajan kimlik başlıklarını ve durum serileştirme şemalarını değerlendiren mimari karar kaydı (ADR) ve protokol şartnamesi.

TEMPLATE // INSPECT: TPL-AIR-049MODIFIED: 2026-09-19
KATEGORİÜretken Yapay Zekâ, RAG ve Ajanlar
SÜRÜMv1.0.0
RİSK SEVİYESİMEDIUM
ARTEFAKT SINIFIADR
FORMATLARDOCX, PDF, MD, MERMAID, SVG
YAPAY ZEKÂ VE YÖNETİCİ ÖZETİ (AI SUMMARY)

Ajanlar arası protokolleri, Anthropic MCP standartlarını, iletim katmanlarını ve serileştirme şemalarını değerlendiren mimari karar kaydı.

Önemli Teknik Doküman Şablonu ve Hukuki Uyarı

TinyCTO.tv Teknik Doküman Şablon Bildirimi: Bu şablon genel eğitim ve operasyon amaçlı bir başlangıç materyalidir. Hukuki, vergisel, muhasebesel, yatırım, satın alma, mevzuat, güvenlik veya sertifikasyon danışmanlığı değildir. Gereklilikler ülkeye, kuruma, sözleşmeye ve riske göre değişir. Kullanmadan önce yetkin uzmanlarla gözden geçirip uyarlayın.

Çözülen Üretim Problemi

Mühendislik ekipleri şirkete özel kapalı ajan iletişim protokolleri geliştirir; bu da tedarikçi bağımlılığı yaratır, açık araç ekosistemleriyle entegrasyonu engeller ve farklı ajan çerçeveleri arasında durum aktarımını bozar.

Ne Zaman Kullanılmalı?

  • Farklı ajanlar arası ve ajan-araç entegrasyonları için iletişim protokollerini seçerken
  • Kurumsal araçlar için Anthropic Model Context Protocol (MCP) sunucu ve istemcilerini hayata geçirirken
  • Ajanlar arası mesaj zarflarını, izleme başlıklarını ve serileştirme formatlarını standartlaştırırken

Ne Zaman Kullanılmamalı?

  • Genel kurumsal API yönetişimi ve REST standartları için (TPL-ARC-012 kullanın)
  • Üst düzey çoklu ajan topolojisi ve iş akışı haritalaması için (TPL-AIR-038 kullanın)

5 Şablon Bölümü ve Yapısal İskelet

1. 1. Bağlam ve Problem Tanımıstandard, enterprise

Ajan çerçevelerindeki bölünmüşlüğün incelenmesi. Gereksinimler: evrensel araç keşfi, durum serileştirme, asenkron veri akışı (streaming), çift yönlü iletişim ve dilden bağımsızlık.

Yönerge:10'dan fazla ajan servisi devreye girdiğinde özel JSON arayüzlerinin neden tıkandığını açıkça belirtin.
2. 2. Protokol Seçenekleri ve Kıyaslama Analizistandard, enterprise

Seçeneklerin kıyaslanması: Model Context Protocol (MCP - araçlar ve kaynaklar için standart), gRPC / Protobuf (yüksek hız, ikili), REST / JSON-RPC 2.0 (basitlik, web uyumu) ve FIPA-ACL.

Yönerge:Araç ve veri kaynağı entegrasyonu için MCP'yi; dahili yüksek hızlı ajan iletişimi için gRPC'yi tercih edin.
3. 3. Mimari Karar ve Gerekçe (Anthropic MCP Kararı)standard, enterprise

Dış araç ve veri erişiminde Model Context Protocol (MCP) standardının, dahili ajan ağında ise düşük gecikmeli gRPC'nin kabul edilmesinin kararlaştırılması.

Yönerge:Miras araç sarmalayıcılarının geçiş yolunu, ödünleşimleri ve getirdiği mimari sorumlulukları kaydedin.
4. 4. Standart Ajanlar Arası Mesaj Zarfı Şartnamesistandard, enterprise

Standart mesaj zarfı yapısı: id, source, specversion (1.0), type (ajan.sorgu, ajan.devir), veri türü, traceparent ve veri yükü şeması.

Yönerge:Kafka ve EventBridge gibi kurumsal mesaj kuyruklarıyla tam uyum için CNCF CloudEvents yapısını benimseyin.
5. 5. Güvenlik, Karşılıklı TLS (mTLS) ve Kimlik Birliğistandard, enterprise

Ajanlar arası ve ajan-MCP bağlantılarının karşılıklı TLS (mTLS), SPIFFE/SPIRE kriptografik iş yükü kimlikleri ve OAuth 2.0 ile korunması.

Yönerge:Tüm ajanlar arası çağrılar doğrulanmış bir kriptografik gönderici kimliği taşımalıdır.

Doldurma ve Uygulama Yönergeleri

1. Boş şablonu inceleyin. 2. Örnek senaryoyu kurum ölçeğine uyarlayın. 3. Kontrol listesiyle doğrulayın.

Bağımsız İnceleme ve Onay Kontrol Listesi

  • Tüm zorunlu bölümler dolduruldu
  • Gizli anahtar veya parola içermiyor
  • Yönetici sponsor onayı alındı
İŞLENMİŞ SENARYO ÖRNEĞİ

Ajan Birlikte Çalışabilirlik ve Protokol Karar Kaydı - Örnek Vaka Analizi

Örnek Organizasyon: Kurumsal Çoklu Ajan Tedarik Zinciri Orkestratörü (30'dan Fazla Lojistik ve ERP Ajanını Bağlayan)

Kurumsal Çoklu Ajan Tedarik Zinciri Orkestratörü (30'dan Fazla Lojistik ve ERP Ajanını Bağlayan) için eksiksiz operasyonel uygulamayı gösteren gerçek dünya vaka analizi.

Öne Çıkan Bulgular ve Çıktılar:
  • 60'tan fazla özel araç entegrasyonunu Anthropic MCP standardına geçirerek 1.800 satırlık karmaşık bağlantı kodunu temizledi
  • Yüksek hacimli veri akışlarında gRPC kullanarak ajanlar arası mesaj serileştirme yükünü %70 azalttı
  • Tüm ajanlar arası ağ çağrılarında SPIFFE/mTLS kriptografik kimlik doğrulamasını zorunlu kıldı

Sıkça Sorulan Sorular

Anthropic Model Context Protocol (MCP) neden ajan araç entegrasyonunda baskın standart haline geldi?

MCP öncesinde her yapay zeka çatısı (LangChain, AutoGen vb.) kendine özel araç adaptörleri gerektiriyordu. MCP, JSON-RPC 2.0 tabanlı açık bir standart kurarak herhangi bir ajanın dilden bağımsız olarak araçları keşfetmesini, çalıştırmasını ve verilere erişmesini sağladı.

Bir mimaride ne zaman Model Context Protocol (MCP) yerine gRPC tercih edilmelidir?

MCP, istemci-araç ve istemci-veri entegrasyonu için idealdir. Kubernetes kümesi içindeki yüksek frekanslı, düşük gecikmeli ajanlar arası veri transferlerinde (ör. milyonlarca embedding akışı) ikili (binary) Protobuf ve gRPC çok daha yüksek performans sunar.

CloudEvents uyumluluğu asenkron çoklu ajan mesajlaşmasını nasıl güçlendirir?

Ajan talimatlarını benzersiz UUID'ler, kaynak adresleri ve W3C izleme başlıkları içeren standart CloudEvents zarflarına sarmak, mesajların kurumsal kuyruklar (Kafka, RabbitMQ vb.) üzerinden kayıpsız, yeniden oynatılabilir ve uçtan uca izlenebilir şekilde iletilmesini garanti eder.

Teknik Doküman Şablon Paketi

Giriş Gerekli
Ücretsiz ve güvenli indirmeler için tek seferlik giriş veya kayıt gereklidir.
Eksiksiz Teknik Doküman Paketi (.zip)
12 Dosya

Tüm boş şablonları, işlenmiş senaryoları ve doğrulama manifestolarını tek bir arşivde indirin.

Münferit Belgeler (.zip)
TPL-AIR-049-Agent-Interoperability-and-Protocol-Decision-Record-Blank-EN.docxDOCX
all11.5 KB
TPL-AIR-049-Agent-Interoperability-and-Protocol-Decision-Record-Example-EN.docxDOCX
all11.5 KB
TPL-AIR-049-Ajan-Birlikte-Calisabilirlik-ve-Protokol-Karar-Kaydi-Bos-TR.docxDOCX
all11.6 KB
TPL-AIR-049-Ajan-Birlikte-Calisabilirlik-ve-Protokol-Karar-Kaydi-Ornek-TR.docxDOCX
all11.6 KB
TPL-AIR-049-Agent-Interoperability-and-Protocol-Decision-Record-Blank-EN.mdMD
all2.5 KB
TPL-AIR-049-Agent-Interoperability-and-Protocol-Decision-Record-Example-EN.mdMD
all2.6 KB
TPL-AIR-049-Ajan-Birlikte-Calisabilirlik-ve-Protokol-Karar-Kaydi-Bos-TR.mdMD
all2.4 KB
TPL-AIR-049-Ajan-Birlikte-Calisabilirlik-ve-Protokol-Karar-Kaydi-Ornek-TR.mdMD
all2.6 KB
TPL-AIR-049-Agent-Interoperability-and-Protocol-Decision-Record-Blank-EN.pdfPDF
all97.5 KB
TPL-AIR-049-Agent-Interoperability-and-Protocol-Decision-Record-Example-EN.pdfPDF
all99.5 KB
TPL-AIR-049-Ajan-Birlikte-Calisabilirlik-ve-Protokol-Karar-Kaydi-Bos-TR.pdfPDF
all100.6 KB
TPL-AIR-049-Ajan-Birlikte-Calisabilirlik-ve-Protokol-Karar-Kaydi-Ornek-TR.pdfPDF
all103.4 KB
Doğrulanmış SHA-256 · Makrosuz Güvenli Arşiv
Her indirme dinamik MANIFEST.json içerir

Yetkili Standartlar ve Kaynaklar