Pokee Enterprise API: Agen Sandbox Persisten, Harga, dan Panggilan Pertama Anda

Pokee Enterprise API adalah REST API yang menjalankan agen AI berbentuk naratif panjang di dalam sandbox khusus yang bersifat persisten untuk setiap pelanggan. Anda membuat sesi, mengirim pesan, dan membaca jawaban agen sebagai aliran Server-Sent Events (SSE). Sesi dapat menampung berkas, keterampilan (skills) khusus, alat (tools), dan memori Anda sendiri yang dapat dipertahankan di berbagai sesi. Akses dilakukan melalui permintaan demo Pokee, bukan pendaftaran mandiri.

Di bawah ini: bagaimana sesi dan aliran bekerja, panggilan pertama Anda, harga Pokee Isaac, batas penggunaan, dan bagaimana membuat agen pengkodean menguji endpoint dengan Apidog CLI. Setiap angka berasal dari dokumen Pokee, yang dibaca pada tanggal 28 Oktober 2026.

Apa itu Pokee Enterprise API?

Pokee Enterprise API (Pokee menyebutnya Enterprise Responses API) memungkinkan Anda menjalankan alur kerja berbasis agen yang membutuhkan waktu dalam hitungan menit, bukan detik. Setiap penyewa (tenant) mendapatkan ruang kerja pribadi, token bearer yang stabil, dan subdomain sendiri, https://your-tenant.enterprise.pokee.ai. Di dalam ruang kerja tersebut, setiap sesi adalah satu proses agen dalam sandbox miliknya sendiri.

Sebuah panggilan obrolan menjawab satu prompt dan melupakannya. Sebuah sesi Pokee mempertahankan percakapan, berkas, dan status kesibukan, sehingga agen dapat meneliti, menulis berkas, dan memanggil alat di berbagai giliran. Jika Anda telah membaca panduan kami tentang Managed Agents Claude, bentuknya akan terasa familiar: penyedia menampung loop agen dan sandbox, dan Anda mengendarainya melalui HTTP.

Ini dibangun untuk tim yang menginginkan agen yang di-hosting dengan isolasi penyewa dan kontrol jaringan perusahaan (daftar izin IP, mTLS, AWS PrivateLink, penentuan wilayah), yang Pokee daftarkan tersedia berdasarkan permintaan.

Konsep inti: sesi, berkas, keterampilan, dan memori

API ini memiliki empat blok bangunan.

Konsep	Endpoint	Apa yang diberikannya kepada Anda
Sesi	`POST /v1/sessions`	Satu proses agen per sesi, dengan riwayat, cakupan berkas, dan modelnya sendiri
Berkas	`/v1/sessions/{id}/files/{path}`	Unggah, unduh, daftar, dan hapus berkas ruang kerja (sekitar 100 MB per unggahan)
Keterampilan (Skills)	`POST /v1/skills/{name}`	Instal bundel zip dengan `SKILL.md` di akarnya; berlaku untuk sesi baru
Memori	`.pokee/*.md`, `.memory/MEMORY.md`	Instruksi penyewa yang ditambahkan ke prompt sistem, ditambah memori di berbagai sesi

Beberapa detail sesi perlu diperhatikan di awal:

Persistent (Kekal). Secara default persistent adalah false, dan sesi menghapus dirinya sendiri 5 menit setelah respons terakhir. Atur ke true untuk mempertahankan sesi hingga ttl (waktu hidup) habis (default 14.400 detik, atau 4 jam) atau Anda menghapusnya.
Lock Model. Model yang Anda lewati pada saat pembuatan berlaku untuk setiap giliran dalam sesi tersebut.
Cakupan Berkas. Lewati file_access dengan daftar jalur read dan write untuk membatasi apa yang dilihat agen; API berkas HTTP akan mengembalikan 403 di luar cakupan tersebut.
Satu Giliran Sekaligus. Mengirim pesan kedua saat giliran sedang berjalan akan mengembalikan 409 Conflict.

Cara membuat panggilan API Pokee pertama Anda

Pokee memberi Anda dua nilai di luar jalur: URL penyewa Anda dan kunci berbentuk pk__. Kemudian panggilan pertama dilakukan dalam tiga langkah.

Periksa apakah gateway aktif (tidak memerlukan otorisasi).
Buat sesi dan simpan id-nya.
Kirim pesan dan baca aliran SSE.

export POKEE_API="https://your-tenant.enterprise.pokee.ai"
export POKEE_KEY="pk__"

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": "Ringkas berkas di ruang kerja saya dalam tiga poin."}'

Flag -i mencetak header. Simpan X-Response-Id (msg_ diikuti 24 karakter heksadesimal): Anda membutuhkannya untuk melanjutkan atau membatalkan giliran tersebut.

Setiap event terdiri dari tiga baris, id:, event:, dan data:. Anda akan melihat message.created, lalu potongan text.delta (ditambah event thinking.* atau tool_use.*), dan aliran berakhir dengan message.completed, message.cancelled, atau message.error. Jika SSE masih baru bagi Anda, panduan Server-Sent Events MDN menjelaskan formatnya, dan postingan kami tentang pengujian API LLM yang mengalir melalui SSE menunjukkan cara membaca potongan-potongan data tersebut.

Alur sesi Pokee Enterprise API: membuat sesi, mengirim pesan, membaca aliran SSE, dengan cabang lanjutkan dan batalkan

Pemanggilan Alat: Dua Permukaan

Pokee memberikan dua cara bagi agen untuk memanggil fungsi Anda, keduanya menggunakan definisi fungsi bergaya OpenAI.

	`/v1/responses` Stateless	Alat Sesi
Loop Agen	Tidak ada, satu perjalanan inferensi bolak-balik	Sesi agen penuh dengan keterampilan dan berkas
Status	Anda mengirim seluruh riwayat setiap panggilan	Server menyimpan percakapan
Bagaimana panggilan terlihat	Item `function_call` di `output[]`	Event SSE `tool_call.requested` di tengah aliran
Bagaimana Anda melanjutkan	Panggilan baru dengan item `function_call_output`	`POST /v1/sessions/{id}/tool_results`

Jalur tanpa status (stateless) adalah yang harus dipilih ketika Anda mengganti Pokee di belakang kode yang ditulis untuk OpenAI Responses API, karena bentuk kabelnya cocok. Ia menerima hingga 128 alat per permintaan, nama alat hingga 64 karakter, dan deskripsi hingga 16 KiB. Ia juga mengambil reasoning.effort (minimal, default, mematikan pemikiran yang diperluas; low, medium, dan high menyalakannya). Output secara default adalah 4.096 token, dibatasi hingga 32.000. Alat sesi cocok ketika agen harus menalar, menjalankan keterampilan, dan terkadang memanggil sistem Anda dalam giliran yang sama. Anda mendaftarkannya saat pembuatan sesi.

Gambar berikut menunjukkan perbandingan antara alat stateless vs alat mode sesi:

Perbandingan pemanggilan alat Pokee: /v1/responses stateless versus alat mode sesi melalui SSE

Lanjutkan, Batalkan, dan Kunci Idempensi

Giliran yang panjang terputus dengan cara yang tidak dilakukan oleh panggilan pendek. Pokee menambahkan tiga perbaikan pada 4 Mei 2026, sesuai dengan changelog.

Lanjutkan. Jika klien Anda terputus di tengah aliran, agen terus berjalan. Sambungkan ulang ke GET /v1/sessions/{id}/responses/{rid}/events dengan header Last-Event-ID dan server akan memutar dari event berikutnya. Sesi yang tertutup tetap tersedia selama 120 detik, dan melanjutkannya tidak akan dikenakan biaya ulang untuk token.
Batalkan. POST /v1/sessions/{id}/responses/{rid}/cancel mengembalikan 202 dan aliran berakhir dengan message.cancelled. Penggunaan parsial pada giliran yang dibatalkan tidak ditagih. Sesi dan berkasnya tetap hidup.
Kunci Idempensi. Kirim Idempotency-Key: <uuid> pada POST pesan. Pengulangan dengan kunci dan isi yang sama akan mengembalikan ID respons asli alih-alih memulai giliran kedua. Kunci hidup selama 24 jam, dan kunci yang sama dengan isi yang berbeda akan mengembalikan 422.

Jalur /v1/responses tanpa status mendukung ketiga hal tersebut ketika stream adalah true.

Model dan Harga Pokee Isaac

Pokee menerbitkan dua tingkatan Isaac di halaman model dan harga mereka. Harga adalah per juta token.

Model	Input	Output	Baca Cache
`pokee-isaac-high-reasoning`	$3	$15	$0.30
`pokee-isaac`	$0.30	$5	$0.10

Penyewa baru secara default menggunakan pokee-isaac-high-reasoning ketika Anda menghilangkan model. Backend Kimi, GPT-5.5, dan Gemini tersedia per penyewa berdasarkan kontrak. Dokumen tidak mencantumkan tingkatan gratis atau kontrak minimum; tanyakan hal tersebut kepada Pokee.

Ada juga Direct Isaac API, ditambahkan pada 7 Agustus 2026: rute POST /v1/chat/completions yang kompatibel dengan OpenAI tanpa loop agen atau alat. Ini diaktifkan per penyewa, hanya menerima pokee-isaac, dan mengarahkan permintaan panjang (200.000 dan 2.000.000 token ke atas) ke kumpulan konteks yang lebih besar secara otomatis. GET /v1/usage menunjukkan saldo kredit Anda.

Satu catatan keamanan dari dokumen: bearer penyewa adalah kunci API langsung. Simpan di server Anda atau di belakang proxy Anda sendiri, jangan pernah di peramban, kode seluler, atau desktop.

Batas dan Kode Kesalahan

Ini adalah default dari halaman batas dan kesalahan. Pokee mengatakan dapat meningkatkan salah satu dari hal tersebut berdasarkan permintaan.

Batas	Default
Sesi bersama	10
Batas waktu giliran	90 menit
TTL Sesi	4 jam
Giliran per jam / per hari	300 / 5.000
Token per jam / per hari	20M / 200M
Unggahan maksimum	Sekitar 100 MB per panggilan
Ruang kerja maksimum	100 GB

Kode kesalahan yang paling mungkin Anda tangani: 401 (kunci buruk atau hilang), 402 (kehabisan kredit, mode kredit keras saja), 403 (jalur di luar cakupan sesi), 409 (sesi sibuk), 422 (kunci idempensi digunakan kembali dengan isi yang berbeda), 429 (batas penggunaan), dan 500 (coba lagi dengan backoff). Kesalahan dikembalikan sebagai {"error": "", "message": ""}.

Biarkan agen pengkodean Anda menguji Pokee API dengan Apidog CLI

Sebuah API sesi memiliki banyak kontrak untuk ditetapkan: 201 saat membuat, ID sess_, 409 saat sibuk, 204 saat menghapus, 202 saat membatalkan. Agen pengkodean Anda dapat menulis dan menjalankan pemeriksaan tersebut selagi Anda terus bekerja. Apidog CLI memberi Claude Code, Codex, atau Cursor perintah untuk melakukannya.

Atur satu kali:

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

Kemudian berikan satu prompt kepada agen Anda:

Tulis file OpenAPI untuk endpoint Pokee Enterprise API /health, POST/GET/DELETE /v1/sessions, /v1/sessions/{id}/responses/{rid}/cancel dan /v1/usage, impor ke proyek Apidog , buat lingkungan untuk URL penyewa saya, lalu tambahkan kasus pengujian yang menyatakan 201 dan ID yang dimulai dengan "sess_" pada pembuatan, 204 pada penghapusan dan saldo kredit pada /v1/usage. Jalankan dan ringkas kegagalannya. Baca POKEE_KEY dari shell saya, jangan pernah dari file.

Agen mengimpor spesifikasi, memeriksa setiap payload terhadap skema CLI, lalu membuat dan menjalankan kasus:

apidog import --project  --format openapi --file ./pokee-openapi.json
apidog environment create pokee-tenant --project  --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  --file create-session.json
apidog run --test-case  --project  -e  --env-var "POKEE_KEY=$POKEE_KEY" -r cli,junit

Mengirim kunci dengan --env-var menjaganya keluar dari file apa pun yang ditulis agen. Kasus-kasus ini mencakup endpoint JSON; aliran SSE itu sendiri lebih mudah dilihat di aplikasi Apidog, yang menampilkan event yang mengalir (lihat pengujian SSE di Apidog). Perintah apidog run yang sama dengan -r junit masuk ke CI, seperti yang ditunjukkan oleh panduan CI/CD Apidog CLI kami. Baru mengenal CLI di agen? Mulailah dengan Apidog CLI di Claude Code. Paket Gratis Apidog mencakup hingga 4 pengguna.

Tempat Sharkly Berperan

Setelah agen Pokee, atau agen pengkodean apa pun, menjalankan tugas yang memakan waktu 90 menit, seseorang harus memutuskan siapa melakukan apa dan memeriksa hasilnya. ID sesi dalam file log bukanlah antrean kerja. Sharkly adalah papan tugas di mana agen AI dan orang berbagi pekerjaan: Anda menetapkan tugas ke agen atau rekan tim, mengikuti statusnya, dan meninjau hasilnya sebelum dikirim. Gratis untuk memulai, jadi Anda dapat menempatkan satu pekerjaan agen yang panjang di papan dan melihat bagaimana peninjauan cocok untuk tim Anda sebelum Anda meningkatkan skala.

FAQ

Apakah ada tingkat gratis untuk Pokee Enterprise API? Dokumen tidak menjelaskan adanya hal tersebut. Akses dimulai dengan permintaan demo, dan Pokee menyediakan URL penyewa dan kuncinya di luar jalur. Harga per token pada tingkatan Isaac di atas.

Apakah API Pokee kompatibel dengan OpenAI? Sebagian. Jalur /v1/responses tanpa status cocok dengan bentuk kabel Responses OpenAI untuk pemanggilan fungsi, dan rute Direct Isaac menerima bentuk permintaan Chat Completions. Endpoint sesi adalah milik Pokee sendiri.

Berapa lama satu giliran agen Pokee dapat berjalan? Batas waktu giliran default adalah 90 menit dan TTL sesi default adalah 4 jam. Keduanya dapat ditingkatkan berdasarkan permintaan.

Apa yang terjadi jika klien saya terputus di tengah aliran? Agen terus bekerja. Sambungkan ulang ke endpoint lanjutkan dengan Last-Event-ID dalam waktu 120 detik setelah giliran ditutup dan Anda akan mendapatkan sisa event tanpa ditagih ulang.

Bagaimana perbandingannya dengan API agen yang di-hosting lainnya? Ini berada dekat dengan penawaran agen yang di-hosting seperti OpenAI Agents API; perbandingan opsi agen OpenAI kami adalah bacaan berikutnya yang bagus, dan apa yang dilakukan CubeSandbox untuk agen AI mencakup sisi sandbox.