Chuyển đến nội dung chính
Kết nối tổ chức Braintrust của bạn và hỏi CloudThinker một experiment đạt điểm thế nào so với baseline, một monitor view đã lưu hiển thị gì, hoặc một project được cấu hình ra sao. Kết nối dùng một API key Braintrust và chỉ đọc: CloudThinker có thể xem, không bao giờ thay đổi.

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

  • Tổ chức Braintrust trên data plane US của Braintrust. CloudThinker luôn kết nối tới api.braintrust.dev, nên data plane EU và các bản triển khai Braintrust tự host không được hỗ trợ.
  • Quyền tạo API key trong tổ chức đó.
  • Vai trò Admin trong workspace CloudThinker, cần để thêm kết nối. Xem Vai trò.
API key của Braintrust mang quyền của người dùng đã tạo nó và không thể giới hạn thấp hơn người dùng đó, nên hãy tạo key từ một tài khoản chỉ cần đọc. Nếu gói Braintrust của bạn có permission group, hãy đưa tài khoản đó vào nhóm Viewers, nhóm này cấp quyền đọc các project của tổ chức. Key do owner tạo vẫn hoạt động, nhưng mang quyền owner.

​
Thiết lập

1

Mở API keys trong Braintrust

Đăng nhập Braintrust bằng tài khoản chỉ đọc bạn đã chọn ở trên và vào Settings → API keys.
2

Tạo key

Nhấn + API key, đặt tên cloudthinker và chọn thời hạn. Thời hạn không thể đổi sau, nên hãy đặt lời nhắc trên lịch để xoay vòng key trước ngày đó (xem Bảo mật). Nhấn Create.
3

Sao chép key

Sao chép key ngay. Braintrust chỉ hiển thị key một lần. Nếu mất key, hãy tạo key mới.
4

Thêm kết nối trong CloudThinker

Mở More → Workspace settings → Connections, giữ nguyên tab Builtin Connections và chọn Braintrust. Dán key vào BRAINTRUST_API_KEY rồi nhấn Connect.Trạng thái thành công: thẻ Braintrust hiển thị Connected.

​
Chi tiết kết nối

Không cần nhập data plane hay URL: CloudThinker luôn gọi api.braintrust.dev.

​
Quyền yêu cầu

Phạm vi của key chính là phạm vi của người tạo. Braintrust không thể giới hạn key thấp hơn tài khoản đã tạo nó, nên tài khoản bạn chọn chính là ranh giới quyền.
Tạo key từ một tài khoản có quyền đọc các project mà CloudThinker cần thấy, và không hơn. Ngay cả với key có quyền rộng hơn, CloudThinker cũng chỉ chạy sáu thao tác đọc bên dưới.

​
Khả năng của agent

CloudThinker chỉ cho phép đúng sáu thao tác Braintrust trên kết nối này. Mọi thứ khác Braintrust cung cấp đều bị chặn. CloudThinker báo cáo tên và số lượng. CloudThinker chỉ hiển thị ID đối tượng khi bạn yêu cầu.
CloudThinker không thể chạy SQL trên log của bạn, liệt kê automation, duyệt tất cả monitor view, hoặc tạo, chỉnh sửa hay chạy bất cứ thứ gì trong Braintrust. Hãy làm những việc đó trực tiếp trong Braintrust.

​
Xác minh kết nối

Trạng thái thành công: bạn nhận được danh sách ngắn tên project khớp với những gì bạn thấy trong Braintrust. Lỗi 401 nghĩa là key sai hoặc đã hết hạn; xem Khắc phục sự cố.

​
Ví dụ prompt

Dùng tên chính xác từ Braintrust. CloudThinker tra cứu đúng đối tượng bạn nêu tên, không đoán.

​
Khắc phục sự cố

Braintrust không chấp nhận key. Key có thể bị gõ sai, đã bị xóa hoặc đã hết hạn. Tạo key mới, rồi mở More → Workspace settings → Connections, chọn Braintrust và thay giá trị.
Key chỉ thấy những gì tài khoản của người tạo thấy. Kiểm tra quyền truy cập của tài khoản đó vào project hoặc experiment trong Braintrust, và kiểm tra tên chính xác bạn đã dùng.
Key đã hết hạn. Key Braintrust không thể gia hạn, nên hãy tạo key mới và cập nhật kết nối. Đặt lời nhắc trên lịch trước lần hết hạn tiếp theo.
Kết nối này chỉ giao tiếp với api.braintrust.dev. Kết nối không thể truy cập data plane EU hoặc các bản triển khai tự host.
Đó là thiết kế có chủ đích. Kết nối chỉ cho phép sáu thao tác đọc được liệt kê trong Khả năng của agent.

​
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ạm vi tài khoản: key hoạt động với tư cách người tạo, nên hãy tạo key từ tài khoản chỉ có quyền đọc.
  • Thời hạn: chọn thời hạn bạn sẽ theo dõi, và xoay vòng key trước khi hết hạn.

​
Liên quan

Langfuse

Thêm trace và prompt LLM từ Langfuse

LangSmith

Thêm run, dataset và experiment LLM từ LangSmith

Lệnh và cú pháp prompt

Hướng câu hỏi tới một kết nối bằng #