Thanawat Wongchai

Posted on Oct 28 Originally published at apidog.com

Pokee Enterprise API: เอเจนต์ Persistent Sandbox, ราคา และการเรียกใช้งานครั้งแรกของคุณ

Pokee Enterprise API เป็น REST API ที่รัน AI agent แบบ long-form ภายใน sandbox แบบถาวรเฉพาะสำหรับลูกค้าแต่ละราย คุณสร้าง session ส่งข้อความ และอ่านคำตอบของ agent ในรูปแบบ Server-Sent Events (SSE) stream session สามารถเก็บไฟล์ skills ที่กำหนดเอง tools ของคุณเอง และ memory ที่ส่งต่อข้าม session ได้ การเข้าถึงทำผ่านการขอ demo ของ Pokee ไม่ใช่การสมัครแบบ self-serve

ลองใช้ Apidog วันนี้

ด้านล่าง: session และ stream ทำงานอย่างไร การเรียกครั้งแรกของคุณ ราคา Pokee Isaac ขีดจำกัด และวิธีให้ coding agent ทดสอบ endpoints ด้วย Apidog CLI ตัวเลขทุกตัวมาจาก เอกสาร Pokee ที่อ่านเมื่อวันที่ 28 ตุลาคม 2026

Pokee Enterprise API คืออะไร?

Pokee Enterprise API (Pokee เรียกมันว่า Enterprise Responses API) ให้คุณรัน workflow ที่ขับเคลื่อนด้วย agent ซึ่งใช้เวลาหลายนาที ไม่ใช่ไม่กี่วินาที แต่ละ tenant ได้ workspace ส่วนตัว Bearer [REDACTED] ที่เสถียร และ subdomain ของตัวเอง https://your-tenant.enterprise.pokee.ai ภายใน workspace นั้น แต่ละ session คือหนึ่ง agent process ใน sandbox ของตัวเอง

การเรียกแบบ chat ตอบหนึ่ง prompt แล้วลืมไป ส่วน Pokee session เก็บบทสนทนา ไฟล์ และสถานะ busy ไว้ ดังนั้น agent จึงสามารถค้นคว้า เขียนไฟล์ และเรียก tools ได้หลายรอบ หากคุณเคยอ่านคู่มือของเราเกี่ยวกับ Claude Managed Agents รูปแบบจะดูคุ้นเคย: ผู้ให้บริการโฮสต์ agent loop และ sandbox และคุณควบคุมผ่าน HTTP

มันถูกสร้างมาสำหรับทีมที่ต้องการ hosted agent พร้อม tenant isolation และการควบคุมเครือข่ายระดับองค์กร (IP allowlists, mTLS, AWS PrivateLink, region pinning) ซึ่ง Pokee ระบุว่ามีให้ตามคำขอ

แนวคิดหลัก: session, ไฟล์, skills และ memory

API มีสี่ส่วนประกอบหลัก:

แนวคิด	Endpoint	สิ่งที่คุณได้รับ
Sessions	`POST /v1/sessions`	หนึ่ง agent process ต่อ session พร้อมประวัติ ขอบเขตไฟล์ และโมเดลของตัวเอง
Files	`/v1/sessions/{id}/files/{path}`	อัปโหลด ดาวน์โหลด แสดงรายการ และลบไฟล์ใน workspace (ประมาณ 100 MB ต่อการอัปโหลด)
Skills	`POST /v1/skills/{name}`	ติดตั้ง zip bundle ที่มี `SKILL.md` อยู่ที่ root ใช้กับ session ใหม่
Memory	`.pokee/*.md`, `.memory/MEMORY.md`	คำสั่งระดับ tenant ที่เพิ่มเข้าไปใน system prompt บวกกับ memory ข้าม session

รายละเอียด session บางอย่างสำคัญตั้งแต่ต้น:

Persistence โดยค่าเริ่มต้น persistent เป็น false และ session จะทำลายตัวเอง 5 นาทีหลังคำตอบสุดท้าย ตั้งเป็น true เพื่อเก็บ session ไว้จนกว่า ttl จะหมด (ค่าเริ่มต้น 14,400 วินาที หรือ 4 ชั่วโมง) หรือคุณลบมัน
Model lock model ที่คุณส่งตอนสร้างจะใช้กับทุก turn ใน session นั้น
File scope ส่ง file_access พร้อมรายการ path ของ read และ write เพื่อจำกัดสิ่งที่ agent เห็น HTTP file API จะคืน 403 นอกขอบเขตนั้น
ทีละหนึ่ง turn การส่งข้อความที่สองขณะที่ turn กำลังทำงานจะคืน 409 Conflict

วิธีเรียก Pokee API ครั้งแรกของคุณ

Pokee ส่งค่าสองค่าให้คุณแบบไม่ผ่าน API: tenant URL และ key ที่มีรูปแบบ pk_<tenant>_<token> จากนั้นการเรียกครั้งแรกมีสามขั้นตอน:

ตรวจสอบว่า gateway ทำงานอยู่ (ไม่ต้องใช้ auth)
สร้าง session และเก็บ id ไว้
ส่งข้อความและอ่าน SSE stream

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 จะพิมพ์ headers บันทึก X-Response-Id (msg_ บวก hex 24 ตัวอักษร): คุณต้องใช้มันเพื่อ resume หรือยกเลิก turn

แต่ละ event มีสามบรรทัด id:, event: และ data: คุณจะเห็น message.created ตามด้วย chunk text.delta (บวกกับ event thinking.* หรือ tool_use.*) และ stream จบด้วย message.completed, message.cancelled หรือ message.error หากคุณเพิ่งรู้จัก SSE คู่มือ Server-Sent Events ของ MDN อธิบายรูปแบบไว้ และโพสต์ของเราเกี่ยวกับ การทดสอบ LLM APIs ที่ stream ผ่าน SSE แสดงวิธีอ่าน chunk ต่างๆ

Tool calling: สองพื้นผิว

Pokee ให้ agent สองวิธีในการเรียกฟังก์ชันของคุณ ทั้งคู่ใช้คำจำกัดความฟังก์ชันแบบ OpenAI:

	Stateless `/v1/responses`	Session tools
Agent loop	ไม่มี เป็น inference ไป-กลับครั้งเดียว	Full agent session พร้อม skills และไฟล์
State	คุณส่งประวัติทั้งหมดในทุกการเรียก	เซิร์ฟเวอร์เก็บบทสนทนาไว้
การเรียกปรากฏอย่างไร	รายการ `function_call` ใน `output[]`	event `tool_call.requested` แบบ SSE กลางสตรีม
คุณดำเนินการต่ออย่างไร	เรียกใหม่พร้อมรายการ `function_call_output`	`POST /v1/sessions/{id}/tool_results`

เส้นทาง stateless คือตัวเลือกที่ควรใช้เมื่อคุณกำลังสับเปลี่ยน Pokee เข้าไปหลังโค้ดที่เขียนสำหรับ OpenAI Responses API เพราะรูปแบบ wire ตรงกัน มันรับ tools ได้สูงสุด 128 รายการต่อ request ชื่อ tool สูงสุด 64 ตัวอักษร และคำอธิบายสูงสุด 16 KiB มันยังรับ reasoning.effort (minimal ซึ่งเป็นค่าเริ่มต้น จะปิด extended thinking ไว้; low, medium และ high จะเปิดมัน) Output มีค่าเริ่มต้น 4,096 tokens สูงสุด 32,000

Session tools เหมาะเมื่อ agent ควรให้เหตุผล รัน skills และบางครั้งเรียกระบบของคุณใน turn เดียวกัน คุณลงทะเบียนมันตอนสร้าง session

Resume, cancel และ idempotency keys

Turn ยาวๆ แตกหักในแบบที่การเรียกสั้นๆ ไม่เป็น Pokee เพิ่มวิธีแก้สามอย่างเมื่อวันที่ 4 พฤษภาคม 2026 ตาม changelog ของมัน:

Resume หากไคลเอนต์ของคุณหลุดกลางสตรีม agent จะทำงานต่อไป เชื่อมต่อใหม่ที่ GET /v1/sessions/{id}/responses/{rid}/events พร้อม header Last-Event-ID และเซิร์ฟเวอร์จะเล่นซ้ำจาก event ถัดไป turn ที่ปิดแล้วจะยังใช้ได้ 120 วินาที และการ resume จะไม่คิดค่า tokens ซ้ำ
Cancel POST /v1/sessions/{id}/responses/{rid}/cancel คืน 202 และ stream จบด้วย message.cancelled การใช้งานบางส่วนบน turn ที่ถูกยกเลิกจะไม่ถูกคิดเงิน session และไฟล์ของมันยังอยู่
Idempotency keys ส่ง Idempotency-Key: <uuid> ในการ POST message การ retry ด้วย key และ body เดิมจะคืน response ID เดิมแทนที่จะเริ่ม turn ที่สอง key มีอายุ 24 ชั่วโมง และ key เดียวกันกับ body ที่ต่างกันจะคืน 422

เส้นทาง stateless /v1/responses รองรับทั้งสามอย่างเมื่อ stream เป็น true

โมเดลและราคา Pokee Isaac

Pokee เผยแพร่สองระดับของ Isaac บน หน้าโมเดลและราคา ของมัน ราคาต่อล้าน tokens:

โมเดล	Input	Output	Cache read
`pokee-isaac-high-reasoning`	$3	$15	$0.30
`pokee-isaac`	$0.30	$5	$0.10

Tenant ใหม่มีค่าเริ่มต้นเป็น pokee-isaac-high-reasoning เมื่อคุณไม่ระบุ model แบ็กเอนด์ Kimi, GPT-5.5 และ Gemini มีให้ต่อ tenant ตามสัญญา เอกสารไม่ได้ระบุ tier ฟรีหรือสัญญาขั้นต่ำ สอบถาม Pokee สำหรับเงื่อนไขเหล่านั้น

ยังมี Direct Isaac API เพิ่มเมื่อวันที่ 7 สิงหาคม 2026: เส้นทาง POST /v1/chat/completions ที่เข้ากันได้กับ OpenAI โดยไม่มี agent loop หรือ tools มันถูกเปิดใช้ต่อ tenant รับเฉพาะ pokee-isaac และส่ง request ยาว (200,000 และ 2,000,000 tokens ขึ้นไป) ไปยัง context pool ที่ใหญ่กว่าอัตโนมัติ GET /v1/usage แสดงยอดเครดิตคงเหลือของคุณ

ข้อควรทราบด้านความปลอดภัยจากเอกสาร: tenant bearer คือ direct API key เก็บมันไว้บนเซิร์ฟเวอร์ของคุณหรือหลัง proxy ของคุณเอง ไม่ควรอยู่ในโค้ด browser, mobile หรือ desktop

ขีดจำกัดและรหัสข้อผิดพลาด

นี่คือค่าเริ่มต้นจาก หน้าขีดจำกัดและข้อผิดพลาด Pokee ระบุว่าสามารถเพิ่มค่าใดก็ได้ตามคำขอ:

ขีดจำกัด	ค่าเริ่มต้น
Concurrent sessions	10
Turn timeout	90 นาที
Session TTL	4 ชั่วโมง
Turns per hour / per day	300 / 5,000
Tokens per hour / per day	20M / 200M
Max upload	ประมาณ 100 MB ต่อการเรียก
Max workspace	100 GB

รหัสข้อผิดพลาดที่คุณจะเจอบ่อยที่สุด: 401 (key ผิดหรือไม่มี), 402 (เครดิตหมด โหมด hard credit เท่านั้น), 403 (path นอกขอบเขตของ session), 409 (session กำลัง busy), 422 (idempotency key ถูกใช้ซ้ำกับ body ที่ต่างกัน), 429 (ถึงขีดจำกัดการใช้งาน) และ 500 (retry ด้วย backoff) ข้อผิดพลาดจะกลับมาในรูปแบบ {"error": "<name>", "message": "<detail>"}

ให้ coding agent ของคุณทดสอบ Pokee API ด้วย Apidog CLI

Session API มีสัญญามากมายที่ต้องกำหนดให้ชัด: 201 ตอนสร้าง, ID sess_, 409 ขณะ busy, 204 ตอนลบ, 202 ตอน cancel coding agent ของคุณสามารถเขียนและรันการตรวจสอบเหล่านั้นขณะที่คุณทำงานต่อไป Apidog CLI ให้ Claude Code, Codex หรือ Cursor มีคำสั่งในการทำเช่นนั้น

ตั้งค่าครั้งเดียว:

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

จากนั้นให้ prompt เดียวกับ agent ของคุณ:

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.

Agent จะนำเข้า spec ตรวจสอบแต่ละ payload กับ schema ของ CLI แล้วสร้างและรัน test cases:

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

การส่ง key ด้วย --env-var ช่วยให้มันไม่อยู่ในไฟล์ใดๆ ที่ agent เขียน test cases เหล่านี้ครอบคลุม endpoints แบบ JSON ส่วน SSE stream เองดูได้ง่ายกว่าในแอป Apidog ซึ่ง render streamed events ได้ (ดู การทดสอบ SSE ใน Apidog) คำสั่ง apidog run เดียวกันกับ -r junit หยั่งลงใน CI ได้ ดังที่คู่มือ Apidog CLI CI/CDของเราแสดงไว้ เพิ่งเริ่มใช้ CLI ใน agent? เริ่มจาก Apidog CLI ใน Claude Code แผน Free ของ Apidog ครอบคลุมผู้ใช้สูงสุด 4 คน

Sharkly เข้ามาเสริมตรงไหน

เมื่อ Pokee agents หรือ coding agents ใดๆ รันงานที่ใช้เวลา 90 นาที ต้องมีคนตัดสินใจว่าใครทำอะไรและตรวจสอบผลลัพธ์ session ID ในไฟล์ log ไม่ใช่คิวงาน Sharkly คือ task board ที่ AI agents และผู้คนแบ่งปันงานกัน: คุณมอบหมายงานให้ agent หรือเพื่อนร่วมทีม ติดตามสถานะ และตรวจสอบ output ก่อนที่มันจะถูกส่งออก เริ่มใช้ฟรี ดังนั้นคุณสามารถเอางาน agent แบบยาวหนึ่งงานขึ้นบอร์ดและดูว่าการตรวจสอบเข้ากับทีมของคุณอย่างไรก่อนขยาย

คำถามที่พบบ่อย

มี tier ฟรีสำหรับ Pokee Enterprise API ไหม? เอกสารไม่ได้ระบุไว้ การเข้าถึงเริ่มด้วยการขอ demo และ Pokee จะเตรียม tenant URL และ key ให้คุณแบบไม่ผ่าน API ราคาคิดต่อ token ตามระดับของ Isaac ข้างต้น

Pokee API เข้ากันได้กับ OpenAI ไหม? บางส่วน เส้นทาง stateless /v1/responses ตรงกับรูปแบบ Responses wire ของ OpenAI สำหรับ function calling และเส้นทาง Direct Isaac รับรูปแบบ request ของ Chat Completions ส่วน session endpoints เป็นของ Pokee เอง

turn ของ Pokee agent รันได้นานแค่ไหน? Turn timeout ค่าเริ่มต้นคือ 90 นาที และ session TTL ค่าเริ่มต้นคือ 4 ชั่วโมง ทั้งคู่สามารถเพิ่มได้ตามคำขอ

เกิดอะไรขึ้นหากไคลเอนต์ของฉันหลุดกลางสตรีม? Agent ยังทำงานต่อไป เชื่อมต่อใหม่ที่ resume endpoint พร้อม Last-Event-ID ภายใน 120 วินาทีหลัง turn ปิด แล้วคุณจะได้ event ที่เหลือโดยไม่คิดเงินซ้ำ

มันเปรียบเทียบกับ hosted agent API อื่นๆ อย่างไร? มันอยู่ใกล้กับข้อเสนอ hosted-agent อย่าง OpenAI Agents API; การเปรียบเทียบตัวเลือก agent ของ OpenAI ของเราเป็นบทอ่านต่อไปที่ดี และ CubeSandbox ทำอะไรให้ AI agents ครอบคลุมด้าน sandbox

DEV Community

Pokee Enterprise API: เอเจนต์ Persistent Sandbox, ราคา และการเรียกใช้งานครั้งแรกของคุณ

Pokee Enterprise API: เอเจนต์ Persistent Sandbox, ราคา และการเรียกใช้งานครั้งแรกของคุณ

Pokee Enterprise API คืออะไร?

แนวคิดหลัก: session, ไฟล์, skills และ memory

วิธีเรียก Pokee API ครั้งแรกของคุณ

Tool calling: สองพื้นผิว

Resume, cancel และ idempotency keys

โมเดลและราคา Pokee Isaac

ขีดจำกัดและรหัสข้อผิดพลาด

ให้ coding agent ของคุณทดสอบ Pokee API ด้วย Apidog CLI

Sharkly เข้ามาเสริมตรงไหน

คำถามที่พบบ่อย

Top comments (0)