Pokee Kurumsal API: Kalıcı Sandbox Ajanları, Fiyatlandırma ve İlk Çağrınız

Pokee Enterprise API, her müşteri için ayrılmış, kalıcı bir sandbox içinde uzun soluklu bir AI ajanı çalıştıran bir REST API'dir. Bir oturum oluşturur, bir mesaj gönderir ve ajanın yanıtını Server-Sent Events (SSE) akışı olarak okursunuz. Oturumlar dosyaları, özel yetenekleri (skill), kendi araçlarınızı ve oturumlar arasında taşınan hafızayı barındırabilir. Erişim, self-servis kayıt yerine bir Pokee demo talebi üzerinden sağlanır.

Aşağıda: oturumların ve akışların nasıl çalıştığı, ilk çağrınız, Pokee Isaac fiyatlandırması, limitler ve bir kodlama ajanının uç noktaları Apidog CLI ile nasıl test edebileceği yer alıyor. Tüm sayılar 28 Ekim 2026 tarihinde okunan Pokee dokümantasyonundan alınmıştır.

Pokee Enterprise API nedir?

Pokee Enterprise API (Pokee bunu Enterprise Responses API olarak adlandırıyor), saniyeler değil dakikalar süren ajan güdümlü iş akışları çalıştırmanızı sağlar. Her kiracı (tenant) özel bir çalışma alanı, sabit bir bearer token ve kendi alt alan adını alır: https://your-tenant.enterprise.pokee.ai. Bu çalışma alanı içinde her oturum, kendi sandbox'ında çalışan bir ajan sürecidir.

Bir sohbet çağrısı tek bir istemi yanıtlar ve unutur. Bir Pokee oturumu ise konuşmasını, dosyalarını ve meşgul durumunu korur; böylece ajan birçok tur boyunca araştırma yapabilir, dosya yazabilir ve araçları çağırabilir. Claude Managed Agents rehberimizi okuduysanız, yapı tanıdık gelecektir: sağlayıcı ajan döngüsünü ve sandbox'ı barındırır, siz de onu HTTP üzerinden yönetirsiniz.

Kiracı izolasyonu ve kurumsal ağ kontrolleri (IP izin listeleri, mTLS, AWS PrivateLink, bölge sabitleme) içeren barındırılan bir ajan isteyen ekipler için tasarlanmıştır; Pokee bunları talep üzerine sunulabilir olarak listeliyor.

Temel kavramlar: oturumlar, dosyalar, yetenekler ve hafıza

API'nin dört yapı taşı vardır.

Birkaç oturum ayrıntısı baştan önem taşıyor:

• Kalıcılık. Varsayılan olarak persistent değeri false'tur ve oturum son yanıtından 5 dakika sonra kendini yok eder. Oturumu ttl süresi dolana kadar (varsayılan 14.400 saniye, yani 4 saat) veya siz onu silene kadar korumak için true olarak ayarlayın.
• Model kilidi. Oluşturma sırasında ilettiğiniz model, o oturumdaki her tur için geçerlidir.
• Dosya kapsamı. Ajanın neleri görebileceğini kısıtlamak için read ve write yol listeleriyle birlikte file_access iletin; HTTP dosya API'si bu kapsam dışında 403 döndürür.
• Aynı anda tek tur. Bir tur çalışırken ikinci bir mesaj göndermek 409 Conflict döndürür.

İlk Pokee API çağrınızı nasıl yaparsınız

Pokee size bant dışı iki değer verir: kiracı URL'niz ve pk_<tenant>_<token> biçiminde bir anahtar. Ardından ilk çağrı üç adımdan oluşur.

1. Geçidin (gateway) ayakta olduğunu kontrol edin (kimlik doğrulama gerekmez).
2. Bir oturum oluşturun ve id değerini saklayın.
3. Bir mesaj gönderin ve SSE akışını okuyun.

export POKEE_API="https://your-tenant.enterprise.pokee.ai"
export POKEE_KEY="pk_<tenant>_<token>"

curl "$POKEE_API/health"

SID=$(curl -s -X POST "$POKEE_API/v1/sessions" \
  -H "Authorization: Bearer $POKEE_KEY" \
  -H "Content-Type: application/json" \
  -d '{"persistent": true}' | jq -r '.id')

curl -N -i -X POST "$POKEE_API/v1/sessions/$SID/messages" \
  -H "Authorization: Bearer $POKEE_KEY" \
  -H "Content-Type: application/json" \
  -d '{"message": "Summarize the files in my workspace in three bullets."}'

-i bayrağı başlıkları yazdırır. X-Response-Id değerini (msg_ artı 24 onaltılık karakter) saklayın: turu devam ettirmek veya iptal etmek için buna ihtiyacınız olacak.

Her olay üç satırdır: id:, event: ve data:. Önce message.created, ardından text.delta parçaları (ayrıca thinking.* veya tool_use.* olayları) görürsünüz ve akış message.completed, message.cancelled veya message.error ile sonlanır. SSE sizin için yeniyse, MDN'nin Server-Sent Events rehberi formatı açıklıyor ve SSE üzerinden akış yapan LLM API'lerini test etme yazımız parçaların nasıl okunacağını gösteriyor.

Araç çağırma: iki yüzey

Pokee, ajana fonksiyonlarınızı çağırması için iki yol sunar; ikisi de OpenAI tarzı fonksiyon tanımlarını kullanır.

Durumsuz yol, OpenAI Responses API için yazılmış kodun arkasına Pokee'yi yerleştirdiğinizde seçilecek yoldur, çünkü veri şekli birebir uyuşur. İstek başına 128 araca, 64 karaktere kadar araç adlarına ve 16 KiB'a kadar açıklamalara izin verir. Ayrıca reasoning.effort değerini alır (minimal, varsayılan olarak genişletilmiş düşünmeyi kapalı tutar; low, medium ve high ise açar). Çıktı varsayılan olarak 4.096 token'dır ve üst sınır 32.000'dir.

Oturum araçları, ajanın aynı tur içinde akıl yürütmesi, yetenekleri çalıştırması ve bazen sistemlerinizi çağırması gerektiğinde uygundur. Bunları oturum oluşturma sırasında kaydedersiniz.

Devam ettirme, iptal ve idempotency anahtarları

Uzun turlar, kısa çağrıların kırılmadığı şekillerde kırılır. Pokee, değişiklik günlüğüne göre 4 Mayıs 2026'da üç düzeltme ekledi.

• Devam ettirme. İstemciniz akış ortasında düşerse ajan çalışmaya devam eder. Last-Event-ID başlığıyla GET /v1/sessions/{id}/responses/{rid}/events adresine yeniden bağlanın; sunucu bir sonraki olaydan itibaren yeniden oynatır. Kapanan turlar 120 saniye boyunca erişilebilir kalır ve devam ettirmek token'ları yeniden faturalandırmaz.
• İptal. POST /v1/sessions/{id}/responses/{rid}/cancel 202 döndürür ve akış message.cancelled ile sonlanır. İptal edilen bir turdaki kısmi kullanım faturalandırılmaz. Oturum ve dosyaları yaşamaya devam eder.
• Idempotency anahtarları. Mesaj POST isteğinde Idempotency-Key: <uuid> gönderin. Aynı anahtar ve gövdeyle yapılan bir yeniden deneme, ikinci bir tur başlatmak yerine özgün yanıt kimliğini döndürür. Anahtarlar 24 saat yaşar ve aynı anahtarın farklı bir gövdeyle kullanılması 422 döndürür.

Durumsuz /v1/responses yolu, stream değeri true olduğunda bu üçünü de destekler.

Pokee Isaac modelleri ve fiyatlandırması

Pokee, modeller ve fiyatlandırma sayfasında iki Isaac kademesi yayınlıyor. Fiyatlar milyon token başınadır.

model değerini atladığınızda yeni kiracılar varsayılan olarak pokee-isaac-high-reasoning kullanır. Kimi, GPT-5.5 ve Gemini arka uçları sözleşme yoluyla kiracı bazında sunulur. Dokümantasyon ücretsiz bir kademe veya minimum sözleşme belirtmiyor; bu koşulları Pokee'ye sorun.

Ayrıca 7 Ağustos 2026'da eklenen bir Direct Isaac API var: ajan döngüsü veya araçları olmayan, OpenAI uyumlu bir POST /v1/chat/completions yolu. Kiracı bazında etkinleştirilir, yalnızca pokee-isaac kabul eder ve uzun istekleri (200.000 ve 2.000.000 token ve üzeri) otomatik olarak daha büyük bağlam havuzlarına yönlendirir. GET /v1/usage kredi bakiyenizi gösterir.

Dokümantasyondan bir güvenlik notu: kiracı bearer değeri doğrudan bir API anahtarıdır. Onu sunucunuzda veya kendi proxy'nizin arkasında tutun; asla tarayıcı, mobil veya masaüstü kodunda bulundurmayın.

Limitler ve hata kodları

Bunlar limitler ve hatalar sayfasındaki varsayılanlardır. Pokee, talep üzerine bunlardan herhangi birini yükseltebileceğini söylüyor.

En sık ele alacağınız hata kodları: 401 (hatalı veya eksik anahtar), 402 (kredi bitti, yalnızca katı kredi modunda), 403 (oturumun kapsamı dışında bir yol), 409 (oturum meşgul), 422 (idempotency anahtarı farklı bir gövdeyle yeniden kullanıldı), 429 (kullanım limiti) ve 500 (geri çekilmeli yeniden deneme). Hatalar {"error": "<name>", "message": "<detail>"} biçiminde döner.

Kodlama ajanınızın Pokee API'sini Apidog CLI ile test etmesini sağlayın

Bir oturum API'sinin sabitlenmesi gereken çok fazla sözleşmesi vardır: oluşturmada 201, bir sess_ kimliği, meşgulken 409, silmede 204, iptalde 202. Kodlama ajanınız siz çalışmaya devam ederken bu kontrolleri yazıp çalıştırabilir. Apidog CLI, Claude Code, Codex veya Cursor'a bunu yapması için komutları verir.

Bir kez kurun:

npm install -g apidog-cli@latest
apidog auth login --with-token <YOUR_APIDOG_TOKEN>
apidog skill install

Ardından ajanınıza tek bir istem verin:

Write an OpenAPI file for the Pokee Enterprise API endpoints /health,
POST/GET/DELETE /v1/sessions, /v1/sessions/{id}/responses/{rid}/cancel and
/v1/usage, import it into Apidog project <projectId>, create an environment
for my tenant URL, then add test cases that assert 201 and an id starting
with "sess_" on create, 204 on delete and a credit balance on /v1/usage.
Run them and summarize failures. Read POKEE_KEY from my shell, never a file.

Ajan spesifikasyonu içe aktarır, her yükü CLI'nin şemasına göre kontrol eder, sonra test durumlarını oluşturup çalıştırır:

apidog import --project <projectId> --format openapi --file ./pokee-openapi.json
apidog environment create pokee-tenant --project <projectId> --base-url https://your-tenant.enterprise.pokee.ai
apidog cli-schema get test-case-create
apidog cli-schema validate test-case-create --file create-session.json
apidog test-case create --project <projectId> --file create-session.json
apidog run --test-case <caseId> --project <projectId> -e <envId> --env-var "POKEE_KEY=$POKEE_KEY" -r cli,junit

Anahtarı --env-var ile iletmek, onu ajanın yazdığı hiçbir dosyada bulundurmaz. Bu test durumları JSON uç noktalarını kapsar; SSE akışının kendisini izlemek Apidog uygulamasında daha kolaydır, çünkü akış halindeki olayları işler (bkz. Apidog'da SSE testi). -r junit ile aynı apidog run komutu CI'ya girer; Apidog CLI CI/CD rehberimiz bunu gösteriyor. CLI'da yeni misiniz? Claude Code'da Apidog CLI ile başlayın. Apidog'un Ücretsiz planı 4 kullanıcıya kadar kapsar.

Sharkly nereye uyuyor

Pokee ajanları veya herhangi bir kodlama ajanı 90 dakika süren görevleri çalıştırmaya başladığında, birinin kimin ne yapacağına karar vermesi ve sonuçları kontrol etmesi gerekir. Bir log dosyasındaki oturum kimliği bir iş kuyruğu değildir. Sharkly, AI ajanlarının ve insanların işi paylaştığı bir görev panosudur: bir görevi bir ajana veya bir ekip arkadaşına atarsınız, durumunu takip edersiniz ve çıktıyı yayına girmeden önce incelersiniz. Başlaması ücretsizdir, böylece ölçeklenmeden önce panoya bir uzun ajan işi koyup incelemenin ekibinize nasıl uyduğunu görebilirsiniz.

SSS

Pokee Enterprise API için ücretsiz bir kademe var mı? Dokümantasyon böyle bir şey belirtmiyor. Erişim bir demo talebiyle başlar ve Pokee kiracı URL'nizi ve anahtarınızı bant dışı sağlar. Fiyatlandırma yukarıdaki Isaac kademelerinde token başınadır.

Pokee API'si OpenAI ile uyumlu mu? Kısmen. Durumsuz /v1/responses yolu, fonksiyon çağırma için OpenAI'nin Responses veri şekliyle uyuşur ve Direct Isaac yolu Chat Completions istek şeklini kabul eder. Oturum uç noktaları ise Pokee'nin kendisine aittir.

Bir Pokee ajan turu ne kadar sürebilir? Varsayılan tur zaman aşımı 90 dakika, varsayılan oturum TTL değeri ise 4 saattir. Her ikisi de talep üzerine yükseltilebilir.

İstemcim akış ortasında bağlantıyı keserse ne olur? Ajan çalışmaya devam eder. Tur kapandıktan sonraki 120 saniye içinde Last-Event-ID ile devam ettirme uç noktasına yeniden bağlanın; olayların geri kalanını yeniden faturalandırma olmadan alırsınız.

Diğer barındırılan ajan API'leriyle nasıl karşılaştırılır? OpenAI Agents API gibi barındırılan ajan tekliflerine yakın duruyor; OpenAI'ın ajan seçenekleri karşılaştırmamız iyi bir sonraki okuma olur ve CubeSandbox'ın AI ajanları için ne yaptığı yazısı sandbox tarafını ele alıyor.