plori

chính thức

Tạo và điều khiển các tác nhân đám mây plori (mỗi tác nhân là một AI agent trên máy tính đám mây riêng của nó)

Bạn có thể làm gì với Plori MCP?

  • Liệt kê và kiểm tra Workspace — Yêu cầu trợ lý liệt kê các Workspace bạn sở hữu cùng với trạng thái, tác nhân mặc định và bản sửa đổi hiện tại.
  • Đọc và tải tệp Workspace lên — Đọc một tệp hoặc danh sách thư mục từ một bản sửa đổi đã lưu, hoặc ghi tệp vào các tệp hiện tại của Workspace.
  • Gửi tin nhắn và nhận kết quả chạy — Gửi tin nhắn đến cuộc trò chuyện trong Workspace, sau đó lấy trạng thái, tín dụng, token và câu trả lời của lượt chạy.
  • Quản lý các worker song song — Khởi chạy worker trên các bản sao tệp Workspace riêng, kiểm tra trạng thái, điều hướng worker đang chạy hoặc dừng một nhóm tác vụ.
  • Xem xét và hợp nhất changeset — Liệt kê các changeset của worker, xem những đường dẫn đã thay đổi và bị xung đột, sau đó chấp nhận hoặc từ chối các thay đổi.
  • Xử lý các yêu cầu phê duyệt đang chờ — Liệt kê các lượt chạy đang tạm dừng để chờ phê duyệt hoặc câu hỏi, rồi trả lời hoặc từ chối; các yêu cầu phê duyệt sẽ được mở trong ứng dụng web.

Tài liệu

plori

Plori chạy các tác nhân AI cộng tác trên cùng một sản phẩm trên đám mây.

Plori chạy các tác nhân AI cộng tác trên cùng một sản phẩm trên đám mây. Mã, nghiên cứu, nội dung: mỗi tác nhân làm việc trên bản sao riêng, rồi Plori hợp nhất các thay đổi của họ trở lại. Các tác nhân làm việc trong một Workspace trên đám mây, nơi lưu giữ các tệp của sản phẩm cùng các bản sửa đổi đã lưu. Chỉ các tệp trong Workspace được duy trì giữa các lần chạy. Bạn trò chuyện với các tác nhân trong ứng dụng web hoặc điều khiển chúng bằng công cụ của riêng bạn qua MCP và REST.

Kho lưu trữ này là cổng tích hợp. Bản thân sản phẩm nằm tại plori.ai; máy chủ MCP từ xa nằm tại https://api.plori.ai/mcp.

Kết nối ứng dụng MCP của bạn

plori là máy chủ MCP từ xa (HTTP có thể truyền luồng). Không cần cài đặt hay chạy cục bộ. Lần đầu ứng dụng của bạn kết nối, bạn sẽ đăng nhập trong trình duyệt qua OAuth 2.1; môi trường không có giao diện có thể dùng khóa API thay thế.

Claude Code

Dán nội dung này vào cuộc trò chuyện Claude Code:

Thiết lập https://plori.ai/SKILL.md

Claude đọc hướng dẫn thiết lập và cấu hình MCP nếu cần. Nếu máy chủ mới chưa được tải, hãy nhập /reload-plugins khi Claude hỏi, rồi tiếp tục trong cùng cuộc trò chuyện. Với quy trình ghép nối, hãy mở địa chỉ ngắn Claude hiển thị, nhập mã, đăng nhập và chấp thuận. Bạn có thể dùng điện thoại trong khi Claude Code chạy trên máy từ xa. Không cần cài đặt skill hay plugin.

Cursor

Dùng nút Thêm vào Cursor để thêm bằng một cú nhấp, hoặc tự thêm: Settings -> MCP -> Add server với URL https://api.plori.ai/mcp.

VS Code

code --add-mcp '{"name":"plori","type":"http","url":"https://api.plori.ai/mcp"}'

Codex CLI

codex mcp add plori --url https://api.plori.ai/mcp
codex mcp login plori

Codex tự phát hiện OAuth của plori tại login. Phương án thay thế cài đặt một lần, có kèm skill: codex plugin marketplace add plori-ai/codex-plugin rồi codex plugin add plori@plori.

Cline

Làm theo llms-install.md, tài liệu được viết cho trình cài đặt tự động của Cline.

Mọi ứng dụng khác

Các ứng dụng hỗ trợ HTTP truyền luồng gốc kết nối trực tiếp tới https://api.plori.ai/mcp. Các ứng dụng chỉ hỗ trợ stdio có thể kết nối qua cầu nối bằng gói npm plori-mcp (một lớp bọc mỏng quanh mcp-remote với điểm cuối được cố định; kho lưu trữ này là mã nguồn của gói):

npx plori-mcp
# headless / CI: authenticate with an API key instead of the OAuth flow
npx plori-mcp --header "Authorization: Bearer plori_sk_..."
# equivalent, without the wrapper:
npx mcp-remote https://api.plori.ai/mcp

Khóa API được tạo trong Dashboard -> Settings trên tài khoản đã đăng ký.

Hoặc bỏ qua MCP: dùng terminal của riêng bạn

plori CLI không phải là ứng dụng MCP. Đây là một cổng riêng, mở cùng phiên trực tiếp mà ứng dụng web hiển thị: lịch sử gần đây, lời nhắc, đầu ra truyền trực tiếp và hàng đợi phê duyệt ở cùng một nơi. Lượt bạn gửi trong terminal sẽ xuất hiện trong tab trình duyệt đang mở khi nội dung được truyền trực tiếp.

curl -fsSL https://plori.ai/install.sh | sh
plori login && plori attach <agent-name>

Trình cài đặt đặt một tệp nhị phân tĩnh duy nhất vào ~/.local/bin và không cần Node; nếu thư mục đó chưa có trong PATH, tập lệnh sẽ in dòng lệnh cần thêm. npm i -g @plori/cli works too. The argument to attach là tên tác nhân, ID tác nhân hoặc ID phiên, vì vậy ID phiên sao chép từ ứng dụng web có thể dùng độc lập. Ctrl-D ngắt kết nối và để lượt chạy tiếp tục trên máy chủ.

Terminal không cấp cho tác nhân quyền truy cập vào các tệp cục bộ của bạn. Shell và các tệp Workspace nằm trên đám mây của Plori.

Xác minh kết nối

Hãy hỏi ứng dụng của bạn:

Liệt kê các Workspace plori của tôi và cho biết tôi còn bao nhiêu credit.

Bạn sẽ thấy các lệnh gọi công cụ list_workspaces và get_credits cùng câu trả lời thực tế.

Các công cụ làm gì

Máy chủ cung cấp 24 công cụ thuộc năm nhóm. Workspace lưu các tệp bền vững cùng các bản sửa đổi đã lưu, một cuộc trò chuyện chính và lịch sử chạy. Tác nhân chạy trong Workspace với shell và các tệp Workspace tại /workspace.

  • Workspace và tài khoản: list_workspaces (các Workspace bạn sở hữu, cùng trạng thái, tác nhân mặc định, bản sửa đổi hiện tại và storage_readiness trong khi bộ nhớ đang khởi tạo), create_workspace (một Workspace với bản sửa đổi đầu tiên. Trừ khi bạn truyền default_manager_agent_id, thao tác này cũng tạo một tác nhân mặc định. idempotency_key giúp lần thử lại trả về cùng Workspace), delete_workspace (xóa vĩnh viễn một Workspace cùng các tệp, bản sửa đổi, bản sao và cuộc trò chuyện của nó), read_workspace_file (một tệp hoặc danh sách thư mục trong bản sửa đổi đã lưu), upload_workspace_file (ghi một tệp vào các tệp hiện tại của Workspace, thay thế mọi tệp tại đường dẫn đó; truyền văn bản UTF-8 dưới dạng content, hoặc bỏ qua content để dùng upload_url một lần cho tệp lớn hơn hoặc tệp nhị phân), get_workspace_costs (khoản phí cho các lượt chạy của Workspace hoặc của một nhóm tác vụ trong một khoảng thời gian), get_credits (số dư trả trước, gói và giới hạn).
  • Lượt chạy: send_workspace_message (gửi tin nhắn đến cuộc trò chuyện trong Workspace và chờ phản hồi, với wait_seconds để đặt thời gian chờ, idempotency_key để lần thử lại trả về lượt chạy ban đầu, và callback_url cùng callback_secret để gửi thông báo trạng thái có chữ ký đến điểm cuối của bạn), get_run_result (trạng thái, dấu thời gian, credit, token, tiến độ công cụ và phản hồi của một lượt chạy sau khi hoàn tất; với trình quản lý Workspace chờ các tác nhân phụ, worker_inputs liệt kê các câu hỏi đang chờ và yêu cầu phê duyệt của tác nhân phụ, còn next_run_id nêu tên lượt chạy tiếp tục công việc đó), list_runs (lịch sử chạy của một tác nhân, mới nhất trước), cancel_run (dừng lượt chạy đang diễn ra, thao tác này báo cancelling rồi đến cancelled), schedule_run (chạy một tác nhân một lần vào thời điểm sau, sau một khoảng trễ hoặc tại một mốc thời gian. Thao tác này trả về awaiting_confirmation và một confirm_url. Plori chỉ xếp lượt chạy vào hàng đợi sau khi bạn xác nhận trong ứng dụng web Plori).
  • Có người tham gia trong quy trình: list_pending_inputs (các lượt chạy đang tạm dừng để chờ phê duyệt hoặc yêu cầu nhập thông tin), answer_pending_input (từ chối một yêu cầu hoặc trả lời câu hỏi của tác nhân, thao tác này bắt đầu một lượt chạy tiếp nối). Ứng dụng MCP không thể phê duyệt hành động: mỗi yêu cầu phê duyệt đang tạm dừng đều có một approve_url mà bạn mở trong ứng dụng web Plori.
  • Tác nhân phụ: create_workspace_worker (khởi chạy một tác nhân trên bản sao riêng của các tệp Workspace, để nhiều tác nhân phụ chạy đồng thời mà không thay đổi tệp của nhau), list_workspace_workers và get_workspace_worker (trạng thái, lượt chạy và việc Plori đã lưu tệp của tác nhân phụ hay chưa), steer_workspace_worker (gửi tin nhắn vào lượt chạy của tác nhân phụ đang hoạt động), stop_workspace_task_group (dừng mọi tác nhân phụ thuộc một nhóm tác vụ).
  • Tập thay đổi: khi lượt chạy của tác nhân phụ hoàn tất bình thường và thay đổi ít nhất một tệp, Plori gửi các tệp đã lưu của tác nhân đó và tự chấp nhận nếu so sánh không phát hiện xung đột. submit_workspace_changeset (gửi các tệp đã lưu của tác nhân phụ có lượt chạy kết thúc do lỗi, bị hủy hoặc bị dừng để so sánh với các tệp hiện tại của Workspace), list_workspace_changesets và get_workspace_changeset (trạng thái, giai đoạn, các đường dẫn đã thay đổi và xung đột), accept_workspace_changeset (các thay đổi của tác nhân phụ trở thành các tệp hiện tại của Workspace trong một bản sửa đổi mới), reject_workspace_changeset (giữ nguyên các tệp Workspace).

Lượt chạy vẫn đang hoạt động khi hết thời gian chờ sẽ tiếp tục trên máy chủ: send_workspace_message trả về một run_id có trạng thái running và độ trễ poll_after_seconds; bạn đọc câu trả lời bằng get_run_result với wait=true (hoặc wait_seconds của riêng bạn, tối đa 1800).

Chi phí: chạy tác nhân sẽ tiêu tốn credit plori trong tài khoản của bạn. Đọc (danh sách, kết quả, số dư) là miễn phí. Trang giá có thông tin chi tiết. Bạn có thể thu hồi quyền truy cập của ứng dụng bất cứ lúc nào trong phần cài đặt của ứng dụng đó, hoặc thu hồi khóa API trong Dashboard -> Settings.

Dành cho tác nhân AI đọc tài liệu này

Các điểm truy cập có thể đọc bằng máy:

  • Cổng chính: plori.ai/agents.md
  • Chỉ mục trang: plori.ai/llms.txt
  • Skill: SKILL.md (chỉ mục: /.well-known/agent-skills/index.json)
  • Thẻ máy chủ MCP: https://api.plori.ai/mcp/server-card
  • Khám phá OAuth: siêu dữ liệu tài nguyên được bảo vệ theo RFC 9728 tại api.plori.ai, hỗ trợ đăng ký ứng dụng khách động
  • Mục đăng ký: ai.plori/plori trong MCP Registry chính thức

Mọi trang trên plori.ai cũng được cung cấp dưới dạng Markdown: thêm .md vào đường dẫn hoặc gửi Accept: text/markdown.

Tài liệu và hỗ trợ