Chuyển đến nội dung chính
Kết nối Netlify để các agent CloudThinker có thể liệt kê team và project, tìm các deploy thất bại hoặc cũ, rà soát Netlify Forms và đọc extension, cũng như khởi chạy deploy hoặc thay đổi cài đặt project thông qua Approvals của bạn. Kết nối dùng một personal access token Netlify, có cùng quyền truy cập với người dùng đã tạo token. Netlify hiện gọi site là project, nên trang này cũng vậy.

​
Điều kiện tiên quyết

  • Một tài khoản Netlify thuộc các team bạn muốn điều tra.
  • Quyền truy cập user settings Netlify của tài khoản đó, để tạo token.
  • Một workspace CloudThinker nơi bạn có thể thêm kết nối.

​
Thiết lập

1

Tạo personal access token trong Netlify

Trong Netlify, vào User settings → Applications → Personal access tokens (liên kết trực tiếp). Tạo token:
  • Description: cloudthinker
  • Expiration: một thời hạn cố định, chẳng hạn 90 ngày, thay vì không hết hạn. Đặt lịch nhắc xoay vòng token.
Sao chép token ngay. Netlify chỉ hiển thị token một lầ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 Netlify, dán token vào Personal access token và nhấn Connect. CloudThinker kiểm tra token với Netlify trước khi lưu kết nối.Trạng thái thành công: thẻ Netlify hiển thị Connected với thông báo Netlify account verified. Sites: <count>. Netlify đã đổi tên site thành project, nên con số này là số project của bạn.
3

Chạy prompt xác minh (tùy chọn)

Chạy prompt xác minh trong một chat mới.Trạng thái thành công: CloudThinker liệt kê team và project của bạn cùng trạng thái deploy hiện tại của từng project.

​
Chi tiết kết nối

​
Quyền yêu cầu

Token Netlify không có scope. Token có thể làm mọi thứ người dùng của nó làm được, trong mọi team người dùng đó thuộc về. Quyền tối thiểu phụ thuộc vào tài khoản bạn dùng để tạo token.
Tạo token từ một người dùng Netlify riêng chỉ thuộc các team CloudThinker cần, với team role thấp nhất có thể đọc project và deploy. Tránh dùng tài khoản Owner.

​
Khả năng của agent

Mọi lệnh gọi Netlify không phải thao tác đọc đều đi qua Approvals. 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. Khi một người phê duyệt, CloudThinker nêu rõ tác động và các đầu vào chính xác trước. Hãy đọc kỹ với form submission và biến môi trường, vì những thay đổi đó có thể làm mất dữ liệu.

​
Xác minh kết nối

​
Ví dụ prompt

​
Khắc phục sự cố

Netlify đã từ chối token khi CloudThinker lưu kết nối. Tạo token mới trong User settings → Applications → Personal access tokens và kết nối lại.
Kết nối không còn giữ token hoạt động, ví dụ vì token đã hết hạn. Tạo token mới, rồi mở kết nối, nhấn biểu tượng chỉnh sửa trên instance, nhấn Replace… trong Edit Instance, dán token và nhấn Save and test. Xem Xoay vòng thông tin xác thực.
ID sai, hoặc người dùng của token không thấy project đó. Hãy yêu cầu CloudThinker liệt kê project trước. Nếu thiếu project, thêm người dùng vào team sở hữu nó, hoặc tạo token từ người dùng đã thuộc team đó.
Netlify đã giới hạn tốc độ các yêu cầu. Đợi vài phút, rồi hỏi về từng team hoặc project một để mỗi lượt chạy thực hiện ít lệnh gọi hơn.
Thay đổi đi qua Approvals của bạn. Nếu một người đã từ chối, CloudThinker sẽ không thử lại. Hãy yêu cầu lại khi bạn muốn thay đổi đó 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.
  • Lên kế hoạch xoay vòng: token Netlify không tự xoay vòng. Đặt thời hạn khi tạo token và thay thế trước ngày đó.
  • Xem xét thay đổi biến môi trường: phê duyệt một thay đổi có thể làm lộ hoặc ghi đè một secret. Đọc tên và giá trị biến trước khi phê duyệt.
  • Coi dữ liệu form là nhạy cảm: form submission thường chứa dữ liệu cá nhân, nên hãy đối xử với những gì agent báo cáo về chúng theo cùng cách.

​
Liên quan

Kết nối Vercel

Thiết lập tương tự cho project và deployment trên Vercel

Approvals

Quyết định thay đổi nào tự chạy và thay đổi nào chờ bạn