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ó)

GitHubDùng thử MCP nàyĐược tài trợ

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

  • Quản lý agent — Yêu cầu liệt kê các agent plori của bạn, kiểm tra trạng thái của chúng, hoặc tạo và xóa agent theo tên thông qua list_agents, create_agent và delete_agent.
  • Chạy và theo dõi tác vụ — Gửi tin nhắn đến một agent bằng invoke_agent, theo dõi tiến trình với get_run_result, liệt kê lịch sử qua list_runs, hoặc hủy các lần chạy đang thực hiện bằng cancel_run.
  • Xử lý phê duyệt — Yêu cầu xem các lần chạy đang chờ đầu vào với list_pending_inputs và phê duyệt, từ chối, hoặc trả lời chúng qua answer_pending_input.
  • Lên lịch và tự động hóa quy trình làm việc — Tạo quy trình làm việc với create_workflow, lên lịch các lần chạy một lần qua schedule_run, hoặc thực thi ngay các quy trình đã xây dựng bằng run_workflow.
  • Kiểm tra mức sử dụng tài khoản — Yêu cầu số dư tín dụng của bạn với get_credits, xem lại chi tiêu theo đồng hồ đo hoặc agent qua get_usage, hoặc kiểm tra mức sử dụng đĩa với get_disk.

Tài liệu

plori

plori (plori.ai): một AI agent đám mây với môi trường bền vững riêng của nó - ổ đĩa lâu dài, công cụ CLI thực sự và bộ nhớ.

plori cung cấp agent: mỗi agent có một máy ảo bền vững với ổ đĩa thực, công cụ thực và bộ nhớ riêng. Các agent không hoạt động sẽ tự động thu nhỏ về không. Bạn trò chuyện với agent của mình trong ứng dụng web, hoặc điều khiển chúng từ công cụ của riêng bạn qua MCP và REST.

Kho lưu trữ này là cửa ngõ tích hợp. 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 MCP client của bạn

plori là một máy chủ MCP từ xa (streamable HTTP). Không có gì để cài đặt hoặc chạy cục bộ. Đăng nhập diễn ra trong trình duyệt của bạn qua OAuth 2.1 lần đầu tiên client của bạn kết nối; môi trường không có giao diện có thể dùng API key thay thế.

Claude Code

Dán đoạn này vào cuộc trò chuyện Claude Code của bạn:

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 gõ /reload-plugins khi Claude hỏi, sau đó tiếp tục trong cùng cuộc trò chuyện. Với tính năng ghép cặp, hãy mở địa chỉ ngắn Claude hiển thị, nhập mã, đăng nhập và phê duyệt. 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 kỹ năng hoặc plugin nào.

Cursor

Dùng nút một cú nhấp Add to Cursor, hoặc thêm thủ công: 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ự động phát hiện OAuth của plori trên login. Lựa chọn cài đặt một lần với kỹ năng được đóng gói: codex plugin marketplace add plori-ai/codex-plugin rồi codex plugin add plori@plori.

Cline

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

Bất kỳ client nào khác

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

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

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

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

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

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 trong ~/.local/bin và không cần Node; nếu thư mục đó chưa có trong PATH của bạn, tập lệnh sẽ in dòng cần thêm. npm i -g @plori/cli works too. The argument to attach là tên agent, id agent hoặc id phiên, vì vậy một id phiên sao chép từ ứng dụng web hoạt động độc lập. Ctrl-D tách rời và để lượt chạy tiếp tục trên máy chủ.

Terminal không cho agent quyền truy cập vào tệp cục bộ của bạn. Shell, ổ đĩa và các tệp là môi trường đám mây riêng của agent.

Xác minh kết nối

Hỏi client của bạn:

Liệt kê các agent plori của tôi và cho tôi biết tôi còn bao nhiêu tín dụng.

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

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

Máy chủ hiển thị 25 công cụ trong năm nhóm.

  • Agents (Plori Router chọn mô hình của mỗi agent theo nhiệm vụ): list_agents (các agent của bạn, với mô hình và trạng thái phiên trực tiếp), get_agent (tên, loại, mô hình và trạng thái của một agent, cùng hộp thư chứa thư từ các agent khác trên tài khoản), create_agent (lấy hoặc tạo một agent theo tên, tái sử dụng agent hiện có cùng tên thay vì tạo bản trùng lặp), delete_agent (xóa vĩnh viễn một agent và thu hồi ổ đĩa của nó).
  • Runs: invoke_agent (gửi một tin nhắn và chờ phản hồi, với wait_seconds để đặt thời gian giữ, idempotency_key để làm cho lần thử lại trả về lượt chạy gốc, và callback_url cùng callback_secret để đăng một thông báo trạng thái đã ký đến điểm cuối của bạn), get_run_result (trạng thái của một lượt chạy, dấu thời gian, tín dụng, token, tiến trình công cụ và phản hồi khi hoàn tất), list_runs (lịch sử lượt chạy của một agent, mới nhất trước), cancel_run (dừng một lượt chạy đang diễn ra, báo cáo cancelling rồi cancelled), schedule_run (gọi một agent một lần sau đó, sau một độ trễ hoặc tại một dấu thời gian).
  • Human-in-the-loop: list_pending_inputs (các lượt chạy tạm dừng trên một phê duyệt hoặc một yêu cầu đầu vào), answer_pending_input (phê duyệt, từ chối hoặc trả lời một yêu cầu, bắt đầu một lượt chạy tiếp tục).
  • Workflows: list_workflows (mọi workflow, hoặc của một agent với agent_id, hoặc các workflow chưa được gán với agent_id="none"), get_workflow (siêu dữ liệu và dự kiến bước được ghim để thực thi), get_workflow_version (định nghĩa đầy đủ của một phiên bản chính xác và các giá trị tham số), create_workflow (một workflow trống trên một trình kích hoạt thủ công, cron hoặc webhook, để một agent xây dựng), edit_workflow (một lô các chỉnh sửa bị ràng buộc như một bản nháp mới, dưới cơ chế so sánh và hoán đổi trên base_version), set_workflow_agent (gán một trong các agent của bạn cho một workflow, thường sau khi delete_agent báo cáo các workflow tạm dừng hoặc run_workflow trả về workflow_agentless), run_workflow (chạy một workflow đã xây dựng ngay bây giờ, như một thực thi thực sự, được tính phí), list_workflow_executions (các thực thi gần đây với trạng thái, lỗi, nguồn kích hoạt, thời gian và tín dụng), get_workflow_execution (đầu vào và đầu ra từng bước của một thực thi dưới dạng payload).
  • Account: get_credits (số dư và gói), get_usage (chi tiêu theo đồng hồ đo và theo agent), get_disk (byte bao gồm, đã mua và đã sử dụng), empty_trash (làm trống vĩnh viễn thùng rác của một agent để các tệp đã xóa ngừng tính vào ổ đĩa; chỉ khi pod của agent đó đang ngủ), list_connections (các nhà cung cấp OAuth bên thứ ba của bạn với trạng thái, thời gian ủy quyền và hết hạn, và các phạm vi được cấu hình cho mỗi nhà cung cấp, không bao giờ là token hoặc bí mật client).

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

Chi phí: tạo và chạy agent tiêu tốn tín dụng plori từ tài khoản của bạn. Đọc (danh sách, kết quả, số dư) miễn phí. Trang giá có chi tiết. Thu hồi quyền truy cập của client bất kỳ lúc nào trong cài đặt client của bạn, hoặc thu hồi API key trong Dashboard -> Settings.

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

Các điểm vào có thể đọc bằng máy:

  • Cửa ngõ chính: plori.ai/agents.md
  • Chỉ mục trang: plori.ai/llms.txt
  • Kỹ năng: 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ệ RFC 9728 trên api.plori.ai, hỗ trợ đăng ký client độ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 phục vụ 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ợ