Chuyển đến nội dung chính
Kết nối Render để CloudThinker có thể giải thích vì sao một deploy thất bại, đọc log build và runtime, kiểm tra số liệu service, và xem xét các instance Render Postgres và Key Value của bạn. Kết nối dùng Render API key, và mọi thao tác thay đổi service của bạn (deploy, cập nhật biến môi trường, tạo tài nguyên mới) đều phải qua Approvals của workspace trước.

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

  • Một tài khoản Render thấy được workspace bạn muốn CloudThinker điều tra.
  • Quyền tạo API key trên tài khoản đó.
  • Một workspace CloudThinker nơi bạn có thể thêm kết nối.

Thiết lập

1

Tạo Render API key

Trong Render Dashboard, mở Account Settings → API Keys (liên kết trực tiếp) và tạo một key tên cloudthinker.Sao chép key ngay. Render chỉ hiển thị giá trị đầy đủ 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 Render, dán key vào RENDER_API_KEY và nhấn Connect.Trạng thái thành công: thẻ Render hiển thị trạng thái Connected.
3

Chạy prompt xác minh

Gửi prompt trong Xác minh kết nối ở một chat mới. Đừng bỏ qua bước này: Render vẫn chấp nhận bước bắt tay kết nối kể cả khi key sai, nên key sai chỉ lộ ra khi yêu cầu đầu tiên chạy.Trạng thái thành công: CloudThinker liệt kê các workspace và service Render của bạn theo tên.

Chi tiết kết nối


Quyền yêu cầu

Render API key không có scope. Key hoạt động với tư cách tài khoản đã tạo ra key và truy cập mọi workspace và service mà tài khoản đó thấy được.
Để đảm bảo quyền tối thiểu, hãy tạo key từ một tài khoản chỉ thuộc workspace mà CloudThinker cần điều tra, không phải từ tài khoản owner thấy mọi thứ bạn host.

Khả năng của agent

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.
Truy vấn Postgres chạy ở phía Render: Render host server mà CloudThinker gọi (một MCP server, cách tiêu chuẩn để AI agent gọi các công cụ của một dịch vụ), và chạy SQL bằng API key của bạn. CloudThinker không bao giờ giữ thông tin xác thực cơ sở dữ liệu. Vì truy vấn là thao tác đọc, không Rule nào có thể tắt được. Để CloudThinker không chạm tới một cơ sở dữ liệu, hãy tạo key từ tài khoản không thấy cơ sở dữ liệu đó.
Deploy đưa mã ra phục vụ lưu lượng thật, và cập nhật biến môi trường có thể khởi động lại service. Đọc thay đổi được đề xuất trong yêu cầu phê duyệt trước khi chấp nhận. Yêu cầu thay đổi biến môi trường liệt kê toàn bộ tập kết quả, bao gồm cả giá trị, nên hãy coi cuộc chat đó là nhạy cảm.

Xác minh kết nối

Ví dụ prompt


Khắc phục sự cố

Key sai hoặc đã bị thu hồi. Bước bắt tay của Render vẫn thành công khi key không hợp lệ, nên lỗi xuất hiện ở yêu cầu đầu tiên. Tạo key mới trong Account Settings → API Keys. Sau đó 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 key và nhấn Save and test.
Tài khoản của key không phải thành viên của workspace đó. Yêu cầu CloudThinker liệt kê các workspace Render để xem key truy cập được những gì, rồi tạo key từ tài khoản thuộc đúng workspace.
Service hoặc cơ sở dữ liệu đã bị đổi tên hoặc xóa, hoặc tên không khớp. Yêu cầu CloudThinker liệt kê các service Render, rồi gọi service theo tên trong danh sách đó.
Render đang giới hạn tốc độ yêu cầu. Đợi một phút và thử lại với yêu cầu hẹp hơn, chẳng hạn một service hoặc khoảng thời gian log ngắn hơn.
Deploy, cập nhật biến môi trường và tài nguyên mới đi qua Approvals, và một số chờ người duyệt. Kiểm tra chat xem có yêu cầu phê duyệt đang chờ không và trả lời trước khi yêu cầu lại.

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.
  • Key chỉ hiển thị một lần: Render chỉ hiển thị đầy đủ API key khi tạo, nên hãy lưu vào trình quản lý mật khẩu trước khi rời trang.
  • Đặt lịch xoay vòng: Render API key không hết hạn, nên hãy thay key theo lịch cố định và thu hồi key cũ.
  • Phạm vi toàn tài khoản: vì key truy cập mọi workspace mà tài khoản tạo key thấy được, hãy thu hồi key trong Render (Account Settings → API Keys, rồi xóa key) ngay khi bạn xóa kết nối.

Liên quan

Approvals

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

Kết nối Heroku

Kết nối một nền tảng ứng dụng khác với cách thiết lập tương tự