Điều kiện tiên quyết
- Một project Langfuse Cloud hoặc tự host đang nhận trace từ ứng dụng của bạn.
- Quyền tạo API key trong project đó.
- Host Langfuse của bạn: base URL bạn dùng để đăng nhập, chẳng hạn
https://cloud.langfuse.com(EU) hoặchttps://us.cloud.langfuse.com(US), hoặc domain tự host. - Với Langfuse tự host: instance phục vụ
/api/public/mcpqua HTTPS và nhận kết nối từ internet. Nếu nằm sau firewall, hãy cho phép các egress IP của CloudThinker. Tài liệu này không công bố danh sách egress IP của CloudThinker: hãy hỏi đầu mối liên hệ tại CloudThinker, hoặc liên hệ với chúng tôi. Xem Truy cập dịch vụ nội bộ để biết các lựa chọn khác. CloudThinker từ chối host dùnghttp://thuần. - Vai trò Admin trong workspace CloudThinker, vai trò có quyền thêm và sửa kết nối. Xem Vai trò.
Thiết lập
1
Tạo cặp API key trong Langfuse
Đăng nhập Langfuse, mở project bạn muốn CloudThinker đọc, rồi vào Project → Settings → API Keys. Nhấn Create new API keys.Langfuse hiển thị một Public Key (bắt đầu bằng
pk-lf-) và một Secret Key (bắt đầu bằng sk-lf-). Sao chép cả hai ngay. Langfuse chỉ hiển thị secret key một lần.2
Mở kết nối Langfuse trong CloudThinker
Trong CloudThinker, mở More → Workspace settings → Connections, giữ nguyên tab Builtin Connections, rồi chọn Langfuse.
3
Nhập host và key
Cặp key chỉ hoạt động trên host và trong project đã cấp nó. Để đọc project thứ hai, hãy thêm kết nối Langfuse thứ hai với key của project đó.
4
Kết nối
Nhấn Connect. CloudThinker kiểm tra kết nối bằng cách mở một phiên với MCP server của Langfuse tại
/api/public/mcp.Trạng thái thành công: kết nối Langfuse hiển thị trạng thái Connected. Chạy prompt xác minh bên dưới để chắc chắn key đọc được project của bạn.Xác minh kết nối
Quyền yêu cầu
Cặp key Langfuse thuộc về một project và truy cập được trace, score, dataset và prompt của project đó. Chọn project chính là cách bạn giới hạn những gì CloudThinker nhìn thấy. Cặp key cũng có thể ghi vào project đó, ví dụ score, comment và mục trong annotation queue. CloudThinker chỉ ghi khi bạn yêu cầu một thay đổi cụ thể, và mọi thao tác ghi đều đi qua Approvals. 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.Khả năng của agent
Ví dụ prompt
Khắc phục sự cố
Kết nối tới Langfuse Cloud thất bại
Kết nối tới Langfuse Cloud thất bại
Mỗi region của Langfuse Cloud lưu dữ liệu riêng, nên cặp key chỉ hoạt động trên host đã cấp nó. Đặt LANGFUSE_HOST thành base URL bạn dùng để đăng nhập, ví dụ
https://cloud.langfuse.com cho EU hoặc https://us.cloud.langfuse.com cho US.Mọi request đều trả về 404
Mọi request đều trả về 404
LANGFUSE_HOST có path phía sau domain. Chỉ đặt base URL. Lỗi 404 trên một trace hoặc dataset cụ thể nghĩa là ID đó không tồn tại trong project này.
Langfuse tự host trả về 503 hoặc không phản hồi
Langfuse tự host trả về 503 hoặc không phản hồi
Kiểm tra instance có phục vụ
/api/public/mcp qua HTTPS không, proxy có giữ nguyên header Host công khai không, và có firewall nào chặn CloudThinker truy cập host không. Để cho phép CloudThinker, xem Truy cập dịch vụ nội bộ.Tìm kiếm không trả về kết quả
Tìm kiếm không trả về kết quả
Câu trả lời rỗng không có nghĩa kết nối bị hỏng. Mở rộng khoảng thời gian từng bước, và xác nhận project đang nhận trace từ ứng dụng của bạ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.
- Mỗi cặp key một project: cặp key truy cập được toàn bộ project, nên chỉ kết nối project mà CloudThinker cần đọc.
- Chỉ HTTPS: CloudThinker từ chối host không dùng HTTPS, nên key không bao giờ được truyền dưới dạng văn bản thuần.
Liên quan
Kết nối LangSmith
Điều tra các lượt chạy LLM và đánh giá trong LangSmith
Approvals
Kiểm soát những thao tác ghi nào của kết nối được chạy mà không cần hỏi bạn