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 login

Đăng nhập bằng mã thiết bị để máy này chạy được lệnh qua vault, hoặc xuất refresh token cho kho secret của một sandbox trên cloud (bản xem trước).

Dùng ak secrets remote login trên máy sẽ chạy ak secrets remote run. Lệnh chạy luồng OAuth device authorization grant: bạn mở một đường link trên bất kỳ thiết bị nào đang đăng nhập agentkit.best và xác nhận một mã.

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. Nếu máy chủ đăng nhập chưa hỗ trợ đăng nhập bằng mã thiết bị, lệnh thất bại với mã thoát 5.

Cách dùng

ak secrets remote login [flags]
ak secrets remote login
ak secrets remote login --export

Tuỳ chọn

CờMặc địnhMô tả
--exportTắtIn refresh token ra stdout cho một kho secret thay vì giữ lại. Không có dạng --json.
--scope stringvault-mcp:useCác OAuth scope cần xin.
--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 làm gì

Lệnh in một đường link và một mã ra stderr, kèm số phút còn lại trước khi mã hết hạn, rồi chờ bạn xác nhận. Quyền được cấp chỉ cho phép chạy lệnh (scope vault-mcp:use) và có hiệu lực 30 ngày.

Khi không dùng --export, thông tin đăng nhập được ghi vào AGENTKIT_HOME/state/vault-remote.json với mode 0600, thay cho lần đăng nhập trước nếu có. Thông tin đăng nhập đã lưu gắn với một issuer và một vault origin; một lần remote run sau đó với issuer hoặc vault origin khác sẽ yêu cầu bạn đăng nhập lại.

Refresh token đổi mới sau mỗi lần dùng, và gửi lại một token đã dùng sẽ thu hồi quyền. Vì vậy token chỉ được giữ trong đúng file đó và được gia hạn dưới một khoá (AGENTKIT_HOME/locks/vault-remote.lock), chờ tối đa 2 phút nếu một tiến trình ak khác đang giữ khoá. Nếu filesystem không khoá được file, lệnh cảnh báo một lần rằng các lệnh ak secrets remote chạy song song không được xếp tuần tự; hãy chạy từng lệnh một. Nếu câu trả lời của một lần gia hạn bị mất trên đường truyền, lần gia hạn kế tiếp có thể thấy quyền đã bị thu hồi; khi đó hãy chạy lại ak secrets remote login.

Sandbox trên cloud

Với --export, refresh token được in một lần ra stdout và máy này không giữ lại gì. Đặt token đó làm AK_VAULT_MCP_REFRESH_TOKEN trong kho secret của sandbox. Một máy chưa có thông tin đăng nhập đã lưu sẽ dùng biến này làm hạt giống (seed) một lần. Seed bị dùng hết ngay ở lần dùng đầu tiên, nên mỗi sandbox không giữ lại thư mục home của AgentKit cần một lần đăng nhập riêng. Seed đã dùng sẽ bị từ chối, kèm thông báo chạy ak secrets remote login hoặc đặt một token mới.

Đầu ra

Khi thành công, lệnh in Signed in. `ak secrets remote run` can now use <vault origin>. ra stderr. Với --export, stdout chỉ chứa refresh token.

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. --export cùng --json bị từ chối trước mọi lời gọi mạng, để token không bao giờ rơi vào log có cấu trúc.

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

MãÝ nghĩa
0Đã đăng nhập, hoặc đã xuất token.
1Lệnh thất bại.
2--export cùng --json, hoặc --issuer hay --vault-origin không hợp lệ.
5Đăng nhập thất bại: máy chủ không hỗ trợ đăng nhập bằng mã thiết bị, mã bị từ chối hoặc hết hạn, hoặc không lưu được thông tin đăng nhập.

Lệnh liên quan