AI agent'ı API olarak nasıl yayınlarsın?
Bir AI agent'ı API olarak yayınlamak, onu bir runtime'a taşıyıp HTTP endpoint'i arkasına koymaktır: auth için API key, kötüye kullanıma karşı rate limit, hesap verebilirlik için audit log gerekir. Bu sayfa genel mimariyi anlatır. Ilura'da yol farklı: agent'ın bir endpoint kazanmaz — iPhone'unda yaşar, hayatına Siri ve Kısayollar üzerinden bağlanır.
01Kimler için?
API yayını şu durumlarda gündeme gelir:
- Kendi ürününe AI yetenek katacak geliştiriciler. Agent'ı kendi backend'inden çağırmak isteyenler.
- Otomasyon kuran profesyoneller. Cron job, webhook veya script içinden agent çağrısı.
- İç araç çıkaran ekipler. Slack bot, web UI, CLI — hepsi aynı endpoint'i hedef alır.
02Nasıl çalışır?
Genel mimaride dört aşama var:
- Runtime. Agent tanımı (system prompt, araçlar, bellek) bir sunucu ortamına taşınır — kendi backend'in, bir bulut fonksiyonu veya yönetilen bir agent platformu.
- Endpoint + auth. Agent bir URL kazanır; çağrılar API key veya OAuth ile doğrulanır. Anonim erişim kapalı tutulur.
- Rate limit + maliyet kontrolü. Her çağrı LLM maliyeti üretir; istek başına token bütçesi ve kullanıcı başına kota standarttır.
- Audit + izleme. Hangi çağrı hangi kararı verdi — log'lanır. Latency, hata oranı ve token maliyeti izlenir.
03Ilura ile nasıl yapılır?
Ilura'da agent'ın bir API ürünü değil. Tekrarladığın roller için iPhone'unda kişisel bir agent — bir iş arkadaşı — yetiştirirsin. Yol şöyle:
- Agent'ın iPhone'unda yaşar. Onu serada yetiştirir, playbook'larla öğretirsin; düzeltmelerin tercih, rutin ve karar kuralına dönüşür. Bir endpoint'e push etmezsin.
- Sen çağırıp kullanırsın. Agent'ın sen çağırınca çalışır, çıktıyı sen onaylarsın. Desteklenen yerde Siri ile sesli çağırır, Kısayollar ile sabah özetin ve hatırlatmaların ona bağlarsın. Ilura arka planda kendi başına başka uygulamaları yönetmez; otonom kontrol iddia etmez. API'nin yerini bu bağ alır.
- Apple Intelligence cihaz-üstü. Çağrıların bir bulut runtime'a inmez; verin iPhone'undan çıkmaz.
Agent'ını uçtan uca kurmak için: kendi AI agent'ını yetiştir.
04Sık sorulan sorular
Her agent API olarak yayınlanmalı mı?
Hayır. API, agent'ı başka yazılımların çağırması gerekiyorsa anlamlıdır. Kişisel kullanımda daha doğal yol, agent'ı kendi cihazında ve asistan katmanında yaşatmaktır — Ilura'da Siri ve Kısayollar.
API yayını için neler şart?
Dört şey: auth (API key veya OAuth), rate limit, token bütçesi ve audit log. Bu dördü olmadan açılan bir agent endpoint'i hem maliyet hem güvenlik riskidir.
Ilura'da agent'ımı API olarak yayınlayabilir miyim?
Hayır — Ilura'da agent bir endpoint değil. iPhone'unda yaşar; Siri ve Kısayollar üzerinden gerçek hayatına bağlanır. Apple Intelligence cihaz-üstü çalıştığı için verin telefonundan çıkmaz.
BYOK (Bring Your Own Key) nedir?
Bulut agent platformlarında LLM faturasını kendi sağlayıcı hesabından kesmek için kendi API anahtarını platforma vermen. Yönetilen anahtar modelinin alternatifidir; maliyet şeffaflığı sağlar.
Yayınlanan agent nasıl güncellenir?
Genel pratik versiyonlamadır: yeni agent tanımı yeni sürüm olarak yayına alınır, sorun çıkarsa eski sürüme dönülür. Endpoint sabit kalır, arkasındaki davranış evrilir.
05İlgili sayfalar
yanındayım — Ilura