Click: uygulamanız için API tabanlı yapay zeka ajanı

Click ne işe yarar? Basit bir açıklama

Click, geliştiricilerin kendi uygulamalarına yapay zeka ajanı eklemesi için yönetilen bir API sunar. Model anahtarını, talimatları ve izin verilen araçları siz sağlarsınız. Click model ve araç çağrılarını yürütür, konuşma geçmişini saklar ve yürütmenin kurtarılmasını yönetir. Uygulamanız sonuçları API, olay akışı veya webhook ile alır.

Örneğin ürününüzdeki bir yardımcı, satış CSV dosyasını analiz edip rapor oluşturabilir. Kullanıcı arayüzü, verilere erişim ve onaylar uygulamanızda kalır; Click ajanın çalışmasını sağlar. Click AI Labs, Inc. tarafından işletilen hizmet, çok adımlı ve arka planda süren işler için uygundur. Backend entegrasyonu ve sonuç kontrolü gerekir.

İlk yapay zeka ajanını API ile kurma

1. Click platform API anahtarı ve desteklenen bir model sağlayıcısının anahtarını hazırlayın. Belgeler kaynak oluşturma veya değiştirme öncesinde kart doğrulaması ister; mevcut hesaplar için istisna olabilir. Doğrulama ücret almaz veya ücretli abonelik başlatmaz.
2. Model anahtarını POST /credentials ile kaydedip dönen kimliği saklayın. Her iki anahtarı backend tarafında tutun.
3. GET /models ile sağlayıcıya uygun modeli seçin.
4. POST /agents ile model, talimatlar ve araç izinlerini tanımlayın. latest_version.id değerini kaydedip POST /sessions ile oturum açın.
5. Görevi POST /sessions/{session_id}/submissions adresine gönderin. request_id, yeniden denemede ilk gönderimin dönmesini sağlar.
6. done, cancelled veya failed durumunu bekleyin. Başarılıysa belirtilen yanıt kaydını, diğer durumlarda nedeni okuyun.

HTTP 202, girdinin kaydedildiğini gösterir; görevin tamamlandığını göstermez. Oturum kimliğini belge veya destek kaydıyla ilişkilendirerek takip sorularında aynı geçmişi kullanabilirsiniz.

Kendi araçlarınızı ve dosya işlerini bağlama

Click, MCP Streamable HTTP sunucularına ve özel HTTP uçlarına herkese açık HTTPS üzerinden bağlanır. Bağlantıyı oluşturduktan sonra araçlara açıkça izin verin. HTTP araçları argümanları JSON Schema ile tanımlar ve JSON POST alır; belgelenen zaman aşımı 120 saniyedir.

Müşteri kaydı okuyan bir uç, yalnız ilgili kullanıcıya ait kısa ömürlü bir belirteci doğrulayabilir. Son kullanıcı kimlik doğrulaması, bütçeler, onaylar ve iş kuralları uygulamanızın sorumluluğundadır.

Yerleşik yetenekler web araması, tarayıcı otomasyonu ve sandbox içinde dosya veya kabuk işlemlerini kapsar. Belgelerde Blaxel, Daytona ve kendi Browserbase kimlik bilgilerinizi kullanma seçenekleri de vardır. Harici sağlayıcıların koşul ve ücretlerini ayrıca inceleyin.

Dosya işlerinde Click tarafından yönetilen sandbox kullanın: POST /files ile yükleyin, dosya kimliğini göreve ekleyin ve ajanın publish_file ile çıktıyı yayımlamasını sağlayın. Sonra artifacts listesini ve GET /files/{file_id} indirmesini kullanın. Sandbox çalışma dosyası kalıcı teslimatla aynı değildir; yayımlanan içeriği kontrol edin.

Uzun görevlerde ilerleme ve sonuç takibi

GET /sessions/{session_id}/events önce tam snapshot, ardından metin, araç ve durum değişiklikleri gönderir. Yeniden bağlanınca yerel durumu yeni snapshot ile değiştirin. Akışın kopması işi durdurmaz; oturum standby durumuna geçtiğinde akış kapanır.

Arka plan sonuçları için imzalı submission.updated ve artifact.created webhook’ları kaydedilebilir. Bildirimden sonra ilgili kaynağın güncel durumunu okuyarak uygulamanızı güncelleyin.

Ücretsiz planın sınırları ve Pro maliyeti

3 Kasım 2026 tarihinde resmî fiyat sayfasında doğrulanan aylık USD tutarları aşağıdadır. Bunlar TL fiyatı veya vergiler dahil yerel toplam değildir.

• Free: 0 USD/ay. İki eşzamanlı yerleşik oturum, 100 MB dosya alanı; aylık bir saat yönetilen sandbox, bir saat tarayıcı ve 100 arama.
• Pro: 199 USD/ay. 50 eşzamanlı yerleşik oturum, 10 GB alan; aylık 100 saat sandbox, 100 saat tarayıcı ve 5.000 arama.
• Enterprise: özel fiyat ve kapasite.

BYOK kendi model anahtarınızı kullanmanız demektir; model sağlayıcısının ücretini ayrıca hesaplayın. Kendi harici hizmetleriniz de ayrıca ücret alabilir. Depolama güncel kapasitedir, her ay eklenen alan değildir. Yönetilen kotalar tenant genelinde paylaşılır. Free UTC takvim ayını, Pro ödenmiş faturalama dönemini izler.

Runtime sahibi aktif ve boşta oturumlar eşzamanlılığa dahildir; standby hariçtir. Kota tükenince araç erişimi reddedilebilir ve işler durabilir. Belgeler otomatik aşım ücreti olmadığını belirtir.

Veriler, anahtarlar ve uygulama izinleri

Gizlilik bildirimi, talimatları, mesajları, dosyaları, araç isteklerini ve kimlik bilgilerini kapsar. Görevi yürütmek için model ve araç sağlayıcılarına veri aktarılabilir; onların politikaları da uygulanabilir.

Click ekibi başlangıç desteği, destek, hata incelemesi ve iyileştirme için içeriğe erişebilir. Saklama makul ihtiyaçlara bağlıdır; tek bir sabit süre verilmez. Veriler ABD ve başka ülkelerde işlenebilir. Türkiye’de barındırma, sıfır saklama veya genel bir eğitimde kullanmama garantisi çıkarılamaz.

Gizli bilgileri mesaj veya dosyaya değil, belirtilen kimlik bilgisi ayarlarına girin. Politika, yüksek derecede hassas düzenlemeye tabi verilerin gönderilmemesini ister.

Sık sorulan sorular

Click ücretsiz kullanılabilir mi?

Free sınırları içinde evet. Model sağlayıcısının ayrı ücreti olabilir ve kaynak oluşturmak genellikle kart doğrulaması gerektirir.

Model için kendi API anahtarım gerekir mi?

Evet. Resmî akış sağlayıcı anahtarını kaydeder ve GET /models ile uyumlu modeli seçer. Click ve model anahtarlarının görevleri farklıdır; ikisi de backend’de kalmalıdır.

Kendi araçlarımı ajana nasıl bağlarım?

MCP veya açık izin verilmiş HTTPS araçlarıyla bağlayabilirsiniz. Müşteri erişimi ve önemli işlemlerin iş onayı uygulamanızda uygulanmalıdır.

Resmî geliştirici kaynakları

• API başvurusu: araç, olay, webhook ve dosya sözleşmeleri.
• Hızlı başlangıç: ilk ajan ve oturum kurulumu.
• Hizmet koşulları ve destek: barındırılan hizmet koşulları ve resmî destek yolu.