Điều kiện tiên quyết
- Tài khoản Vercel nhìn thấy được team và các project bạn muốn điều tra.
- Quyền tạo access token cho team đó.
- Vai trò Admin trong workspace CloudThinker, là vai trò cần để thêm kết nối. Xem Vai trò.
Thiết lập
1
Tạo access token trong Vercel
Trong Vercel, mở menu avatar và vào Account Settings → Tokens (liên kết trực tiếp). Tạo token:
- Name:
cloudthinker - Scope: team duy nhất mà CloudThinker cần truy cập, hoặc tài khoản cá nhân của bạn. Token chỉ truy cập được phạm vi đó, nên nếu project của bạn trải trên nhiều team, hãy tạo mỗi team một token và thêm mỗi token thành một kết nối riêng.
- Expiration: chọn ngày hết hạn và ghi lịch xoay vòng vào lịch của bạn
2
Thêm kết nối trong CloudThinker
Trên thanh bên, nhấn More → Workspace settings → Connections. Ở tab Builtin Connections, tìm Vercel, dán token vào VERCEL_TOKEN, rồi nhấn Connect.Trạng thái thành công: thẻ Vercel trong CloudThinker hiển thị Connected. Với Vercel, trạng thái này chỉ có nghĩa là token đã được lưu, chưa chắc token dùng được.
3
Chạy prompt xác minh
Vercel chấp nhận mọi token khi kết nối khởi động và chỉ kiểm tra token ở lệnh gọi thực đầu tiên. Token gõ sai hoặc đã hết hạn vẫn hiển thị Connected, nên hãy chạy prompt xác minh trước khi dựa vào kết nối.Trạng thái thành công: CloudThinker trả về user, các team và project Vercel của bạn. Nếu thay vào đó trả về
403 Not authorized (invalidToken), token có vấn đề: xem Khắc phục sự cố.Chi tiết kết nối
Quyền yêu cầu
Token Vercel không có tùy chọn chỉ đọc. Phạm vi là công cụ kiểm soát chính: token giới hạn ở một team không truy cập được project của team khác.
Mọi thay đổi do agent thực hiện đều đi qua Approvals của workspace trước. Ở chế độ mặc định Auto · Rules + AI · Ask me, AI judgment có thể cho một thay đổi an toàn chạy mà không cần hỏi. Allow Rule cũng vậy, sau khi CloudThinker bật Rule enforcement cho workspace của bạn. Chọn Manual nếu bạn muốn tự phê duyệt mọi thay đổi.
Khả năng của agent
Gợi ý rollback chỉ mang tính tư vấn. CloudThinker không có công cụ để rollback hay redeploy trên Vercel.
Xác minh kết nối
Ví dụ prompt
Khắc phục sự cố
Để thay token trên kết nối hiện có, mở kết nối, nhấn biểu tượng sửa trên instance, nhấn Replace… trong Edit Instance, dán token mới, rồi nhấn Save and test. Xem Xoay vòng thông tin xác thực.Một team hoặc project thất bại với 403 Forbidden
Một team hoặc project thất bại với 403 Forbidden
Các request khác vẫn chạy, nhưng phạm vi của token không bao gồm team đó. Tạo token có phạm vi đúng team và thay vào kết nối.
404 Not Found với project hoặc deployment
404 Not Found với project hoặc deployment
Tên hoặc ID bị sai, hoặc thuộc về team nằm ngoài phạm vi của token. Hãy nhờ CloudThinker liệt kê project trước, rồi dùng tên trong danh sách đó.
Thao tác hủy hoặc tạm dừng không bao giờ chạy
Thao tác hủy hoặc tạm dừng không bao giờ chạy
Thao tác điều khiển đi qua Approvals trước, và CloudThinker không bao giờ thử lại một yêu cầu đã bị từ chối. Có thể một người đã từ chối ở chế độ Manual. Ở chế độ Auto, Approval mode có thể đang đặt Refuse khi không có gì cho phép thay đổi. Khi Rule enforcement đã bật, một Rule Deny cũng có thể từ chối hẳn. Hãy hỏi lại khi bạn muốn thao tác chạy.
Bảo mật
- Quyền tối thiểu — chỉ cấp các quyền mà agent cần cho trường hợp sử dụng của bạn; bắt đầu với quyền chỉ đọc và mở rộng sau.
- Chỉ đọc theo mặc định — sử dụng thông tin xác thực chỉ đọc trừ khi bạn muốn agent thực hiện thay đổi qua kết nối này.
- Xoay vòng thông tin xác thực — xoay vòng khóa và token theo lịch trình thông thường của bạn; CloudThinker sẽ lấy giá trị mới khi bạn cập nhật kết nối.
- Thu hồi khi bàn giao — xóa thông tin xác thực tại nhà cung cấp khi bạn xóa một kết nối hoặc khi đồng nghiệp rời nhóm.
- Không có token chỉ đọc: Vercel không có loại thông tin xác thực chỉ đọc, nên lời khuyên về chỉ đọc ở trên không áp dụng được ở đây. Hãy dùng token giới hạn theo team và chọn Manual để một người phê duyệt mọi thay đổi, cùng một Rule Deny hoặc Ask first khi Rule enforcement đã bật.
- Lên kế hoạch xoay vòng: token Vercel không tự xoay vòng. Đặt thời hạn khi tạo token và thay token trước ngày đó.
- Chú ý runtime log: ứng dụng có thể in secret vào chính log của nó. CloudThinker thay các giá trị trông giống thông tin xác thực trong output của công cụ bằng placeholder trước khi model hoặc chat nhìn thấy (xem Bảo vệ dữ liệu), nhưng secret có định dạng bất thường vẫn có thể lọt qua. Hãy giữ secret khỏi log ngay từ nguồn.
Liên quan
Approvals
Quyết định thao tác điều khiển Vercel nào tự chạy và thao tác nào chờ bạn
Tổng quan kết nối
Xem mọi nền tảng bạn có thể kết nối và cách xoay vòng thông tin xác thực