Tóm tắt: Các AI agent của Pokee hoạt động thông qua Pokee Enterprise API: mỗi tenant nhận được một sandbox riêng biệt, có tính lưu trữ bền vững (persistent), nơi một agent có thể làm việc trong một lượt chạy (turn) tối đa 90 phút, với quyền truy cập tệp theo phạm vi (scoped file access), các kỹ năng được tải lên, các tệp persona trong thư mục .pokee/ và bộ nhớ duy trì xuyên suốt các phiên. API là nơi vận hành agent. Tuy nhiên, đội ngũ của bạn vẫn cần một không gian để giao việc, theo dõi tiến độ và đánh giá kết quả trước khi đưa vào sử dụng thực tế.
Pokee được xây dựng cho các tác vụ vượt quá khả năng của một cửa sổ trò chuyện thông thường: một bản báo cáo thị trường dài mười trang, hay một nghiên cứu ngốn gần cả tiếng đồng hồ. Sẽ chẳng ai ngồi nhìn chằm chằm một lượt chạy dài 90 phút, vì vậy phải có người chịu trách nhiệm, kiểm tra và xác nhận xem tác vụ đã hoàn thành hay chưa. Nếu bạn đã và đang quản trị các coding agent trên cùng một bảng công việc, Sharkly chính là nơi tập hợp những tác vụ đó; chi tiết sẽ được trình bày ở bên dưới.
Pokee AI là gì?
Pokee là một nền tảng agent sở hữu Enterprise API được định nghĩa là "một REST API dùng để chạy các quy trình kéo dài do agent điều khiển trong một sandbox chuyên dụng, bền vững." Mỗi tenant nhận được một không gian làm việc riêng tư, một bearer token cùng các endpoint dành cho session, file, skill và tin nhắn dạng stream tại một địa chỉ như https://your-tenant.enterprise.pokee.ai. Quyền truy cập hiện dành cho khách hàng doanh nghiệp: tài liệu Pokee docs điều hướng khách hàng mới thông qua mục "Request demo", và không hề có thông tin về gói tự phục vụ hay gói miễn phí.
Hai phân cấp mô hình được liệt kê trên trang mô hình và giá cả:
| Mô hình | Đầu vào ($/triệu token) | Đầu ra ($/triệu token) | Đọc cache ($/triệu token) |
|---|---|---|---|
pokee-isaac-high-reasoning |
$3 | $15 | $0.30 |
pokee-isaac |
$0.30 | $5 | $0.10 |
Các tenant mới mặc định sẽ sử dụng phân cấp suy luận cao (high-reasoning). Mô hình sẽ được khóa cố định khi bạn tạo session, do đó mọi lượt chạy trong session đó đều hoạt động trên cùng một phân cấp mô hình.
Mô hình agent của Pokee: session, sandbox, file, skill và bộ nhớ
Mô hình agent của Pokee bao gồm năm thành phần cấu hình, và mỗi thành phần đều gắn liền với một quyết định của đội ngũ.
- Session. Một session là một tiến trình agent riêng biệt trong sandbox của chính nó bên trong pod chuyên dụng của bạn, có lịch sử, phạm vi tệp và trạng thái bận (busy) riêng.
- Chế độ lưu trữ bền vững (Persistent mode). Session mặc định sẽ tự hủy sau 5 phút kể từ phản hồi cuối cùng. Khi đặt
persistent: true, session sẽ duy trì cho đến hết thời gian sống TTL (mặc định là 4 giờ) hoặc cho đến khi bạn chủ động xóa. - Giới hạn phạm vi truy cập tệp (Scoped file access). Bạn truyền vào các đường dẫn
readvàwritelúc khởi tạo. Những đường dẫn nằm ngoài phạm vi này hoàn toàn không tồn tại trong hệ thống tệp của agent. - Kỹ năng (Skills). Bạn tải lên một tệp zip chứa
SKILL.mdở thư mục gốc. Mọi session mới trong tenant đều có thể nhìn thấy kỹ năng đó. - Tệp persona và bộ nhớ. Nội dung Markdown trong thư mục
.pokee/được gắn vào đầu system prompt, còn tệp.memory/MEMORY.mdlưu giữ thông tin xuyên suốt giữa các session.
Pokee giới hạn phạm vi truy cập tệp như thế nào?
Phạm vi truy cập được thực thi nghiêm ngặt qua hai lớp. Bên trong agent, một mount namespace bubblewrap theo từng session sẽ ẩn toàn bộ những gì nằm ngoài các đường dẫn được cấp phép, do đó thao tác đọc sẽ trả về lỗi ENOENT. Còn thông qua HTTP file API, yêu cầu tương tự sẽ nhận về mã lỗi 403 Forbidden.
Tài liệu scoped file access cookbook minh họa một session có thể đọc thư mục của một khách hàng cùng một thư mục template dùng chung, và chỉ được phép ghi vào thư mục output của khách hàng đó:
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"]
}
}'
Phạm vi truy cập là bất biến trong suốt vòng đời của session. Để mở rộng phạm vi, bạn phải hủy session hiện tại và tạo một session mới. Điều này vừa tăng cường khả năng tuân thủ bảo mật, vừa đặt ra yêu cầu cho đội ngũ: hãy xác định phạm vi ngay khi giao việc chứ không phải chờ đến giữa chừng.
Các tệp persona trong .pokee/ và bộ nhớ có vai trò gì?
Các tệp trong workspace/.pokee/*.md được nạp vào system prompt theo thứ tự bảng chữ cái, mỗi tệp nằm dưới một tiêu đề ## <filename>. Bản hướng dẫn persona cookbook gợi ý sử dụng 00_soul.md cho văn phong (voice), 10_glossary.md cho thuật ngữ chuyên ngành và 20_style_guide.md cho quy chuẩn định dạng. Toàn bộ thư mục bị giới hạn dung lượng tối đa là 1 MB.
Những thay đổi sẽ được áp dụng cho session tiếp theo; session đang chạy vẫn duy trì prompt ban đầu. Agent cũng đọc và cập nhật tệp .memory/MEMORY.md trong mỗi session; bạn có thể chỉnh sửa tệp này qua API tệp hoặc yêu cầu Pokee vô hiệu hóa tính năng này theo hướng dẫn trên trang ngữ cảnh agent.
Ý nghĩa của các AI agent chạy tác vụ dài đối với đội ngũ
Các AI agent chạy tác vụ dài làm thay đổi ba khía cạnh trong nhịp làm việc thường nhật của một nhóm: ai là người khởi động công việc, làm thế nào để biết công việc đang tiến triển, và ai là người phê duyệt nghiệm thu. Các hạn mức mặc định của Pokee phản ánh rất rõ điều này.
| Giới hạn | Mặc định |
|---|---|
| Số session đồng thời | 10 |
| Thời gian chờ tối đa cho một lượt (Turn timeout) | 90 phút |
| Thời gian sống của session (TTL) | 4 giờ |
| Số lượt chạy mỗi giờ / mỗi ngày | 300 / 5.000 |
| Số lượng token mỗi giờ / mỗi ngày | 20M / 200M |
| Dung lượng workspace tối đa | 100 GB |
Pokee cho biết các hạn mức này đều có thể được nâng lên theo yêu cầu.
Ai sẽ là người giao một tác vụ agent kéo dài 90 phút?
Mười session đồng thời nghe có vẻ dư dả cho đến khi năm thành viên cùng khởi chạy mỗi người hai tác vụ tạo báo cáo vào sáng thứ Hai. Một session đang bận cũng sẽ từ chối tin nhắn thứ hai bằng mã lỗi 409. Do đó, cần có người lựa chọn tác vụ, phân cấp mô hình, phạm vi tệp cùng session cụ thể, rồi ghi nhận tất cả vào một đầu việc có người phụ trách rõ ràng nhằm ngăn chặn tình trạng hai người cùng bấm chạy một tiến trình 90 phút giống nhau.
Làm thế nào để theo dõi tiến độ của một lượt chạy agent kéo dài?
Agent vẫn tiếp tục hoạt động kể cả khi client của bạn ngắt kết nối. Bản hướng dẫn long-running tasks cookbook chỉ ra cách thăm dò GET /v1/sessions/{id} mỗi 15 giây để kiểm tra cờ busy, đọc các khóa tiến độ mà quy trình ghi vào metadata, sau đó tải tệp kết quả về.
while True:
s = c.get(f"/v1/sessions/{sid}").json()
if not s["busy"]:
break
print(f"metadata: {s['metadata']}")
time.sleep(15)
Bản thân luồng stream sử dụng chuẩn Server-Sent Events, với các sự kiện message.created, message.completed, message.error và message.cancelled. Endpoint resume cho phép kết nối lại luồng stream bị gián đoạn dựa vào Last-Event-ID mà không bị tính phí token lần nữa. Cơ chế này thông báo cho script của bạn biết khi nào lượt chạy hoàn tất, chứ không thể đánh giá được chất lượng của bản báo cáo đó.
Ai sẽ phê duyệt kết quả trước khi đưa vào sử dụng?
Pokee sẽ xuất tệp ra workspace. Việc đánh giá là một bước thủ công của con người nằm ngoài API: ai đó sẽ mở tệp report.md, đối chiếu với bản tóm tắt yêu cầu (brief), rồi phê duyệt hoặc trả về yêu cầu sửa lại. Khi triển khai nhiều agent chạy song song, bước này thường là điểm nghẽn lớn nhất, đúng như luận điểm trong bài viết con người phê duyệt là điểm nghẽn.

Ví dụ thực tế: quy trình lập báo cáo cho khách hàng từ giao việc đến phê duyệt
Ba thành viên cùng làm việc chung trên một tenant Pokee. Sản phẩm cần bàn giao là một báo cáo thị trường theo quý dành cho "Acme Corp".
- Giao việc. Dana tạo một tác vụ: "Báo cáo thị trường Q3 cho Acme", người phụ trách là Dana, người đánh giá là Sam, hạn chót vào thứ Năm.
- Xác định phạm vi. Tác vụ nêu rõ mô hình Pokee cần dùng (
pokee-isaac-high-reasoning), các đường dẫn đọc (projects/acme-corp,shared/templates) và đường dẫn ghi (projects/acme-corp/output). - Khởi chạy. Dana tạo một persistent session với ID tác vụ được lưu trong
metadata, sau đó gửi một tin nhắn yêu cầu tạo báo cáo lưu tạioutput/report.md. - Theo dõi. ID của session được đính kèm vào phần bình luận của tác vụ. Bất kỳ ai kiểm tra
GET /v1/sessions/{id}đều sẽ thấy trạng tháibusy: truecho đến khi lượt chạy kết thúc. - Thu thập. Khi trạng thái
busychuyển sang false, Dana tải tệp về và đính kèm vào thẻ tác vụ. - Phê duyệt. Sam đối chiếu báo cáo với brief. Nếu chưa đạt yêu cầu, Sam để lại nhận xét và yêu cầu chạy lại một lượt mới; nếu đạt, nhiệm vụ sẽ được xác nhận hoàn thành.
- Dọn dẹp. Dana chủ động xóa session, hoặc tiến trình quét định kỳ hàng đêm
DELETE /v1/sessions?status=idle&older_than=1hsẽ dọn sạch session đó.
Các bước 1, 4 và 6 không phải là những lệnh gọi API. Chúng là sự phối hợp giữa người với người — khâu mà các nhóm thường bỏ qua khi agent xử lý quá nhanh, để rồi hối tiếc khi một tác vụ ngốn trọn cả tiếng đồng hồ.
Sharkly đóng vai trò gì trong quy trình làm việc với Pokee agent
Sharkly là nền tảng quản lý công việc cho agent: một bảng điều khiển tập trung nơi công việc được giao cho cả Con người lẫn Agent, các lượt chạy được theo dõi sát sao, và kết quả đầu ra sẵn sàng chờ con người phê duyệt. Sharkly không trực tiếp chạy các session Pokee và cũng không có trình kết nối riêng cho Pokee. Nền tảng này đóng vai trò điều phối tác vụ, người chịu trách nhiệm, trạng thái và toàn bộ quy trình phê duyệt xoay quanh chúng.
Trên thực tế, mô hình này vận hành như sau:
- Phân công nhiệm vụ. Tác vụ Pokee hiển thị trên bảng công việc cùng Người nhận việc (Assignee) và trạng thái cụ thể, nằm cạnh các đầu việc khác của cả nhóm. Xem bài viết về các đội ngũ tích hợp agent (agentic teams) để hiểu vì sao quyền sở hữu công việc luôn cần sự rõ ràng.
- Agent điều phối API. Một Sharkly Agent sẽ chạy trực tiếp trên Máy tính của bạn thông qua một Môi trường thực thi (Runtime) như Claude Code. Khi được cung cấp một kỹ năng đóng gói các lệnh curl ở trên, nó có thể tự tạo session, thăm dò tiến trình, rồi gửi lại session ID cùng kết quả vào chính thẻ tác vụ đó.
- Giới hạn lượt chạy tương thích với Pokee. Mỗi Agent đều có phần Cài đặt chạy (Run settings): số tác vụ đồng thời tối đa cho các công việc được giao, thời gian chạy tối đa mỗi tác vụ và thời gian chờ hàng đợi. Agent trong hình dưới đây được giới hạn ở mức 1 tác vụ và 40 phút; đối với tác vụ Pokee, bạn hãy duy trì số lượt chạy đồng thời ở mức bằng hoặc dưới 10 session của mình và đặt thời gian chạy đủ dài để bao quát trọn lượt 90 phút, hoặc thiết lập để Agent khởi động lượt chạy rồi quay lại kiểm tra sau.

- Phê duyệt là một trạng thái, không phải một mẩu tin nhắn. Agent có thể chuyển tác vụ sang trạng thái chờ con người đánh giá, và tác vụ đó sẽ xuất hiện ngay trong Hộp thư đến (Inbox) của người kiểm duyệt. Các bài viết về coding agent có sự tham gia của con người (human-in-the-loop) và các cổng phê duyệt cho coding agent giải thích chi tiết vị trí nên thiết lập các điểm dừng này.
- Kích hoạt từ bên ngoài. Tính năng Tự động hóa của Sharkly có thể tiếp nhận trigger qua webhook: một URL bảo mật có nhiệm vụ khởi động một lượt chạy khi có dịch vụ bên ngoài gửi yêu cầu POST đến. Bạn hoàn toàn có thể cho script của mình gọi URL này ngay khi một lượt chạy Pokee hoàn tất.
Sharkly hoàn toàn miễn phí khi bắt đầu, và chi phí sử dụng mô hình vẫn được tính trực tiếp trên các tài khoản bạn đang trả tiền. Để tìm hiểu sâu hơn về mô hình đánh giá cho các tác vụ chạy dài, hãy tham khảo bài viết các lượt chạy agent tiêu tốn hàng triệu token cần một hàng đợi đánh giá.
Khi nào nên chọn Pokee và khi nào không
Hãy sử dụng Pokee khi tác vụ tạo ra văn bản hoặc bộ dữ liệu thay vì thay đổi mã nguồn, thời gian xử lý từ vài phút đến một giờ và yêu cầu một sandbox bền vững. Đây là lựa chọn tối ưu khi hợp đồng có điều khoản nghiêm ngặt như "agent tuyệt đối không được tiếp cận dữ liệu của khách hàng B", nhờ cơ chế giới hạn phạm vi được thực thi chặt chẽ ngay từ cấp hệ thống tệp. Chế độ offline mode còn bổ sung thêm một tenant với đường ra bên ngoài duy nhất là API của mô hình.
Hãy tìm kiếm phương án khác nếu bạn cần bắt đầu ngay hôm nay mà không muốn thông qua quy trình trao đổi bán hàng (sales). Đối với nhu cầu lập trình trực tiếp trong các kho mã nguồn của nội bộ, Claude Code hoặc Codex chạy trên chính Máy tính của bạn sẽ là lựa chọn trực tiếp hơn. Nhiều đội ngũ sẽ vận hành song song cả hai hình thức, và một bảng công việc chung bao quát bên trên chính là giải pháp lý tưởng.
Kết luận
Các AI agent của Pokee cung cấp cho đội ngũ khả năng xử lý công việc chạy dài với môi trường cô lập thực sự. API sẽ giải quyết câu hỏi "lượt chạy đã xong chưa?". Nhưng đội ngũ của bạn vẫn là bên xác định ai đã khởi chạy, agent đã can thiệp vào những đâu, và kết quả đầu ra có chuẩn xác hay không.
Hãy đưa ba câu trả lời đó vào một thẻ tác vụ trước khi session đầu tiên bắt đầu. Nếu bạn muốn có một bảng điều phối chung cho cả các lượt chạy Pokee lẫn các coding agent của mình, hãy tạo ngay một workspace trên Sharkly và giao tác vụ chạy dài đầu tiên cho một Agent trong tuần này.
Câu hỏi thường gặp
Pokee Enterprise API là gì?
Pokee Enterprise API là một REST API dùng để chạy các quy trình làm việc kéo dài của agent trong một sandbox chuyên dụng, bền vững cho từng tenant. Bạn sẽ nhận được các endpoint dành cho session, file, skill, tin nhắn dạng stream và theo dõi mức sử dụng, xác thực qua bearer token.
Một Pokee agent có thể chạy trong bao lâu?
Mỗi lượt chạy (turn) mặc định tối đa 90 phút và mỗi session tối đa 4 giờ; cả hai mốc này đều có thể được nâng lên theo yêu cầu.
Pokee AI có miễn phí không?
Tài liệu không đề cập đến gói miễn phí. Quyền truy cập được cấp thông qua yêu cầu demo, và chi phí sử dụng tính theo token: $3 đầu vào và $15 đầu ra cho mỗi triệu token trên pokee-isaac-high-reasoning, $0.30 và $5 trên pokee-isaac.
Điều gì xảy ra nếu hai người cùng gửi tin nhắn vào cùng một session trên Pokee?
Tin nhắn thứ hai sẽ nhận mã lỗi 409: session đang bận xử lý một tin nhắn khác. Mỗi session chỉ xử lý một lượt tại một thời điểm, do đó các công việc chạy song song cần các session riêng biệt, tối đa là 10 session theo mặc định.
Pokee agent có thể ghi nhớ thông tin giữa các session không?
Có. Agent sẽ đọc và cập nhật tệp workspace/.memory/MEMORY.md trong mỗi session, và tệp này vẫn tồn tại sau khi pod khởi động lại.
Sharkly có thể chạy trực tiếp các Pokee agent không?
Không. Sharkly không có trình kết nối trực tiếp với Pokee. Một Sharkly Agent trên Máy tính của bạn có thể gọi Pokee API thông qua một skill, và tác vụ trên Sharkly sẽ đảm nhận việc phân công, quản lý trạng thái và quy trình phê duyệt của con người.



