Điều kiện tiên quyết
- Một project Pinecone chứa các index bạn muốn agent truy cập.
- Quyền tạo API key trong project đó.
- Để tìm kiếm và ghi: index được tạo với integrated embedding, nghĩa là Pinecone tự sinh vector từ văn bản bằng một embedding model được host sẵn. Index xây từ vector bạn tự embed có thể được liệt kê và mô tả, nhưng không thể tìm kiếm hay ghi qua kết nối này. Không chắc mình có loại nào? Hãy kết nối, rồi hỏi agent index nào dùng integrated embedding.
Thiết lập
1
Tạo API key
Trong Pinecone console, mở project mà agent cần đọc và vào API keys. Nhấn Create API key và đặt tên
cloudthinker. Nếu gói của bạn hiển thị tùy chọn quyền, đặt control plane và data plane ở chế độ chỉ đọc, trừ khi agent cần ghi (xem Quyền yêu cầu). Nhấn Create key.2
Sao chép key
Sao chép key ngay. Pinecone chỉ hiển thị key một lần.
3
Thêm kết nối trong CloudThinker
Trên thanh bên, nhấn More → Workspace settings → Connections, rồi trên tab Builtin Connections chọn Pinecone. Dán key vào PINECONE_API_KEY và nhấn Connect.Trạng thái thành công: kết nối hiển thị trạng thái Connected. Chạy prompt xác minh bên dưới để xác nhận key hoạt động với project của bạn.
Chi tiết kết nối
Để truy cập index trong project khác, thêm key từ project đó thành một kết nối riêng.
Quyền yêu cầu
Khả năng của agent
Kết nối không thể xóa bản ghi, namespace hay index.
Thao tác ghi tuân theo Rules và chế độ Approvals của workspace, như mọi thay đổi khác. Khi thao tác cần người phê duyệt, agent hiển thị trước chính xác tên index, namespace, embedding model và các bản ghi. Với index mới, hãy nêu cloud và region bạn muốn trong prompt, hoặc từ chối và nói rõ cần dùng cloud và region nào.
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.
Xác minh kết nối
__default__.
Ví dụ prompt
Khắc phục sự cố
Mọi yêu cầu đều lỗi 401
Mọi yêu cầu đều lỗi 401
Key bị thiếu, gõ sai, đã bị xóa hoặc thuộc project khác. Tạo key mới trong đúng project, rồi sửa kết nối và dán key vào PINECONE_API_KEY.
Tìm kiếm không trả về gì, hoặc một index không tìm kiếm được
Tìm kiếm không trả về gì, hoặc một index không tìm kiếm được
Index không dùng integrated embedding, hoặc namespace sai. Hỏi agent index nào dùng integrated embedding. Nếu bạn không nêu namespace, bản ghi thường nằm trong
__default__.Agent không tìm thấy index nào
Agent không tìm thấy index nào
Project chưa có index, hoặc key thuộc project khác. Kiểm tra project trong Pinecone console, hoặc yêu cầu agent tạo một index integrated embedding.
Thao tác ghi thất bại sau khi tôi đã phê duyệt
Thao tác ghi thất bại sau khi tôi đã phê duyệt
Key không có quyền ghi, hoặc index đích không dùng integrated embedding. Kiểm tra quyền của key trong Pinecone console.
Yêu cầu trả về 429
Yêu cầu trả về 429
Pinecone đang giới hạn tốc độ của project. Đợi một lát rồi hỏi lại, và tránh chạy nhiều tìm kiếm lớn cùng lúc.
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ột project cho mỗi key: tạo key trong đúng project mà agent cần truy cập, và xóa key trong Pinecone khi bạn gỡ kết nối.
- Chỉ đọc khi gói cho phép: key không có quyền ghi không thể tạo index hay upsert, dù thao tác có được phê duyệt hay không.
Liên quan
Approvals
Quyết định thao tác tạo index và upsert nào được chạy, chờ người duyệt hoặc bị từ chối.
Tổng quan kết nối
Xoay vòng key, đặt môi trường và xem mọi kết nối.