Agent'ınızı keşfedilebilir yapın
Net bir Agent Card, A2A istemcilerine güvenilir bir başlangıç noktası verir: agent kime ait, nerede yaşıyor ve hangi protokol bağlamalarını ve sürümlerini konuşuyor.
Bir Agent Card oluşturucu, AI agent'ınız için ne oluşturur
Agent Card, bir A2A agent'ının genel arayüz açıklamasıdır. Başka bir agent, sizin hizmetinizi çağırıp çağırmayacağına karar vermeden önce bir URL'den fazlasına ihtiyaç duyar: agent'ın amacı, teknik sözleşmesi, skill'leri ve erişim gereksinimleri hakkında güvenilir bir açıklamaya ihtiyacı vardır.
Bu Agent Card oluşturucu, bu uygulama detaylarını okunabilir, A2A v1.0 biçimli JSON'a dönüştürürken karar vermeyi formun yakınında tutar. Agent'ın temel mantığını oluşturduktan sonra ve dağıtmadan veya listelemeden önce kullanın — elle yazılan bir JSON dosyasının genellikle bozulduğu nokta budur.
Kullanılabilir bir arayüz tanımlayın
Başka bir agent'ın bir çağrı yapmadan önce ihtiyaç duyduğu tercih edilen arayüzü, içerik modlarını, akış davranışını ve push bildirim desteğini yakalayın.
Erişim için beklentiler belirleyin
Hizmetin herkese açık mı olduğunu, bir API anahtarı mı kullandığını, yoksa OAuth 2.0 mı gerektirdiğini belgeleyin; böylece entegrasyonlar kimlik bilgisini asla Agent Card koymadan doğru kimlik doğrulama akışını seçebilir.
Skill'leri net sözleşmelere dönüştürün
Agent'ınızın yapabileceği işi adlandırın, v1.0'ın gerektirdiği etiketleri ve yararlı örnekleri ekleyin, sınırlarını insanlar, pazar yerleri ve AI istemcileri için anlaşılır hale getirin.
Agent Card Oluşturucu nasıl çalışır
Hizmet detaylarından yayınlanabilir bir Agent Card'a
Agent Card Oluşturucu, hizmet detaylarını net, yayınlanabilir bir JSON belgesine dönüştürür. Agent Card'ı üretime göndermeden önce bu kısa iş akışını izleyin.
- 1
Gerçek hizmetle başlayın
Genel A2A uç noktasını, protokol bağlamasını, sağlayıcı detaylarını, agent sürümünü ve sunucunuzun kabul ettiği ve döndürdüğü içerik türlerini ekleyin.
- 2
Yetenek ve skill sınırlarını tanımlayın
Yalnızca uygulamanızın desteklediği yetenekleri seçin, ardından temsili bir skill'i sade, spesifik bir dille tanımlayın.
- 3
Oluşturulan JSON'ı gözden geçirin
Eksik alanları, yer tutucu URL'leri veya dağıtılan hizmeti doğru yansıtmayan açıklamaları tespit etmek için canlı önizlemeyi kullanın.
- 4
Doğrulayın ve yayınlayın
Agent Card doğrulayıcıdan geçirin, ardından gözden geçirilen belgeyi hizmet alan adınızda /.well-known/agent-card.json konumuna yerleştirin.
Agent Card Oluşturucu'yu kim kullanır
Agent Card oluşturan, gönderen veya inceleyen herkes için tasarlandı
Agent Card Oluşturucu, geliştiricilerin, platform ekiplerinin ve incelemecilerin boş bir JSON dosyasından başlamadan tutarlı A2A agent meta verileri oluşturmasına yardımcı olur.
AI ve bağımsız geliştiriciler
A2A uyumlu bir agent başlatırken elle yazılmış agent-card.json'ı, spesifikasyona uygun eksiksiz bir başlangıç noktasıyla değiştirin.
Prompt mühendisleri ve ürün yöneticileri
JSON söz dizimine dokunmadan bir hizmet açıklamasından güvenilir bir keşif belgesi taslağı hazırlayın, ardından inceleme için mühendisliğe teslim edin.
Platform ve DevOps ekipleri
Dahili agent'ların bir şirket agent kataloğuna veya CI hattına girmeden önce uç noktaları, kimlik doğrulamayı ve skill'leri nasıl tanımladığını standartlaştırın.
Pazar yeri yayıncıları
İncelemecilerin ve sıralama sistemlerinin gerçekten ayrıştırabileceği sağlayıcı meta verileri, skill etiketleri ve güvenlik beyanları hazırlayın.
SSS
Agent Card oluşturucu hakkında sorular
Bir A2A istemcisi uç noktanızı bulmadan önce temel unsurları doğru yapın.
A2A Agent Card nedir?
A2A Agent Card, bir AI agent'ı için bir JSON keşif belgesidir. Potansiyel istemcilere kimlik, sağlayıcı bilgisi, desteklenen arayüzler, yetenekler, skill'ler, kabul edilen içerik modları ve güvenlik gereksinimlerini iletir — bir README artı bir API genel bakışının agent-agent karşılığıdır.
JSON'ı elle yazmak yerine neden bir Agent Card oluşturucu kullanmalı?
Elle yazılan Agent Card rutin olarak eksik zorunlu alanlar, v1.0 öncesi alan adları veya söz dizimi hatalarıyla gönderilir. Oluşturucu, mevcut A2A v1.0 biçimini — supportedInterfaces, provider.organization, gerekli skill etiketleri — üretir ve siz yazarken doğrular, böylece yapısal hatalar asla üretime ulaşmaz.
Oluşturulan Agent Card hangi A2A sürümünü hedefliyor?
Oluşturucu, A2A v1.0 yapısını yayar: arayüz başına protocolBinding ve protocolVersion içeren sıralı bir supportedInterfaces dizisi, üst düzey bir agent version'ı ve extendedAgentCard dahil capabilities. Üst düzey url veya preferredTransport alanlarına sahip Agent Card v1.0 öncesidir.
Oluşturulan JSON üretimden önce incelenmeli mi?
Evet. Oluşturucu, dağıttığınız sözleşmenin yerine geçmeyen, pratik bir başlangıç belgesi oluşturur. Uç noktaların, protokol bağlamalarının, skill'lerin ve kimlik doğrulamanın kullanıcıların gerçekte erişeceği hizmetle eşleştiğini onaylayın.
Bir Agent Card'ı nereye yayınlarım?
Gözden geçirilen JSON'ı, A2A hizmetinizle aynı alan adında https://alan-adiniz/.well-known/agent-card.json adresinde yayınlayın; bu, A2A spesifikasyonu tarafından kaydedilen well-known yoludur. Birçok eski entegrasyon /.well-known/agent.json'ı da kontrol eder, bu nedenle her ikisini de sunmak güvenli bir geçiş stratejisidir.
Yayınlamaya hazır
Yayınlamadan önce Agent Card Oluşturucu'ya dönün.
Detayları tamamlayın, oluşturulan JSON'ı gözden geçirin ve Agent Card'ınızı yayınlamadan önce canlı doğrulamayı kullanın.