Điều kiện tiên quyết
- Tài khoản Neon thấy được các project bạn muốn điều tra.
- Role Admin của workspace trong CloudThinker để thêm kết nối. Xem Cách quyền truy cập hoạt động.
- Tùy chọn: extension
pg_stat_statementstrên các database bạn muốn phân tích truy vấn chậm. ChạyCREATE EXTENSION IF NOT EXISTS pg_stat_statements;trong SQL Editor của Neon Console (hoặc bất kỳ Postgres client nào), một lần trên mỗi database cần phân tích.
Thiết lập
1
Mở kết nối Neon
Trên thanh bên, nhấn More → Workspace settings → Connections. Trong tab Builtin Connections, tìm Neon và nhấn Connect.
2
Ủy quyền cho CloudThinker trong Neon
CloudThinker mở Neon trong cửa sổ mới. Đăng nhập bằng tài khoản Neon sở hữu hoặc truy cập được các project của bạn, rồi chấp thuận quyền truy cập. Để kết nối ở chế độ chỉ đọc, bỏ chọn Allow writes trên trang ủy quyền của Neon. Khi đó agent liệt kê được project, đọc được schema và liệt kê được truy vấn chậm, còn thay đổi branch, migration và các thao tác ghi khác sẽ không có. SQL thì khác: CloudThinker coi mọi câu lệnh chạy qua công cụ SQL của Neon là một thay đổi, kể cả
SELECT, nên câu lệnh nào cũng đi qua Approvals dù ô này được chọn hay không. Xem Quyền ghi. Khi Allow writes được chọn, CloudThinker có cùng quyền truy cập với tài khoản đó.Nếu cửa sổ không mở, trình duyệt đã chặn pop-up. CloudThinker sẽ hiện một hộp thoại thay thế: nhấn Open Neon trong hộp thoại đó.3
Quay lại CloudThinker
Chuyển về tab CloudThinker. Nếu bạn đã dùng hộp thoại Open Neon, hộp thoại tự đóng khi kết nối sẵn sàng.Trạng thái thành công: Neon hiện trạng thái Connected.
4
Chạy prompt xác minh
Chạy prompt xác minh để chắc chắn tài khoản đã ủy quyền thấy đúng các project bạn mong đợi.Trạng thái thành công: CloudThinker liệt kê các organization và project Neon của bạn cùng branch và compute.
Chi tiết kết nối
Neon không có trường nào cần điền. Neon cấp OAuth token trong quá trình ủy quyền và CloudThinker lưu chúng cho bạn. Mỗi workspace có một kết nối Neon. Để dùng tài khoản Neon khác, nhấn Disconnect trên kết nối Neon, rồi nhấn Connect và đăng nhập bằng tài khoản kia.Quyền yêu cầu
CloudThinker có quyền truy cập của tài khoản Neon bạn ủy quyền, chỉ giới hạn ở thao tác đọc nếu bạn đã bỏ chọn Allow writes trên trang ủy quyền của Neon. Dù chọn cách nào, hãy cân nhắc kỹ tài khoản bạn dùng.
Mọi thành viên của một organization Neon đều thấy mọi project trong organization đó. Để giới hạn những gì agent truy cập, hãy ủy quyền bằng một tài khoản Neon riêng không thuộc organization, và chỉ chia sẻ cho tài khoản đó các project agent cần. Các project này hiện dưới dạng shared project. Với production, đây là mặc định an toàn: một tài khoản chuyên dụng chỉ được chia sẻ các project agent cần, cùng Manual được chọn trước khi kết nối để một người phê duyệt từng câu lệnh.
Khả năng của agent
Chạy SQL hoặc
EXPLAIN trên compute đã scale về 0 sẽ đánh thức compute đó, và Neon tính phí thời gian compute chạy.
CloudThinker không bao giờ hoàn tất migration trong cùng bước đã chuẩn bị nó. Bạn thấy những gì sẽ thay đổi trước khi bất cứ thứ gì được áp dụng.
Xác minh kết nối
Ví dụ prompt
Quyền ghi
Tùy chọn chỉ đọc của Neon là ô Allow writes trên trang ủy quyền. Để thay đổi sau này, nhấn Disconnect, rồi Connect lại và đặt lại ô này. Khi cho phép ghi, mỗi câu lệnh SQL, thay đổi branch và migration đều được tính là một thay đổi. 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. Xem Hai chế độ để biết từng lựa chọn làm gì.- Phê duyệt mọi thao tác ghi production ngay hôm nay: chọn Manual để một người phê duyệt từng câu lệnh SQL, thay đổi branch và migration. Cách này luôn đúng, dù Rule enforcement đã bật hay chưa.
- Giới hạn những gì chính tài khoản Neon thay đổi được: kết nối lại với Allow writes được bỏ chọn.
SELECTvẫn chạy sau khi được phê duyệt, còn liệt kê project, branch và table, đọc schema, và danh sách truy vấn chậm vẫn hoạt động.
- Phê duyệt thao tác ghi production bằng Rule: thêm Rule Ask first trên kết nối Neon để một người phê duyệt từng câu lệnh SQL và migration.
- Biến kết nối thành chỉ đọc trên thực tế sau khi đã kết nối: thêm Rule Deny trên kết nối Neon áp dụng cho mọi thao tác. Mọi câu lệnh qua công cụ SQL của Neon đều được tính là thay đổi, kể cả
SELECT, nên Deny chặn toàn bộ SQL, điều mà bỏ chọn Allow writes không làm được.
1
Yêu cầu tạo Rule
Trong một cuộc chat, gõ
/create-policy Ask first for every write on the Neon connection. Để chặn, hãy yêu cầu Rule Deny.2
Kiểm tra đề xuất
Mở Approvals trên thanh bên, rồi Rules → Needs review, và mở Rule. Kiểm tra Effect là Ask first (hoặc Deny), Rule có huy hiệu Every operation, và Connections ghi đúng kết nối Neon của bạn. What would change cần hiện các thao tác ghi Neon gần đây ở trạng thái hỏi trước (hoặc bị từ chối).
3
Chấp nhận Rule
Chọn Rule và nhấn Accept.Trạng thái thành công: một thông báo xác nhận Rule đã được chấp nhận, và Rule chuyển sang tab Active.
Khắc phục sự cố
Cửa sổ ủy quyền đóng lại nhưng Neon không bao giờ hiện Connected
Cửa sổ ủy quyền đóng lại nhưng Neon không bao giờ hiện Connected
Trình duyệt có thể đang đăng nhập một tài khoản Neon khác, hoặc pop-up bị chặn. Đăng nhập đúng tài khoản Neon trên cùng trình duyệt, rồi nhấn Connect lại.
Agent không tìm thấy project bạn mong đợi
Agent không tìm thấy project bạn mong đợi
Bạn đã ủy quyền một tài khoản Neon không có quyền truy cập project đó. Nhấn Disconnect, rồi Connect bằng tài khoản thấy được project. Project được chia sẻ với bạn hiện dưới dạng shared project.
Phân tích truy vấn chậm không trả về gì hoặc bị lỗi
Phân tích truy vấn chậm không trả về gì hoặc bị lỗi
Database chưa bật
pg_stat_statements. Chạy CREATE EXTENSION IF NOT EXISTS pg_stat_statements;, để có một ít lưu lượng, rồi hỏi lại. Xem schema và chạy SQL vẫn hoạt động khi không có extension này.Kết quả truy vấn chậm trống sau một khoảng thời gian không hoạt động
Kết quả truy vấn chậm trống sau một khoảng thời gian không hoạt động
Neon không giữ dữ liệu
pg_stat_statements khi compute scale về 0, nên lịch sử bắt đầu lại mỗi lần compute thức dậy. Nếu cần lịch sử dài hơn, hãy tắt scale to zero trên compute bạn điều tra.Neon báo lỗi dù trước đó vẫn hoạt động
Neon báo lỗi dù trước đó vẫn hoạt động
Ủy quyền OAuth đã hết hạn hoặc bị thu hồi trong Neon. Nhấn Connect trong cảnh báo lỗi trên kết nối để ủy quyền 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.
- Mặc định không lấy connection string: agent không lấy connection string của database trừ khi bạn yêu cầu. Connection string chứa mật khẩu database và hiện trong chat, nên ai đọc được cuộc hội thoại cũng đọc được nó.
- Đường đi của dữ liệu: agent gọi máy chủ MCP do Neon vận hành tại
https://mcp.neon.tech/mcp. Yêu cầu SQL, branch, migration và kết quả của chúng đều đi qua máy chủ này, và kết quả hiện trong chat, nên được lưu cùng cuộc hội thoại. CloudThinker lưu OAuth token. - Cắt quyền truy cập: nhấn Disconnect trên kết nối Neon. Nếu quyền bị thu hồi từ phía Neon, kết nối hiện lỗi cho đến khi có người ủy quyền lại.
- Từ chối là dứt khoát: nếu bạn từ chối một câu lệnh SQL hoặc migration, CloudThinker không thử lại mà hỏi bạn muốn làm tiếp thế nào.
Liên quan
Kết nối Supabase
Project Postgres kết nối bằng OAuth, migration và log
Kết nối PostgreSQL
Kết nối trực tiếp tới bất kỳ database Postgres nào