Pi Agent Platform
v1.27.0 docs · VI Commands

Piagent 1.27.0

Coding agent cho cả team, kiểm tra từng bước.

Một dashboard cho Terminal và trình duyệt. Dùng model bằng tài khoản của bạn, hoặc model của công ty qua Agent Watch và Agent Studio. Guard kiểm tra từng tool call; ở chế độ công ty, Harness của team tự yêu cầu chạy check, cho subagent review và báo kết quả ngay dưới câu trả lời.

Bản 1.9.0

Một lượt làm việc ở chế độ công ty

Bạn nhắn việc cần làm. Agent đọc, sửa và chạy test trong sandbox; một subagent review bản sửa; dòng cuối ghi kết quả. Đã chạy thật 13/13 kịch bản trên bản cài cuối, 27/27 test trình duyệt.

Dashboard Piagent: một lượt ở chế độ công ty với các bước đọc, sửa, chạy test và dòng Check đã qua trên code cuối, Review không có lỗi chặn
Dashboard Piagent ở chế độ công ty. Xem toàn cảnh ở Hệ sinh thái và mọi thay đổi ở Có gì mới.

Production V1 · bằng chứng lịch sử của v1.6.0

Đo được, không phải nói suông

Run gắn với release production-v1-20260824T040017Z-05b7cf đã đo 108 session bằng GPT-5.6 Luna Medium tại tag v1.6.0, đúng commit 3bba8f0b3ff521bc2a355e1f6bef6d1bbdc09511, với Piagent so với codex-cli.

Bằng chứng release v1.6.0 đúng commit 3bba8f0
Task resolved 54/54 Piagent; codex-cli đạt 48/54
Fresh token -61,43% tỷ lệ family fixed-workload chính 0,3857
Bằng chứng usage 108/108 exact không có retry
Piagent codex-cli

Tỷ lệ fresh token theo family fixed-workload

Piagent
0,3857
codex-cli
1,0000

Task resolved

Piagent
54/54
codex-cli
48/54

Tỷ lệ family fixed-workload chính là 0,3857, với khoảng tin cậy 95% 0,3073–0,4840. Ước lượng điểm thấp hơn 61,43%; theo cận trên của khoảng tin cậy, có thể phát biểu thận trọng rằng Piagent dùng ít hơn ít nhất 51,60% fresh token trên đúng workload production-v1 đã khai báo trước và đúng release này. Usage của cả 108 session đều exact và không có retry. Xem phương pháp benchmark và ranh giới bằng chứng.

Cài trong hai lệnh

Node.js >=22.19.0. Chạy từ đúng project muốn set up.

npm install -g @piagent/platform
piagent-setup

piagent-setup cài đúng Pi Coding Agent host mà release này pin, cài Pi package, khởi tạo thư mục hiện tại, rồi chạy doctor. Nó cũng cài MCP baseline và subagents — bỏ qua bằng --no-mcp, --no-subagents hoặc --global-only. Chi tiết ở Quickstart.

Bắt đầu từ đâu

Bản 1.27.0

Có gì mới

Team memory: agent công ty nhớ quyết định và quy tắc của team trong từng repo; ở 1.26.1: đổi tên cuộc trò chuyện được cả khi lượt đang chạy; ở 1.26.0: lệnh / và phím tắt của Terminal ngay trên dashboard, /undo hoàn tác lượt trước của agent, dev server chạy qua nhiều lượt; ở 1.25.0: thiếu môi trường thì agent xin quyền và chạy được sau khi bạn duyệt (run_on_host ngoài sandbox, start_docker mở Docker ngay trong cuộc trò chuyện); ở 1.24.0: chọn Fast ngay trên trang tạo cuộc trò chuyện công ty, nút Fast đổi màu vàng khi đang bật; ở 1.23.1: câu hỏi của agent luôn nằm cuối cuộc trò chuyện, ngay trên ô nhập, và dễ đọc hơn; ở 1.23.0: nút Fast cho cuộc trò chuyện công ty khi Harness cho phép, tool lỗi được báo về Studio (Logs → Tool lỗi), cuộc trò chuyện mới gửi được tin nhắn đầu sau khi Harness đổi; ở 1.22.1: dashboard không còn quay mãi khi project nằm trên ổ Windows nhìn từ WSL (/mnt/d…) hoặc phiên công ty không trả lời; ở 1.22.0: đính kèm được mọi file code và văn bản (.html, .css, .ts, .py, Dockerfile…); ở 1.21.1: bật Bypass được cả khi lượt đang chạy và được giữ sau khi tải lại; ở 1.21.0: câu hỏi và yêu cầu duyệt hiện từng cái một (main agent trước), thông báo góc phải khi cuộc trò chuyện khác xong hay đang chờ bạn, Studio ghi lại mỗi lần compact; ở 1.20.0: cài package trong sandbox công ty không phải duyệt (npm, PyPI, Go, Maven, Gradle… qua proxy chỉ cho registry); ở 1.19.0: task công ty có checklist được làm đến hết, cuối mỗi lượt báo rõ xong, dừng giữa chừng hay lỗi, Docker trong sandbox công ty, folder chứa nhiều repo; ở 1.18.0: đổi nhánh Git trên dashboard, tự thử lại khi lỗi tạm thời, Claude Haiku 5.5; ở 1.17.0: dashboard hiện nhánh Git của project; ở 1.16.3: dashboard cập nhật xong vẫn tự kiểm tra bản mới; ở 1.16.2: Terminal nói giống dashboard: hỏi cập nhật, /bypass, lỗi và ghi chú Harness bằng tiếng Việt; ở 1.16.1: bản mới được báo bằng dialog và kiểm tra mỗi giờ, tab dashboard không còn mất đăng nhập; ở 1.16.0: Bypass cho cuộc trò chuyện công ty, đổi Harness không làm gián đoạn; ở 1.15.2: cuộc trò chuyện dài tự thu gọn trở lại; ở 1.15.1: Studio thấy mỗi call của model dùng để làm gì, nhiều cuộc trò chuyện trong một folder không nhận nhầm thay đổi của nhau; ở 1.15.0: subagent bị từ chối nói đúng lý do; ở 1.14: cập nhật giữ model bạn đã chọn; ở 1.13: cuộc trò chuyện giữ chỗ đang đọc, chữ của agent có định dạng, Piagent trên Windows qua WSL2: sandbox công ty bằng bubblewrap và Agent Watch cho Windows; ở 1.12: @ chọn file và folder trên máy, skill và command dùng bằng /, nhánh cuộc trò chuyện công ty gửi được tin nhắn.

Get started

Hệ sinh thái

Piagent, Agent Watch và Agent Studio: phần nào chạy ở đâu, khi nào dùng chế độ cá nhân hay công ty.

Get started

Quickstart

Cài, mở repo, chọn profile và quyền, rồi giao việc đầu tiên bằng lời thường.

Get started

Phạm vi platform

Vì sao repo này tồn tại khi đã có agent coding tổng quát, và ranh giới nó nhận về mình.

Build

Project profile

Chọn đường ray cho repo: protected path, verify command, capability được cấp.

MCP

MCP

Bốn layer config, preset đã pin, quản lý server, trạng thái auth, và approval gate cho server đến từ repo.

Operate

Security model

Policy enforcement layer chứ không phải OS sandbox — nói rõ chặn được gì và không chặn được gì.

Operate

Production benchmark

Điểm chất lượng, safety, workflow và biểu đồ token từ phép đo 108 session so với surface codex-cli.

Build

Command catalog

Slash command và terminal command, nhóm theo việc cần làm.

Tài liệu chia làm ba nhóm

Get started

Dành cho người chưa chạy lần nào: cài, quickstart, và vị trí của platform so với các agent CLI khác.

Build

Dùng hằng ngày: profile, permission, command, workflow — và MCP tách riêng vì có bề mặt lệnh của nó.

Operate

Người vận hành và review: security model, kiến trúc repo, terminal tool, cách team dùng như một chuẩn.