API'niz anahtarı bilir. Aktörü bilmez.
Her API isteği, bunun için kimin ödeme yaptığına dair bir tür kanıtla gelir: bir API anahtarı, bir OAuth token, bir oturum. Bu kanıt tek bir soruyu iyi yanıtlar. Çağrıdan hangi hesabın sorumlu olduğunu söyler. Ancak şu anda çağrıyı gerçekte neyin yaptığını söylemez.
Tek bir API anahtarı, terminalde test yapan bir geliştirici tarafından da, zamanlanmış çalışan bir arka uç işi tarafından da, bir AI asistanı üzerinden çalışan bir kişi tarafından da, anahtarı alıp bir görevi tamamlaması söylenen otonom bir ajan tarafından da kullanılabilir. Bunlar çok farklı aktörlerdir. Farklı ritimleri, farklı hata kipleri ve farklı risk profilleri vardır. Hepsine aynı şekilde davranmak, ya müşterilerinizin güvendiği meşru otomasyonu gereğinden fazla kısıtlamanıza ya da API'nizin asla gözetimsiz bir ajan tarafından yönlendirilmemesi gereken bölümlerini yetersiz korumanıza yol açar.
API'ler için yapay zeka ajanı tanımlama bu boşluğu kapatır. Her şeyi anahtardan çıkarsamak yerine, her isteğin arkasındaki aktörün sınıflandırmasını ve bunu destekleyen kanıtı elde edersiniz. Proof of Actor tam olarak bunu sunmak için tasarlanmıştır ve APIs kullanım alanı API ekiplerinin bunu rotaya göre nasıl uyguladığını gösterir.
API ekiplerinin neden şimdi aktör bağlamına ihtiyacı var
API'lere yönelik otomatik trafik yeni değil. Betikler, entegrasyonlar ve tarayıcılar her zaman tablonun bir parçası oldu. Değişen şey otomasyonun türü. Yapay zeka ajanları belgeleri okuyabilir, çağrıları birbirine zincirleyebilir, yaratıcı biçimde yeniden deneyebilir ve her adımı izlemeyen kişiler adına hareket edebilir. Bunların birçoğu yararlı ve kabul edilebilirdir. Bazıları kötü tasarlanmıştır. Birkaçı ise düşmancadır.
Aktör bağlamı olmadan API ekipleri genellikle kaba araçlara başvurur:
- Anahtar başına oran sınırları, iyi ajanları ve kötü ajanları eşit şekilde yavaşlatır.
- User-agent kuralları, istemci bir başlığı değiştirdiği anda bozulur.
- Toplu engeller, meşru otomasyonu bunun yerine web uygulamanızı taramaya iter.
Aktör bağlamı size hassas yanıt verme olanağı sağlar. Tanıdığınız bir operatörden gelen imzalı bir ajan, salt okunur rotalarda daha yüksek bir sınır alabilir. Yazma rotasına gelen bilinmeyen bir çağırandan daha güçlü bir kimlik bilgisi istenebilir. Bir AI asistanı kullanan bir insan normal bir deneyimi sürdürebilir. Amaç ajanları durdurmak değildir. Amaç, her çağıran türüne doğru yolu vermektir. İmzalı bir isteğin size neyi kanıtlayıp neyi kanıtlayamayacağı hakkında imzalı yapay zeka ajanı isteklerinin neyi kanıtladığını okuyun.
Proof of Actor içinde yapay zeka ajanı tanımlama nasıl çalışır
Proof of Actor, her istek için kanıt-öncelikli aynı akışı izler. Tam adım adım anlatımı Nasıl Çalışır bölümünde okuyabilirsiniz; burada API ekipleri için kısa sürüm yer alıyor.
1. Entegrasyonunuzdan gelen sinyaller
Entegrasyonunuz, o bağlamda mevcut olan sinyalleri Proof of Actor'a iletir. Bir API için bu genellikle başlıklar ve protokol ayrıntıları gibi istek bağlamı, istemcinin sağladığı kriptografik istek imzaları ve istemcinin kendi hakkında yaptığı beyanlar anlamına gelir. Her sinyal, kaynağıyla birlikte etiketlenir.
2. Dayanağı olan sınıflandırma
Sinyaller kontrol edilir ve dört herkese açık sınıftan birine birleştirilir:
- Human: gözlemlenebilir sinyaller, insan yönlendirmeli bir etkileşimi gösterir.
- Human + AI: AI desteği beyan edilmiştir veya bunu gözlemleyebilen bir entegrasyon tarafından tespit edilmiştir.
- Agent: doğrulanabilir kimlik veya dikkatle nitelendirilmiş bir çıkarım tarafından desteklenen otomatik ya da ajan kaynaklı trafik.
- Unknown: kanıt güvenilir bir belirleme için yeterli değildir.
Her sonuç ayrıca kendi dayanağına sahiptir: Verified, Declared, Inferred veya Unknown. API ekiplerinin en çok değer verdiği kısım budur. HTTP message signature, RFC 9421 içinde tanımlandığı şekilde, yayınlanmış bir anahtara karşı doğrulanan bir istek, Verified olarak raporlanır. Kendini yalnızca bir ajan olarak tanıtan bir istemci, Declared olarak raporlanır. Otomatik görünüm veren bir desen Inferred olarak raporlanır. Bir sonucun kriptografiye mi yoksa bir sezgisel yönteme mi dayandığını asla merak etmek zorunda kalmazsınız. Kanıt dayanağı, cevabın bir parçasıdır.
3. Kodunuzun üzerinde işlem yapabileceği bir sonuç
Sonuç, sınıf, dayanak ve okunabilir bir kanıt özetiyle birlikte uygulamanıza geri döner. Ne yapacağınıza kodunuz karar verir. Gözlem modunda bunu yalnızca kaydedersiniz. Hazır olduğunuzda bunun üzerinden yönlendirme yaparsınız.
Ekibinizin elde ettiği şey: Detect, Understand, Route
Proof of Actor, tek ürün ve üç yetenekten oluşur.
Detect
API'nizin görebildiği aktör sinyallerini toplayın ve doğrulanmış beyanları davranışsal çıkarımlardan ayırın. İmzalı ajan istekleri, beyan edilmiş istemciler, otomasyon sinyalleri ve Unknown sonuçları birbirinden ayrı tutulur, böylece hiçbir şey sessizce tek bir puanda birleştirilmez.
Understand
Hangi aktörlerin hangi rotaları çağırdığını, bunun zaman içinde nasıl değiştiğini ve her sınıflandırmanın arkasında hangi kanıtın bulunduğunu görün. Unknown oranı görünür kalır, bu da kapsamınızın tam olarak nerede bittiğini ve daha güçlü bir sinyalin nerede yardımcı olacağını size gösterir.
Route
Her rota ve her risk kademesi için politikalar yazın: allow, adapt, challenge, review veya rate-limit. Salt okunur uç noktalarda doğrulanmış ajanlar için yapılandırılmış ve cömert bir yol bırakın. Yüksek etkili işlemlerde daha güçlü kimlik bilgisi isteyin. Unknown ve zaman aşımları için açık bir geri dönüş tanımlayın, böylece ne olursa olsun API'niz öngörülebilir davranır. Her politikanın ilgili rotada bir hatayı nasıl yöneteceğine, open veya closed olup olmayacağına siz, o rotadaki bir hatanın maliyetine göre karar verirsiniz.
Kimlik kanıtı, kimlik bilgileri ve yetkilendirme üç farklı şeydir
Ajan farkındalığına sahip API tasarımında en yaygın hata, üç ayrı soruyu tek bir soruda birleştirmektir. Proof of Actor bunları ayrı tutar ve tasarımınızın da öyle olması gerekir.
- Kimlik kanıtı: hangi tür aktör çağrı yapıyor ve bunu ne kanıtlıyor? Yapay zeka ajanı tanımlama bunu sağlar. Doğrulanmış bir imza, isteği bir anahtarla ve yayınlanmış operatör tanımlayıcısıyla ilişkilendirir. IETF Web Bot Auth çalışma grubu, otomatik istemciler için bu tür kriptografik kimlik doğrulamayı standartlaştırmakla görevlidir ve kapsamı, son kullanıcı yerine ajanı doğrulamayı içerir.
- Kimlik bilgileri: bu çağrıdan hangi hesap sorumludur? Bu, sizin verdiğiniz ve yönettiğiniz API anahtarı, token veya oturumdur.
- Yetkilendirme: bu çağıran bu belirli şeyi yapmaya yetkili mi? Bu, sizin izin modelinizdir.
Doğrulanmış bir ajan, otomatik olarak yetkili bir ajan değildir. Geçerli bir imza, bir kişinin otoriteyi ajana devrettiğini kanıtlamaz ve talep edilen eylemi güvenli hale getirmez. Proof of Actor size ilk soru için güvenilir bağlam sağlar ve ikinci ile üçüncü soruyu tam da ait oldukları yerde bırakır: uygulamanızda. ajan yetkilendirmesi ve kanıtın neleri kanıtlayıp neleri kanıtlayamayacağı hakkında Detection & Limitations bölümünde daha fazla okuyun.
Unknown bir özellik, bir başarısızlık değildir
İstek imzalama isteğe bağlıdır ve imzasız bir istemci kendini istediği gibi tanımlayabilir. Her isteği zorla Human veya Agent'a sokan bir sistem, zaman zaman kendinden emin biçimde yanlış olur ve bunu ne zaman yaptığını siz bilmezsiniz.
Proof of Actor, kanıt bir belirlemeyi desteklemediğinde Unknown raporlar. Unknown hiçbir zaman Human'a dönüştürülmez ve varsayılan olarak hiçbir zaman kötü niyetli sayılmaz. Politikanız, her rota için Unknown'ın ne anlama geldiğini tanımlar: genel okumalarda buna izin verin, hesap değişikliklerinde mevcut kontrollerinizi koruyun, riskin yüksek olduğu yerlerde bunu inceleme kuyruğuna alın. Unknown'ı görünür tutmak, diğer sınıflandırmalarınızı güvenilir kılan şeydir. Bilinmeyen trafiği ele alma rehberi bunun için nasıl tasarım yapılacağını gösterir.
Yapay zeka ajanı tanımlama yığınınızda nereye oturur
Proof of Actor, mevcut gateway, kimlik doğrulama ve oran sınırlama katmanınızın yanında yer alır. Bunların hiçbirinin yerini almaz. Yaygın yerleşimler şunlardır:
- Sunucu tarafı ara katmanı, rota işleyicilerinizin önünde, böylece iş mantığınız çalışmadan önce her istek değerlendirilir.
- Uçta, böylece istekler kaynağınıza ulaşmadan önce sinyaller değerlendirilir.
- Genel bir HTTP entegrasyonu, böylece herhangi bir yığın istek bağlamı gönderebilir ve dayanağı olan bir sonuç alabilir.
Entegrasyonlar, kurulum sırasında her kurucu ekiple birlikte uygulamalı olarak teslim edilir, böylece yol mimarinize uyar, tersi değil. geliştirici merkezi bugün mevcut olan entegrasyon yollarını gösterir. Ajanlar için araç çalıştırıyorsanız, MCP Servers kullanım alanı araç çağrıları için özel kalıpları kapsar.
Gözlem modunda başlayın
Proof of Actor'ı kurmak, API'nizin nasıl yanıt verdiğini değiştirmez. Sonuçlar kaydedilir, böylece ekibiniz bunları zaten bildiğiniz sonuçlarla karşılaştırabilir, ajanların gerçekte nereye gittiğini görebilir, her rotadaki Unknown oranını ölçebilir ve yanlış görünen herhangi bir sınıflandırmayı inceleyebilir. Ancak bundan sonra, kanıtın desteklediği her rota için bir politikayı etkinleştirirsiniz.
Yapay zeka ajanı tanımlamayı, müşterilerinizi şaşırtmadan veya onların bağlı olduğu entegrasyonları bozmadan böyle yayına alırsınız. aktör farkındalığına sahip politikaları güvenli biçimde yayına alma rehberi, süreci adım adım anlatır.
Kurucu geliştirici programına katılın
Proof of Actor, küçük bir kurucu geliştirme ekipleri grubuyla özel beta aşamasındadır. Seçilen ekipler, kurulum sırasında üzerinde anlaşılan kullanım sınırları dahilinde en fazla 12 ay ücretsiz erişim ve mühendislerimizden doğrudan entegrasyon desteği ile birlikte, bundan sonra ne inşa edeceğimizi şekillendirmede gerçek etki elde edebilir.
Bir API işletiyor ve onu kimin gerçekten çağırdığını bilmek istiyorsanız, erken erişim için başvurun. Bize API'nizden, en çok önem verdiğiniz rotalardan ve aktör bağlamıyla farklı karar vereceğiniz konulardan bahsedin. Proof of Actor'ın nasıl uyduğunu size anlatalım.
Kaynaklar
- RFC 9421: HTTP Message Signatures, IETF, February 2024.
- Web Bot Auth (webbotauth) çalışma grubu tüzüğü, IETF.