Ekipler İçin Pokee Yapay Zeka Ajanları: Uzun Süreli Görevlerin Atanması ve İncelenmesi

Pokee AI ajanları; kapsamı belirlenmiş dosyalar, beceriler ve bellek ile kalıcı bir sandbox ortamında 90 dakikalık turlar hâlinde çalışır. Bir ekibin bu çalışmaları nasıl atadığı, takip ettiği ve gözden geçirdiği.

Aiden Flux

Aiden Flux

5 Kasım 2026

Ekipler İçin Pokee Yapay Zeka Ajanları: Uzun Süreli Görevlerin Atanması ve İncelenmesi

Ö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.

  1. 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.
  2. Kalıcı mod (Persistent mode). Varsayılan bir oturum, son yanıtından 5 dakika sonra kendini imha eder. persistent: true olarak ayarlandığında ise TTL süresi (varsayılan olarak 4 saat) dolana veya siz silene kadar etkin kalır.
  3. Kapsamı belirlenmiş dosya erişimi (Scoped file access). Oturum oluşturulurken read (okuma) ve write (yazma) yollarını belirlersiniz. Kapsam dışındaki yollar, aracının dosya sisteminde hiç var olmamış gibi görünür.
  4. Beceriler (Skills). Kök dizininde bir SKILL.md bulunan bir zip dosyası yüklersiniz. Müşteri alanındaki her yeni oturum bu beceriyi görebilir.
  5. Persona dosyaları ve bellek. .pokee/ dizinindeki Markdown dosyaları sistem isteminin (system prompt) başına eklenir; .memory/MEMORY.md ise 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.

Uzun soluklu bir Pokee aracı görevinin yaşam döngüsü: Panoda atanır, kapsamı belirlenmiş dosyalarla oturum oluşturulur, yalıtılmış alanda 90 dakikalık bir tur çalışır, çıktı dosyası yazılır ve teslim edilmeden önce insan incelemesinden geçer.

Ö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.

  1. Atama. Dana bir görev açar: "Acme için 3. Çeyrek pazar raporu", sorumlu Dana, inceleyen Sam, teslim tarihi Perşembe.
  2. 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.
  3. Başlatma. Dana, metadata içerisine görev kimliğini ekleyerek kalıcı bir oturum oluşturur; ardından raporun output/report.md konumuna yazılmasını isteyen tek bir mesaj gönderir.
  4. Takip. Oturum kimliği görev yorumuna eklenir. GET /v1/sessions/{id} uç noktasını sorgulayan herkes, tur tamamlanana kadar busy: true durumunu görür.
  5. Toplama. busy değeri false'a döndüğünde Dana dosyayı indirir ve göreve ekler.
  6. İ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.
  7. Temizlik. Dana oturumu siler veya her gece çalışan bir DELETE /v1/sessions?status=idle&older_than=1h temizlik 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.
Bir Sharkly Aracısındaki çalıştırma ayarları: Atanan görevler için maksimum eşzamanlılık, görev başına maksimum çalışma süresi ve kuyruk zaman aşımı.
  • 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.

Daha fazlasını keşfedin

AI Ajan Yönetişimi: Sandbox Onay Yerine Geçmez

AI Ajan Yönetişimi: Sandbox Onay Yerine Geçmez

Ekibinizin çalıştırdığı kodlama ajanları için yapay zeka ajan yönetişimine ihtiyacınız mı var? Codex ve Docker sandbox'larının sınırları nasıl belirlediğini, her çalıştırmayı kimin sahiplendiğini ve incelediğini görün.

20 Kasım 2026

Açık kaynak Slack alternatifi: ExitPath Slack'ten ayrılmanıza nasıl yardımcı olur?

Açık kaynak Slack alternatifi: ExitPath Slack'ten ayrılmanıza nasıl yardımcı olur?

Açık kaynaklı bir Slack alternatifi mi arıyorsunuz? ExitPath'in Mattermost, Zulip veya Element'e geçişle ilgili söylediklerine göz atın ve agent çalışmalarınızın kaybolmasını önleyin.

20 Kasım 2026

GPT-6.2 Astra vs Fable 5.2: İkisini de Kendi Reponuzda Test Edin

GPT-6.2 Astra vs Fable 5.2: İkisini de Kendi Reponuzda Test Edin

GPT-6.2 Astra vs Fable 5.2: kodlama ajanlarınızı hangisi çalıştırmalı? Aynı fiyatlı tokenların faturayı nerede böldüğünü görün ve ikisini kendi reponuzda test edin.

20 Kasım 2026