Pokee Enterprise API: Agent Sandbox Bền Vững, Bảng Giá và Lần Gọi API Đầu Tiên

Pokee Enterprise API là một REST API chạy một AI agent dạng dài bên trong một sandbox riêng, liên tục cho mỗi khách hàng. Bạn tạo một session, gửi một tin nhắn, và đọc câu trả lời của agent dưới dạng luồng Server-Sent Events (SSE). Session có thể chứa tệp, kỹ năng tùy chỉnh, công cụ riêng của bạn và bộ nhớ được giữ lại xuyên suốt các session. Quyền truy cập thông qua yêu cầu dùng thử Pokee, không phải đăng ký tự phục vụ.

Dưới đây: cách session và stream hoạt động, lệnh gọi đầu tiên của bạn, giá Pokee Isaac, các giới hạn, và cách để một coding agent kiểm thử các endpoint bằng Apidog CLI. Mọi con số đều lấy từ tài liệu Pokee, đọc ngày 28 tháng 10 năm 2026.

Pokee Enterprise API là gì?

Pokee Enterprise API (Pokee gọi nó là Enterprise Responses API) cho phép bạn chạy các quy trình công việc do agent điều khiển, kéo dài hàng phút thay vì vài giây. Mỗi tenant nhận được một workspace riêng, một bearer token ổn định và subdomain riêng, https://your-tenant.enterprise.pokee.ai. Bên trong workspace đó, mỗi session là một tiến trình agent trong sandbox riêng của nó.

Một lệnh gọi chat trả lời một prompt rồi quên đi. Một session Pokee giữ lại cuộc hội thoại, tệp và trạng thái bận của nó, nên agent có thể nghiên cứu, viết tệp và gọi công cụ qua nhiều lượt. Nếu bạn đã đọc hướng dẫn của chúng tôi về Claude Managed Agents, hình dạng này sẽ khá quen thuộc: nhà cung cấp vận hành vòng lặp agent và sandbox, còn bạn điều khiển nó qua HTTP.

Nó được xây dựng cho các đội ngũ muốn một agent được host với sự cô lập tenant và các kiểm soát mạng cấp doanh nghiệp (danh sách IP cho phép, mTLS, AWS PrivateLink, ghim vùng), những thứ mà Pokee liệt kê là có sẵn theo yêu cầu.

Các khái niệm cốt lõi: session, tệp, kỹ năng và bộ nhớ

API có bốn khối xây dựng.

Khái niệm	Endpoint	Nó mang lại cho bạn điều gì
Sessions	`POST /v1/sessions`	Một tiến trình agent cho mỗi session, với lịch sử, phạm vi tệp và model riêng
Tệp	`/v1/sessions/{id}/files/{path}`	Tải lên, tải xuống, liệt kê và xóa các tệp trong workspace (khoảng 100 MB mỗi lần tải lên)
Kỹ năng	`POST /v1/skills/{name}`	Cài đặt một gói zip với `SKILL.md` ở thư mục gốc; áp dụng cho các session mới
Bộ nhớ	`.pokee/*.md`, `.memory/MEMORY.md`	Hướng dẫn của tenant được thêm vào system prompt, cùng bộ nhớ xuyên suốt các session

Một vài chi tiết về session cần lưu ý ngay từ đầu:

Tính liên tục. Mặc định persistent là false, và session tự hủy 5 phút sau phản hồi cuối cùng của nó. Đặt thành true để giữ session cho đến khi ttl của nó hết hạn (mặc định 14.400 giây, tức 4 giờ) hoặc bạn xóa nó.
Khóa model. model bạn truyền lúc tạo sẽ áp dụng cho mọi lượt trong session đó.
Phạm vi tệp. Truyền file_access với danh sách đường dẫn read và write để giới hạn những gì agent thấy; HTTP file API trả về 403 ngoài phạm vi đó.
Một lượt tại một thời điểm. Gửi tin nhắn thứ hai trong khi một lượt đang chạy sẽ trả về 409 Conflict.

Cách thực hiện lệnh gọi Pokee API đầu tiên của bạn

Pokee đưa cho bạn hai giá trị ngoài luồng: URL tenant của bạn và một khóa có dạng pk_<tenant>_<token>. Sau đó lệnh gọi đầu tiên gồm ba bước.

Kiểm tra gateway còn hoạt động (không cần xác thực).
Tạo một session và giữ lại id của nó.
Gửi một tin nhắn và đọc luồng SSE.

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."}'

Cờ -i in ra các header. Hãy lưu X-Response-Id (msg_ cộng với 24 ký tự hex): bạn cần nó để tiếp tục hoặc hủy lượt.

Mỗi sự kiện gồm ba dòng, id:, event: và data:. Bạn sẽ thấy message.created, rồi các đoạn text.delta (cùng với các sự kiện thinking.* hoặc tool_use.*), và luồng kết thúc bằng message.completed, message.cancelled hoặc message.error. Nếu SSE còn mới với bạn, hướng dẫn Server-Sent Events của MDN giải thích định dạng này, và bài viết của chúng tôi về kiểm thử các LLM API truyền qua SSE chỉ cách đọc các đoạn dữ liệu.

Pokee Enterprise API session flow: create a session, post a message, read the SSE stream, with resume and cancel branches

Gọi công cụ: hai bề mặt

Pokee cho agent hai cách để gọi các hàm của bạn, cả hai đều dùng định nghĩa hàm kiểu OpenAI.

	`/v1/responses` không trạng thái	Công cụ session
Vòng lặp agent	Không có, một vòng suy luận	Session agent đầy đủ với kỹ năng và tệp
Trạng thái	Bạn gửi toàn bộ lịch sử mỗi lệnh gọi	Máy chủ giữ cuộc hội thoại
Lệnh gọi xuất hiện thế nào	Một mục `function_call` trong `output[]`	Một sự kiện SSE `tool_call.requested` giữa luồng
Cách bạn tiếp tục	Lệnh gọi mới với một mục `function_call_output`	`POST /v1/sessions/{id}/tool_results`

Lộ trình không trạng thái là lựa chọn khi bạn đang thay Pokee vào phía sau đoạn mã viết cho OpenAI Responses API, vì hình dạng dữ liệu truyền khớp nhau. Nó chấp nhận tối đa 128 công cụ mỗi yêu cầu, tên công cụ tối đa 64 ký tự và mô tả tối đa 16 KiB. Nó cũng nhận reasoning.effort (minimal, mặc định, tắt suy luận mở rộng; low, medium và high bật nó). Đầu ra mặc định là 4.096 token, tối đa 32.000.

Công cụ session phù hợp khi agent cần suy luận, chạy các kỹ năng và đôi khi gọi hệ thống của bạn trong cùng một lượt. Bạn đăng ký chúng lúc tạo session.

Pokee tool calling compared: stateless /v1/responses versus session-mode tools over SSE

Tiếp tục, hủy và khóa idempotency

Những lượt dài bị ngắt theo những cách mà các lệnh gọi ngắn không gặp phải. Pokee đã thêm ba bản sửa lỗi vào ngày 4 tháng 5 năm 2026, theo changelog của nó.

Tiếp tục. Nếu client của bạn ngắt giữa luồng, agent vẫn tiếp tục chạy. Kết nối lại tới GET /v1/sessions/{id}/responses/{rid}/events với header Last-Event-ID và máy chủ sẽ phát lại từ sự kiện tiếp theo. Các lượt đã đóng vẫn khả dụng trong 120 giây, và việc tiếp tục không tính phí token lần nữa.
Hủy. POST /v1/sessions/{id}/responses/{rid}/cancel trả về 202 và luồng kết thúc bằng message.cancelled. Phần dùng một phần của một lượt đã hủy không bị tính phí. Session và các tệp của nó vẫn tồn tại.
Khóa idempotency. Gửi Idempotency-Key: <uuid> trong POST tin nhắn. Một lần thử lại với cùng khóa và cùng nội dung sẽ trả về ID phản hồi ban đầu thay vì bắt đầu lượt thứ hai. Khóa tồn tại 24 giờ, và cùng khóa với nội dung khác sẽ trả về 422.

Lộ trình không trạng thái /v1/responses hỗ trợ cả ba khi stream là true.

Các model Pokee Isaac và giá cả

Pokee công bố hai bậc Isaac trên trang model và giá của nó. Giá tính trên mỗi triệu token.

Model	Đầu vào	Đầu ra	Đọc cache
`pokee-isaac-high-reasoning`	$3	$15	$0.30
`pokee-isaac`	$0.30	$5	$0.10

Các tenant mới mặc định dùng pokee-isaac-high-reasoning khi bạn bỏ qua model. Các backend Kimi, GPT-5.5 và Gemini có sẵn theo từng tenant thông qua hợp đồng. Tài liệu không liệt kê bậc miễn phí hay hợp đồng tối thiểu; hãy hỏi Pokee về những điều khoản đó.

Ngoài ra còn có Direct Isaac API, được thêm vào ngày 7 tháng 8 năm 2026: một lộ trình POST /v1/chat/completions tương thích OpenAI, không có vòng lặp agent hay công cụ. Nó được bật theo từng tenant, chỉ chấp nhận pokee-isaac, và tự động định tuyến các yêu cầu dài (200.000 và 2.000.000 token trở lên) tới các pool ngữ cảnh lớn hơn. GET /v1/usage hiển thị số dư tín dụng của bạn.

Một lưu ý bảo mật từ tài liệu: bearer của tenant là một API key trực tiếp. Hãy giữ nó trên máy chủ của bạn hoặc sau proxy riêng của bạn, tuyệt đối không để trong mã trình duyệt, di động hay desktop.

Giới hạn và mã lỗi

Đây là các giá trị mặc định từ trang giới hạn và lỗi. Pokee nói rằng nó có thể nâng bất kỳ giới hạn nào theo yêu cầu.

Giới hạn	Mặc định
Session đồng thời	10
Thời gian chờ lượt	90 phút
TTL session	4 giờ
Lượt mỗi giờ / mỗi ngày	300 / 5.000
Token mỗi giờ / mỗi ngày	20M / 200M
Tải lên tối đa	Khoảng 100 MB mỗi lệnh gọi
Workspace tối đa	100 GB

Các mã lỗi bạn sẽ gặp nhiều nhất: 401 (khóa sai hoặc thiếu), 402 (hết tín dụng, chỉ ở chế độ tín dụng cứng), 403 (đường dẫn nằm ngoài phạm vi của session), 409 (session đang bận), 422 (khóa idempotency được dùng lại với nội dung khác), 429 (vượt giới hạn sử dụng) và 500 (thử lại với backoff). Lỗi trả về dưới dạng {"error": "<name>", "message": "<detail>"}.

Để coding agent của bạn kiểm thử Pokee API bằng Apidog CLI

Một API session có rất nhiều hợp đồng cần xác định rõ: 201 khi tạo, một ID sess_, 409 khi đang bận, 204 khi xóa, 202 khi hủy. Coding agent của bạn có thể viết và chạy những kiểm tra đó trong khi bạn tiếp tục làm việc. Apidog CLI cung cấp cho Claude Code, Codex hoặc Cursor các lệnh để làm điều đó.

Thiết lập một lần:

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

Sau đó đưa cho agent của bạn một prompt:

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 nhập spec, kiểm tra từng payload dựa trên schema của CLI, rồi tạo và chạy các test case:

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

Việc truyền khóa bằng --env-var giữ nó ngoài mọi tệp mà agent ghi. Những test case này bao phủ các endpoint JSON; bản thân luồng SSE thì dễ xem hơn trong ứng dụng Apidog, nơi hiển thị các sự kiện được truyền (xem kiểm thử SSE trong Apidog). Cùng lệnh apidog run đó với -r junit có thể đưa vào CI, như hướng dẫn Apidog CLI CI/CD của chúng tôi cho thấy. Mới làm quen với CLI trong một agent? Hãy bắt đầu với Apidog CLI trong Claude Code. Gói Miễn phí của Apidog hỗ trợ tối đa 4 người dùng.

Sharkly phù hợp ở đâu

Một khi các agent Pokee, hay bất kỳ coding agent nào, chạy các tác vụ kéo dài 90 phút, sẽ có người phải quyết định ai làm việc gì và kiểm tra kết quả. Một session ID trong tệp log không phải là một hàng đợi công việc. Sharkly là một bảng tác vụ nơi các AI agent và con người chia sẻ công việc: bạn giao một tác vụ cho một agent hoặc một đồng đội, theo dõi trạng thái của nó, và xem xét đầu ra trước khi nó được đưa đi. Nó miễn phí để bắt đầu, nên bạn có thể đưa một công việc agent dài lên bảng và xem việc xem xét phù hợp với đội của bạn thế nào trước khi mở rộng quy mô.

Câu hỏi thường gặp

Có bậc miễn phí cho Pokee Enterprise API không? Tài liệu không mô tả bậc nào như vậy. Quyền truy cập bắt đầu bằng một yêu cầu dùng thử, và Pokee cấp URL tenant cùng khóa cho bạn ngoài luồng. Giá tính theo token theo các bậc Isaac ở trên.

Pokee API có tương thích với OpenAI không? Một phần. Lộ trình không trạng thái /v1/responses khớp với hình dạng wire Responses của OpenAI cho việc gọi hàm, và lộ trình Direct Isaac chấp nhận hình dạng yêu cầu Chat Completions. Các endpoint session là của riêng Pokee.

Một lượt agent Pokee có thể chạy bao lâu? Thời gian chờ lượt mặc định là 90 phút và TTL session mặc định là 4 giờ. Cả hai đều có thể được nâng theo yêu cầu.

Điều gì xảy ra nếu client của tôi ngắt kết nối giữa luồng? Agent vẫn tiếp tục làm việc. Kết nối lại tới endpoint tiếp tục với Last-Event-ID trong vòng 120 giây kể từ khi lượt đóng lại và bạn sẽ nhận được phần còn lại của các sự kiện mà không bị tính phí lần nữa.

Nó so sánh thế nào với các hosted agent API khác? Nó khá gần với các sản phẩm hosted-agent như OpenAI Agents API; bài so sánh các lựa chọn agent của OpenAI của chúng tôi là một bài đọc tiếp theo hay, và bài CubeSandbox làm gì cho các AI agent bao quát khía cạnh sandbox.