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 run

Chạy một chương trình trên một relay device đang trực tuyến của bạn với secret trong vault đặt vào môi trường, rồi in đầu ra đã che giá trị; không chạy gì cục bộ (bản xem trước).

Dùng ak secrets remote run trên một máy không được giữ secret, như sandbox của Agent trên cloud. Lệnh gọi tool secrets_run của vault, và một relay device đang trực tuyến của bạn chạy chương trình với các secret trong môi trường của nó. Đầu ra trả về với mọi giá trị đã cấp phát được che đi. Hãy đăng nhập trước bằng ak secrets remote login.

Bản xem trước

Endpoint vault từ xa đ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.

Cách dùng

ak secrets remote run --env VAR=REF... [flags] -- PROGRAM [ARGS...]
ak secrets remote run --env GH_TOKEN=GITHUB_TOKEN -- gh release list
ak secrets remote run --project my-app --env DATABASE_URL=PROD_DB -- ./scripts/migrate-status.sh

Chương trình và các argument của nó phải đứng sau --; nếu không, lệnh thoát với mã 2.

Tuỳ chọn

CờMặc địnhMô tả
--env VAR=REFBắt buộcĐưa secret REF cho chương trình dưới tên VAR. Lặp lại từ 1 đến 16 lần.
--project stringKhông cóProject đã đăng ký trên relay device để chạy trong đó.
--vault-id stringKhông cóVault cần dùng khi các thiết bị trực tuyến giữ nhiều vault.
--timeout intDo thiết bị chọnSố giây thiết bị cho chương trình chạy, từ 1 đến 110.
--issuer stringhttps://agentkit.best, hoặc AGENTKIT_OAUTH_ISSUEROrigin của máy chủ cấp quyền.
--vault-origin stringhttps://vault.agentkit.bestOrigin của vault.

Các cờ dùng chung nằm trong quy ước CLI.

Lệnh kiểm tra các giới hạn sau trước khi gửi bất cứ thứ gì, và thoát với mã 2 khi vi phạm một giới hạn:

  • Từ 1 đến 64 argument của chương trình sau --.
  • Từ 1 đến 16 cặp --env. Mỗi VAR khớp [A-Z_][A-Z0-9_]*, dài tối đa 128 byte và chỉ xuất hiện một lần. Mỗi cặp phải nêu một secret.
  • --project dài tối đa 128 ký tự.
  • --timeout, khi được đặt, nằm trong khoảng 1 đến 110 giây.

Lệnh làm gì

Lệnh không chạy gì cục bộ. Lệnh gia hạn thông tin đăng nhập trong AGENTKIT_HOME/state/vault-remote.json khi cần, rồi nhờ vault chuyển lần chạy tới một thiết bị đang giữ kết nối relay bằng ak secrets sync now --watch --relay.

Relay device chỉ chạy chương trình khi một exec grant mà thiết bị giữ cho client này bao phủ mọi cặp VAR=REF. Thiết bị không bao giờ hỏi. Nếu không, thiết bị tạo một yêu cầu trong hộp duyệt của nó và lệnh này thoát với mã 8. Duyệt yêu cầu trên thiết bị đó bằng ak secrets approve hoặc hộp duyệt của AgentKit Desktop, 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.

Chương trình, các argument của nó và --project được phân giải trên relay device, không phải trên máy này.

Đầu ra

Stdout và stderr của chương trình được in ra stdout và stderr của lệnh này, với các giá trị đã cấp phát được thiết bị che đi. Việc che chỉ xoá đúng các giá trị nguyên văn; đầu ra 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.

Trước khi in, lệnh xoá những gì terminal sẽ thực thi: chuỗi escape ANSI, ký tự điều khiển trừ tab, xuống dòng và carriage return, các byte không phải UTF-8 hợp lệ, và các ký tự override hoặc isolate hai chiều (bidi).

Nếu thiết bị đã cắt bớt đầu ra cho vừa câu trả lời, lệnh in thêm secrets remote run: the device cut the output to fit its answer ra stderr.

Lệnh không có đầu ra JSON khi thành công, kể cả với --json. Với --json, một lần thất bại in error envelope chuẩn ra stderr.

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

Lệnh thoát với mã thoát của chương trình. Khi chương trình thoát với mã khác 0, lệnh in trước secrets remote run: the program exited N ra stderr, để mã 5, 6 hoặc 8 của chương trình không bị nhầm là một lần từ chối. Mã lớn hơn 255 được giới hạn ở 255.

Khi vault hoặc relay device từ chối lần chạy hoặc không hoàn tất được nó, lệnh thoát với:

MãÝ nghĩa
2Cờ hoặc argument không hợp lệ, hoặc vault thấy chúng không hợp lệ, hoặc cần --vault-id hay --vault-id không xác định.
3Relay device không có secret nào theo một ref đã cho.
5Chưa đăng nhập, không có relay device nào trực tuyến, thiết bị không trả lời kịp (khi đó không biết kết quả), hoặc vault không phục vụ được lần chạy. Khi không có thiết bị trực tuyến, thông báo yêu cầu khởi động ak secrets sync now --watch --relay trên một thiết bị giữ vault.
6Relay device từ chối lần chạy, ví dụ không tìm thấy chương trình hoặc chương trình không được phép.
8Không exec grant nào bao phủ lần chạy; một yêu cầu đang chờ ak secrets approve trên relay device.
9Quá nhiều lời gọi; thử lại sau. Thông báo nêu số giây cần chờ khi vault gửi kèm.

Lệnh liên quan