Đ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.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 đó.
Xác minh kết nối
Ví dụ prompt
Khắc phục sự cố
Đã kết nối, nhưng prompt đầu tiên trả về 401
Đã kết nối, nhưng prompt đầu tiên trả về 401
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.
403, hoặc thiếu các service dự kiến
403, hoặc thiếu các service dự kiến
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.
404 cho một service hoặc cơ sở dữ liệu
404 cho một service hoặc cơ sở dữ liệu
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 đó.
429 rate limit
429 rate limit
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 hoặc thay đổi không diễn ra
Deploy hoặc thay đổi không diễn ra
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ự