Skip to main content
Kết nối project Langfuse của bạn để cho phép các agent CloudThinker điều tra LLM trace, gỡ lỗi hội thoại, xem xét điểm đánh giá và dataset, cũng như kiểm tra các phiên bản prompt trên toàn bộ stack quan sát của bạn. Langfuse xác thực bằng cặp API key theo phạm vi project (public key và secret key) đối chiếu với Langfuse host của bạn — cùng một cài đặt hoạt động được cho cả Langfuse Cloud và các instance tự lưu trữ.

​
Điều kiện tiên quyết

  • Một project Langfuse Cloud hoặc tự lưu trữ mà bạn muốn điều tra.
  • Một cặp API key theo phạm vi project (public key và secret key) từ project đó.
  • URL Langfuse host của bạn (https://cloud.langfuse.com cho EU, https://us.cloud.langfuse.com cho US, hoặc tên miền tự lưu trữ của bạn).
API key Langfuse được giới hạn phạm vi theo một project duy nhất. Tạo cặp key trong project mà CloudThinker cần tiếp cận, và sử dụng cặp key riêng dành cho CloudThinker để dễ kiểm tra và thu hồi.

​
Thiết lập

1

Mở Langfuse

Đăng nhập vào Langfuse và chọn project bạn muốn CloudThinker điều tra.
2

Tạo cặp API key

Vào Project → Settings → API Keys và nhấn Create new API keys. Langfuse tạo:
  • Một Public Key (có tiền tố pk-lf-)
  • Một Secret Key (có tiền tố sk-lf-)
Sao chép secret key ngay lập tức — nó chỉ hiển thị một lần và không thể lấy lại sau đó.
3

Thêm kết nối trong CloudThinker

Điều hướng đến Connections → Langfuse và nhập:
  • Host: URL cơ sở Langfuse của bạn, ví dụ https://cloud.langfuse.com (chỉ URL cơ sở, không có path)
  • Public Key: key pk-lf- vừa tạo
  • Secret Key: key sk-lf- vừa tạo
Nhấn Connect. CloudThinker xác minh thông tin xác thực và hiển thị trạng thái Connected.
Sao chép secret key ngay sau khi tạo. Langfuse chỉ hiển thị một lần, vì vậy bạn cần tạo cặp key mới nếu mất.

​
Chi tiết kết nối

​
Quyền yêu cầu

API key Langfuse kế thừa quyền truy cập của project mà chúng thuộc về. CloudThinker sử dụng cặp key cho các luồng công việc đọc và điều tra trên các trace, observation, số liệu, điểm số, dataset, hàng đợi chú thích, bình luận và prompt.
Tuân theo nguyên tắc ít quyền nhất: giới hạn phạm vi cặp key theo project duy nhất mà CloudThinker cần điều tra, và tách biệt khỏi các key dùng bởi SDK hoặc tích hợp khác để có thể xoay vòng hoặc thu hồi độc lập.

​
Khả năng của agent

Sau khi kết nối, các agent có thể điều tra dữ liệu quan sát LLM trên toàn bộ project Langfuse của bạn.
URL chat CloudThinker mang một conversationId ánh xạ đến sessionId trong Langfuse. Yêu cầu agent phân tích URL chat và nó sẽ giải quyết session qua Langfuse thay vì lấy URL dưới dạng trang web.

​
Xác minh kết nối

​
Ví dụ lệnh

Các truy vấn trace và số liệu được giới hạn theo thời gian, vì vậy hãy đề cập đến khoảng thời gian (ví dụ “một giờ qua”) để kết quả luôn tập trung.

​
Khắc phục sự cố

Xác minh public key và secret key đúng và chưa bị xoay vòng hoặc xóa. Xác nhận cả hai key thuộc cùng một project Langfuse và được sao chép không có khoảng trắng thừa.
Dữ liệu được tách biệt theo region, vì vậy cặp key chỉ hoạt động với host mà nó được tạo. Kiểm tra LANGFUSE_HOST khớp với URL bạn đăng nhập, ví dụ https://cloud.langfuse.com cho EU hoặc https://us.cloud.langfuse.com cho US.
LANGFUSE_HOST có hậu tố path thừa. Đặt thành URL cơ sở, không có đường dẫn thừa.
Tìm kiếm trace và số liệu cần khoảng thời gian. Yêu cầu agent dùng cửa sổ gần đây (ví dụ một giờ qua) và mở rộng chỉ khi cần. Xác nhận project đang nhận trace tích cực từ ứng dụng của bạn.
Yêu cầu agent trích xuất conversationId và ánh xạ nó đến sessionId trong Langfuse thay vì lấy URL trực tiếp.

​
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.
  • Cặp key theo phạm vi project — sử dụng cặp key giới hạn theo project duy nhất mà CloudThinker điều tra; tạo cặp riêng cho CloudThinker để dễ kiểm tra và thu hồi độc lập.
  • Host đúng — khớp host với region nơi project tồn tại để tránh lỗi cross-region.

​
Liên quan

Kết nối SigNoz

Log, số liệu, trace và dashboard

Kết nối Datadog

Tìm kiếm log, số liệu và giám sát