Özetle (TL;DR): Pokee yapay zekâ aracıları (agents), Pokee Enterprise API üzerinden çalışır: her müşteriye (tenant), bir aracının tek bir turda 90 dakikaya kadar çalışabileceği özel ve kalıcı bir yalıtılmış alan (sandbox) tahsis edilir. Bu alan; kapsamı belirlenmiş dosya erişimi, yüklenen beceriler (skills), .pokee/ persona dosyaları ve oturumlar arasında korunan bir bellek sunar. API aracıyı çalıştırır; ancak ekibinizin bu işleri atayabileceği, ilerlemeyi takip edebileceği ve çıktıları kullanıma sunmadan önce inceleyebileceği bir alana ihtiyacı vardır.
Pokee, basit bir sohbet penceresine sığmayacak görevler için geliştirilmiştir: örneğin on sayfalık bir pazar raporu ya da neredeyse bir saat süren kapsamlı bir araştırma. Kimse 90 dakikalık bir turun başında oturup beklemez; bu yüzden birinin görevi üstlenmesi, kontrol etmesi ve tamamlanıp tamamlanmadığını onaylaması gerekir. Eğer kodlama aracılarınızı zaten tek bir pano üzerinden yönetiyorsanız, bu çalışmaların yürütüleceği yer Sharkly olabilir; detaylara aşağıda değineceğiz.
Pokee AI nedir?
Pokee, Enterprise API'si "özel ve kalıcı bir yalıtılmış alanda uzun soluklu, aracı odaklı iş akışlarını çalıştırmaya yönelik bir REST API" olarak tanımlanan bir aracı platformudur. Her müşteriye özel bir çalışma alanı, bir yetkilendirme belirteci (bearer token) ve https://your-tenant.enterprise.pokee.ai gibi bir adreste oturumlar, dosyalar, beceriler ve anlık akış mesajları için uç noktalar (endpoints) sağlanır. Erişim yalnızca kurumsal düzeydedir: Pokee dokümantasyonu yeni müşterileri "Demo Talep Et" seçeneğine yönlendirir; self-servis veya ücretsiz bir katmandan bahsetmez.
Modeller ve fiyatlandırma sayfasında iki model katmanı listelenmiştir:
| Model | Girdi ($/M token) | Çıktı ($/M token) | Önbellek okuma ($/M token) |
|---|---|---|---|
pokee-isaac-high-reasoning |
$3 | $15 | $0.30 |
pokee-isaac |
$0.30 | $5 | $0.10 |
Yeni müşteriler için varsayılan olarak yüksek akıl yürütme (high-reasoning) katmanı belirlenir. Model seçimi oturum oluşturulurken kilitlenir; bu nedenle o oturumdaki her tur aynı katmanda çalışır.
Pokee aracı modeli: Oturumlar, yalıtılmış alan, dosyalar, beceriler ve bellek
Pokee'nin aracı modeli, yapılandırabileceğiniz beş bileşenden oluşur ve her biri ekibin alması gereken bir karara karşılık gelir.
- Oturumlar (Sessions). Bir oturum, size ayrılmış pod içerisindeki bağımsız yalıtılmış alanında çalışan; kendi geçmişine, dosya kapsamına ve meşguliyet durumuna sahip tek bir aracı sürecidir.
- Kalıcı mod (Persistent mode). Varsayılan bir oturum, son yanıtından 5 dakika sonra kendini imha eder.
persistent: trueolarak ayarlandığında ise TTL süresi (varsayılan olarak 4 saat) dolana veya siz silene kadar etkin kalır. - Kapsamı belirlenmiş dosya erişimi (Scoped file access). Oturum oluşturulurken
read(okuma) vewrite(yazma) yollarını belirlersiniz. Kapsam dışındaki yollar, aracının dosya sisteminde hiç var olmamış gibi görünür. - Beceriler (Skills). Kök dizininde bir
SKILL.mdbulunan bir zip dosyası yüklersiniz. Müşteri alanındaki her yeni oturum bu beceriyi görebilir. - Persona dosyaları ve bellek.
.pokee/dizinindeki Markdown dosyaları sistem isteminin (system prompt) başına eklenir;.memory/MEMORY.mdise bilgileri oturumlar arasında taşır.
Pokee dosya erişim kapsamını nasıl sınırlandırır?
Erişim kapsamı iki aşamalı olarak denetlenir. Aracının içinde, oturum bazlı bir bubblewrap bağlama ad alanı (mount namespace), izin verilen dizinler dışındaki her şeyi gizler; bu nedenle harici bir okuma isteği ENOENT hatası döndürür. HTTP dosya API'si üzerinden yapılan aynı istek ise 403 Forbidden yanıtı verir.
Kapsamlı dosya erişimi kılavuzu, bir müşterinin klasörünü ve paylaşılan şablonlar klasörünü okuyabilen, ancak yalnızca ilgili müşterinin çıktı klasörüne yazabilen bir oturumu şu şekilde göstermektedir:
curl -X POST "$POKEE_API/v1/sessions" \
-H "Authorization: Bearer $POKEE_KEY" \
-H "Content-Type: application/json" \
-d '{
"persistent": true,
"ttl": 14400,
"metadata": {"board_task": "COIN-412", "client": "acme-corp"},
"file_access": {
"read": ["projects/acme-corp", "shared/templates"],
"write": ["projects/acme-corp/output"]
}
}'
Yetki kapsamı, oturumun ömrü boyunca değiştirilemez. Kapsamı genişletmek için mevcut oturumu sonlandırıp yenisini oluşturmanız gerekir. Bu yaklaşım hem uyumluluk (compliance) süreçlerini kolaylaştırır hem de ekibin net bir karar almasını sağlar: dosya kapsamını işin ortasında değil, görevi atarken belirleyin.
.pokee/ persona dosyaları ve bellek ne işe yarar?
workspace/.pokee/*.md altındaki dosyalar, alfabetik sırayla ve her biri bir ## <dosya-adı> başlığı altında sistem istemine yüklenir. Persona kılavuzunda üslup için 00_soul.md, sektörel terimler için 10_glossary.md ve biçimlendirme kuralları için 20_style_guide.md dosyaları kullanılmaktadır. Dizin genelindeki toplam boyut sınırı 1 MB'tır.
Yapılan değişiklikler bir sonraki oturumda devreye girer; çalışan bir oturum mevcut istemini korur. Aracı ayrıca her oturumda .memory/MEMORY.md dosyasını okur ve günceller. Bu dosyayı dosya API'si üzerinden düzenleyebilir ya da aracı bağlamı sayfasında belirtildiği gibi Pokee'den bu özelliği devre dışı bırakmasını talep edebilirsiniz.
Uzun süre çalışan yapay zekâ aracıları ekipler için ne anlama geliyor?
Uzun soluklu yapay zekâ aracıları, bir ekibin çalışma düzeninde üç kritik noktayı değiştirir: işi kimin başlattığı, ilerlemenin nasıl takip edildiği ve nihai onayı kimin verdiği. Pokee’nin varsayılan sınırları bu aşamaların her birini somutlaştırmaktadır.
| Sınır | Varsayılan |
|---|---|
| Eşzamanlı oturum | 10 |
| Tur zaman aşımı | 90 dakika |
| Oturum TTL süresi | 4 saat |
| Saatlik / günlük tur sayısı | 300 / 5.000 |
| Saatlik / günlük token sayısı | 20M / 200M |
| Maksimum çalışma alanı boyutu | 100 GB |
Pokee, talep üzerine bu sınırların herhangi birinin artırılabileceğini belirtmektedir.
90 dakikalık bir aracı görevini kim atar?
On eşzamanlı oturum kulağa oldukça yeterli gelebilir; ta ki pazartesi sabahı beş kişi aynı anda ikişer rapor süreci başlatana kadar. Üstelik meşgul bir oturum, ikinci bir mesaj geldiğinde 409 hatası vererek isteği reddeder. Bu yüzden birisinin görevi, model katmanını, dosya kapsamını ve oturumu belirleyip bunu sorumlusu belli bir görev kaydı olarak tanımlaması gerekir. Böylece iki kişinin aynı 90 dakikalık süreci mükerrer olarak başlatması engellenir.
Uzun süren bir aracı turunun ne yaptığını nasıl takip edersiniz?
İstemci bağlantınız kopsa bile aracı arka planda çalışmaya devam eder. Uzun süren görevler kılavuzu, busy bayrağını denetlemek için her 15 saniyede bir GET /v1/sessions/{id} sorgusu yapar, iş akışının metadata içerisine yazdığı ilerleme verilerini okur ve işlem bittiğinde çıktı dosyasını indirir.
while True:
s = c.get(f"/v1/sessions/{sid}").json()
if not s["busy"]:
break
print(f"metadata: {s['metadata']}")
time.sleep(15)
Veri akışının kendisi Server-Sent Events altyapısını kullanır; message.created, message.completed, message.error ve message.cancelled olaylarını yayınlar. Yeniden bağlanma uç noktası, kesilen bir akışı Last-Event-ID üzerinden, token'ları yeniden faturalandırmadan sürdürür. Bu mekanizma betiğinize turun tamamlandığını bildirir; ancak raporun nitelik olarak başarılı olup olmadığını söyleyemez.
Çıktıyı kullanıma sunmadan önce kim inceler?
Pokee, elde edilen dosyayı çalışma alanına yazar. İnceleme ise API'nin dışında gerçekleşen insani bir adımdır: birisi report.md dosyasını açar, verilen talimatlara uygunluğunu denetler ve onaylar ya da revize edilmek üzere geri gönderir. Paralel yürütülen aracı süreçlerinde asıl darboğaz genellikle bu adımdır; nitekim insan denetimi darboğazdır başlıklı yazıda savunulan temel tez de budur.

Örnek vaka: Görev atamasından incelemeye bir müşteri raporu
Üç kişinin aynı Pokee müşteri alanını paylaştığını varsayalım. Teslim edilecek iş ise "Acme Corp." için hazırlanacak üç aylık pazar raporudur.
- Atama. Dana bir görev açar: "Acme için 3. Çeyrek pazar raporu", sorumlu Dana, inceleyen Sam, teslim tarihi Perşembe.
- Kapsam belirleme. Görevde Pokee modeli (
pokee-isaac-high-reasoning), okuma yolları (projects/acme-corp,shared/templates) ve yazma yolu (projects/acme-corp/output) tanımlanır. - Başlatma. Dana,
metadataiçerisine görev kimliğini ekleyerek kalıcı bir oturum oluşturur; ardından raporunoutput/report.mdkonumuna yazılmasını isteyen tek bir mesaj gönderir. - Takip. Oturum kimliği görev yorumuna eklenir.
GET /v1/sessions/{id}uç noktasını sorgulayan herkes, tur tamamlanana kadarbusy: truedurumunu görür. - Toplama.
busydeğeri false'a döndüğünde Dana dosyayı indirir ve göreve ekler. - İnceleme. Sam raporu brief'e göre inceler. Eksikler varsa yorum eklenerek yeni bir tur başlatılır; uygunsa görev bir sonraki aşamaya taşınır.
- Temizlik. Dana oturumu siler veya her gece çalışan bir
DELETE /v1/sessions?status=idle&older_than=1htemizlik komutu oturumu kaldırır.
1, 4 ve 6. adımlar birer API çağrısı değildir. Bunlar koordinasyon adımlarıdır; aracı hızlı çalıştığında ekiplerin atladığı, ancak süreç bir saat sürdüğünde eksikliğini hissettiği aşamalardır.
Sharkly, Pokee aracı çalışmalarının neresinde yer alır?
Sharkly bir aracı iş yönetim platformudur: görevlerin hem İnsanlara hem de Aracılara atandığı, çalıştırmaların takip edildiği ve çıktıların insan incelemesini beklediği tek bir panodur. Pokee oturumlarını sizin yerinize çalıştırmaz ve doğrudan bir Pokee bağlayıcısı bulunmaz. Ancak görevi, sorumlusunu, durumunu ve tüm bunların etrafındaki inceleme sürecini bir arada tutar.
Pratikte bu süreç şöyle işler:
- Görev Atama. Pokee görevi, panoda bir Sorumlu ve durum bilgisiyle, diğer tüm ekip işlerinin yanında yer alır. Sorumlulukların neden açıkça tanımlanması gerektiğini aracı odaklı ekipler (agentic teams) yazımızda bulabilirsiniz.
- API'yi yöneten bir Aracı. Bir Sharkly Aracısı, Claude Code gibi bir Çalışma Zamanı (Runtime) aracılığıyla kendi Bilgisayarınızda çalışır. Ona yukarıdaki curl çağrılarını kapsayan bir beceri kazandırdığınızda; oturumu oluşturabilir, durumu sorgulayabilir ve oturum kimliği ile sonucu göreve geri bildirebilir.
- Pokee ile uyumlu çalıştırma sınırları. Her Aracının Çalıştırma ayarları vardır: atanan görevler için maksimum eşzamanlılık, görev başına maksimum çalışma süresi ve kuyruk zaman aşımı. Aşağıdaki Aracı 1 görev ve 40 dakika ile sınırlandırılmıştır; Pokee işleri için eşzamanlılığı 10 oturumluk sınırınızda veya altında tutabilir, çalışma süresini 90 dakikalık turu kapsayacak şekilde ayarlayabilir ya da Aracının turu başlatıp daha sonra kontrol etmesini sağlayabilirsiniz.

- Mesaj yerine durum olarak inceleme. Bir Aracı, görevi insan incelemesini bekler durumda bırakabilir ve bu görev doğrudan inceleyenin Gelen Kutusuna düşer. Bu denetim noktalarının nereye konulması gerektiği, döngüde insan bulunan kodlama aracıları ve kodlama aracıları için onay kapıları yazılarında ele alınmaktadır.
- Dış tetikleyiciler. Bir Sharkly Otomasyonu bir webhook tetikleyicisi alabilir: harici bir servis bu gizli URL'ye POST isteği gönderdiğinde bir çalıştırma başlatılır. Pokee turu tamamlandığında kendi betiğiniz bu adresi çağırabilir.
Sharkly'yi kullanmaya başlamak ücretsizdir ve model kullanımı zaten ödeme yaptığınız mevcut hesaplarınızda kalır. Uzun süren işlerin incelenmesi modelini daha ayrıntılı incelemek için milyon token'lık aracı çalışmaları bir inceleme kuyruğuna ihtiyaç duyar yazısını okuyabilirsiniz.
Pokee ne zaman uygundur, ne zaman değildir?
Göreviniz bir kod değişikliğinden ziyade bir belge veya veri kümesi üretiyorsa, dakikalar ile bir saat arasında sürüyorsa ve kalıcı bir yalıtılmış alana ihtiyaç duyuyorsa Pokee'yi tercih edin. "Aracı kesinlikle B müşterisinin verilerini görmemelidir" koşulunun sözleşmeye bağlı bir zorunluluk olduğu durumlarda biçilmiş kaftandır; çünkü erişim kapsamı doğrudan dosya sistemi düzeyinde denetlenir. Platformun çevrimdışı modu (offline mode), dış dünyayla tek bağlantısı model API'si olan tamamen yalıtılmış bir müşteri ortamı sağlar.
Bir satış görüşmesi yapmadan hemen bugün başlamak istiyorsanız başka çözümlere yönelmelisiniz. Kendi depolarınızda kodlama yapmak için kendi Bilgisayarlarınızda çalışan Claude Code veya Codex çok daha doğrudan bir uyum sağlar. Birçok ekip her ikisini birden kullanacaktır; bu da tüm bu süreçleri üstte tek bir panoda birleştirme ihtiyacını doğurur.
Sonuç
Pokee AI aracıları, ekiplere gerçek bir yalıtımla uzun süre çalışan iş süreçleri sunar. API "tur tamamlandı mı?" sorusuna yanıt verir. İşi kimin başlattığı, aracının hangi dosyalara dokunduğu ve çıktının doğruluğu sorularını yanıtlamak ise yine ekibinize düşer.
İlk oturumu başlatmadan önce bu üç yanıtı bir göreve bağlayın. Hem Pokee süreçlerinizi hem de kodlama aracılarınızı tek bir panoda buluşturmak istiyorsanız, hemen bir Sharkly çalışma alanı açın ve bu hafta uzun soluklu ilk görevinizi bir Aracıya atayın.
Sıkça Sorulan Sorular (SSS)
Pokee Enterprise API nedir?
Pokee Enterprise API, müşteri başına özel ve kalıcı bir yalıtılmış alanda uzun soluklu aracı iş akışlarını çalıştırmaya yönelik bir REST API'dir. Bir yetkilendirme belirteci (bearer token) ile kimlik doğrulaması yaparak oturumlar, dosyalar, beceriler, anlık akış mesajları ve kullanım verileri için uç noktalara erişim sağlarsınız.
Bir Pokee aracısı ne kadar süre çalışabilir?
Tek bir tur varsayılan olarak 90 dakikaya kadar, bir oturum ise 4 saate kadar çalışabilir; her iki süre de talep üzerine artırılabilir.
Pokee AI ücretsiz mi?
Dokümantasyonda ücretsiz bir katmandan bahsedilmemektedir. Erişim demo talebiyle sağlanır ve kullanım token başına ücretlendirilir: pokee-isaac-high-reasoning modelinde milyon token başına 3$ girdi ve 15$ çıktı; pokee-isaac modelinde ise 0,30$ girdi ve 5$ çıktı olarak fiyatlandırılır.
İki kişi aynı Pokee oturumuna mesaj gönderirse ne olur?
İkinci mesaj 409 hatası alır: Oturum başka bir mesajla meşguldür. Her oturum aynı anda yalnızca tek bir turu işleyebilir; bu nedenle eşzamanlı çalışmalar için varsayılan sınırı 10 olan ayrı oturumlar kullanılmalıdır.
Bir Pokee aracısı oturumlar arasında bilgi hatırlayabilir mi?
Evet. Her oturumda workspace/.memory/MEMORY.md dosyasını okur ve günceller; bu dosya pod yeniden başlatılsa dahi silinmez.
Sharkly, Pokee aracılarını doğrudan çalıştırabilir mi?
Hayır. Sharkly'nin doğrudan bir Pokee bağlayıcısı yoktur. Bilgisayarınızdaki bir Sharkly Aracısı bir beceri üzerinden Pokee API'sini çağırabilir; Sharkly görevi ise görev atamasını, durumu ve insan denetimini koordine eder.



