Điều kiện tiên quyết
- Một tài khoản Neon có quyền truy cập vào các dự án bạn muốn CloudThinker kiểm tra.
- Quyền ủy quyền CloudThinker qua luồng OAuth của Neon.
- Một workspace CloudThinker chưa kết nối Neon.
CloudThinker hỗ trợ một kết nối Neon mỗi workspace. Để chuyển tài khoản, hãy xóa kết nối Neon hiện tại và kết nối lại.
Thiết lập
Ủy quyền CloudThinker
Đăng nhập vào tài khoản Neon sở hữu hoặc có quyền truy cập các dự án bạn muốn CloudThinker sử dụng, sau đó phê duyệt quyền truy cập.
Chi tiết kết nối
Neon sử dụng OAuth — không có trường kết nối nào cần nhập thủ công. CloudThinker tự động lưu trữ OAuth access token và refresh token sau khi luồng ủy quyền hoàn tất.| Trường | Mô tả |
|---|---|
| OAuth tokens | Được Neon cấp phát và lưu tự động; không cần nhập thủ công |
Quyền bắt buộc
CloudThinker kế thừa quyền truy cập Neon được cấp trong quá trình OAuth.- Thao tác đọc bao gồm liệt kê dự án, kiểm tra schema, xem xét metadata và phân tích slow query.
- Thao tác ghi như thực thi SQL, thay đổi branch, migration, thay đổi Neon Auth và cấp phát Data API yêu cầu quyền truy cập Neon tương ứng và phê duyệt rõ ràng trong CloudThinker.
Khả năng của agent
Sau khi kết nối, các agent có thể:| Khả năng | Mô tả |
|---|---|
| Khám phá dự án | Khám phá dự án Neon, dự án được chia sẻ, tổ chức, compute và bảng |
| Kiểm tra schema | Kiểm tra schema và metadata bảng |
| Phân tích truy vấn | Xem xét slow query và đề xuất tối ưu |
| Thực thi SQL | Chạy SQL hoặc transaction chỉ sau khi được người dùng phê duyệt rõ ràng |
| Quản lý branch | Quản lý branch, migration và Neon Auth — mỗi thao tác cần phê duyệt |
Xác minh kết nối
Ví dụ prompt
Khắc phục sự cố
Luồng OAuth không hoàn tất
Luồng OAuth không hoàn tất
Bạn có thể đang đăng nhập vào sai tài khoản Neon, hoặc phiên trình duyệt chưa đăng nhập Neon. Hãy đăng nhập vào đúng tài khoản Neon và thử lại luồng kết nối Neon trong CloudThinker.
CloudThinker thông báo Neon đã được kết nối
CloudThinker thông báo Neon đã được kết nối
Mỗi workspace chỉ cho phép một kết nối OAuth Neon. Hãy dùng kết nối Neon hiện có hoặc xóa nó trước khi kết nối lại.
Agent không tìm thấy dự án Neon dự kiến
Agent không tìm thấy dự án Neon dự kiến
Luồng OAuth có thể đã hoàn tất với tài khoản Neon không có quyền truy cập các dự án đó. Kết nối lại bằng tài khoản Neon sở hữu hoặc có quyền truy cập các dự án.
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.
- Phê duyệt cho thao tác ghi — giữ SQL, branch, migration, Auth và thay đổi Data API yêu cầu phê duyệt trong CloudThinker
- Kết nối lại cẩn thận — xóa kết nối workspace hiện tại trước khi chuyển tài khoản Neon
Liên quan
Kết nối MCP
Kết nối công cụ và dịch vụ tùy chỉnh qua MCP
Tony Agent
Phân tích và tối ưu cơ sở dữ liệu