AgentKit
Tài liệuBộ kitTham chiếu CLIỨng dụng Desktop
BetaBạn đang đọc tài liệu kênh beta (3.2.0-beta.10). Tính năng có thể thay đổi trước bản stable tiếp theo.Chuyển sang stable →

remote

ak secrets remote

Chạy một chương trình với secret trong vault trên một relay device đang trực tuyến của bạn, từ một máy không được giữ secret, như sandbox của Agent trên cloud (bản xem trước).

Dùng ak secrets remote trên một máy không được giữ secret, như sandbox của một coding Agent trên cloud. Lệnh nhờ endpoint remote MCP của vault chạy một chương trình trên một relay device đang trực tuyến của chính bạn, theo các exec grant của thiết bị đó, rồi in đầu ra với mọi giá trị đã cấp phát được che đi. Các giá trị không bao giờ tới máy gọi lệnh. Chạy lệnh nhóm không kèm lệnh con sẽ in help.

Bản xem trước

ak secrets remote là bản xem trước. Endpoint vault từ xa mà lệnh dùng đang ở giai đoạn tiền phát hành và có thể chưa dùng được với mọi tài khoản. Nếu máy chủ đăng nhập chưa hỗ trợ đăng nhập bằng mã thiết bị, ak secrets remote login thất bại với mã thoát 5.

Cách dùng

ak secrets remote <command>
ak secrets remote login
ak secrets remote run --env STRIPE_API_KEY=STRIPE_API_KEY -- stripe customers list

Lệnh nhóm không nhận argument và không có cờ riêng.

Quy trình

  1. Trên một thiết bị giữ vault, giữ một kết nối relay luôn mở:

    ak secrets sync now --watch --relay

    Xem Giữ một thiết bị trực tuyến.

  2. Trên máy không được giữ secret, đăng nhập bằng ak secrets remote login. Với sandbox không giữ lại thư mục home của AgentKit, hãy dùng --export trên một máy tin cậy và đặt token được in ra làm AK_VAULT_MCP_REFRESH_TOKEN trong kho secret của sandbox.

  3. Chạy chương trình bằng ak secrets remote run. Nếu không exec grant nào trên relay device bao phủ lần chạy, lệnh thoát với mã 8 và một yêu cầu chờ trên thiết bị đó. Duyệt yêu cầu ở đó bằng ak secrets approve, rồi chạy lại lệnh. Hãy duyệt mọi phạm vi mà một tác vụ cần trước khi tác vụ bắt đầu.

Những gì đi qua đâu

  • Giá trị secret tới relay device và chương trình mà thiết bị đó chạy, không bao giờ tới máy gọi lệnh.
  • Máy chủ vault thấy lệnh, tên biến và tên secret, cùng đầu ra đã che giá trị, trong bộ nhớ khi chuyển tiếp chúng.
  • Việc che chỉ xoá đúng các giá trị nguyên văn. Chương trình in một giá trị đã mã hoá, bị tách nhỏ hoặc chỉ một phần thì không bị phát hiện.

Lệnh con

LệnhKết quảTác động lên đĩa
ak secrets remote loginĐăng nhập bằng mã thiết bị, hoặc xuất refresh token cho một sandbox.Ghi AGENTKIT_HOME/state/vault-remote.json (0600), trừ khi dùng --export.
ak secrets remote runChạy một chương trình trên relay device và in đầu ra đã che giá trị.Gia hạn thông tin đăng nhập trong cùng file khi cần. Không chạy gì cục bộ.

Không lệnh con nào đọc vault cục bộ.

Kết quả và mã thoát

MãÝ nghĩa
0Thành công.
1Lệnh thất bại.
2Cờ hoặc argument không hợp lệ.

Trang của từng lệnh con liệt kê mã thoát riêng.

Lệnh liên quan