> ## Documentation Index > Fetch the complete documentation index at: https://docs.cloudthinker.io/llms.txt > Use this file to discover all available pages before exploring further. # LangSmith > Kết nối LangSmith để CloudThinker tìm các lượt chạy LLM lỗi hoặc tốn kém, kiểm tra trace và rà soát kết quả dataset và experiment. Kết nối một workspace LangSmith và hỏi [CloudThinker](https://docs.cloudthinker.io/vi/guide/agents/overview.md) vì sao một lượt chạy LLM thất bại, lượt chạy nào tốn kém nhất hôm qua, hoặc hai experiment so sánh thế nào về độ trễ, chi phí và feedback. Bạn cần ba giá trị: một API key, một workspace ID và API URL của region bạn. ## Điều kiện tiên quyết * Tài khoản LangSmith có quyền truy cập workspace mà bạn muốn CloudThinker đọc. * Quyền tạo API key trong LangSmith. Chỉ admin của organization mới tạo được service key. * Vai trò **Admin** trong workspace CloudThinker, cần để thêm và sửa kết nối. Xem [Vai trò](https://docs.cloudthinker.io/vi/guide/security/roles.md). ## Thiết lập **1. Tạo API key** Trong LangSmith, mở **Settings → API Keys**. Chọn loại key theo [Quyền yêu cầu](#quyền-yêu-cầu). Với service key giới hạn trong workspace, hãy chọn workspace. Đặt thời hạn, rồi nhấn **Create API Key**. **2. Sao chép key** Sao chép key ngay. LangSmith chỉ hiển thị key một lần. **3. Sao chép workspace ID** Nếu bạn thuộc nhiều workspace, hãy chuyển sang workspace mà CloudThinker cần đọc trước. Sau đó, trên trang **Settings**, sao chép **Workspace ID** trong **General**. **4. Thêm kết nối trong CloudThinker** Mở **More → Workspace settings → Connections**, ở lại tab **Builtin Connections** và chọn **LangSmith**. Điền cả ba trường trong [Chi tiết kết nối](#chi-tiết-kết-nối), bao gồm API URL của region bạn, rồi nhấn **Connect**. **Trạng thái thành công:** thẻ LangSmith hiển thị **Connected**. > [!WARNING] > > **Connected** chỉ có nghĩa là CloudThinker đã lưu kết nối. Key, workspace ID hoặc URL sai chỉ lộ ra khi CloudThinker đọc LangSmith lần đầu, vì vậy hãy chạy [prompt xác minh](#xác-minh-kết-nối) trước khi dựa vào kết nối. ## Chi tiết kết nối | Trường | Bắt buộc | Mô tả | Ví dụ | | - | - | - | - | | **LANGSMITH\_API\_KEY** | Có | Personal access token hoặc service key từ **Settings → API Keys** | `` | | **LANGSMITH\_WORKSPACE\_ID** | Có | Workspace ID từ **Settings → General** | `` | | **LANGSMITH\_ENDPOINT** | Có | API URL của region bạn, theo bảng bên dưới | `https://api.smith.langchain.com` | Cả ba trường đều bắt buộc. LangSmith cần workspace ID khi một key bao gồm nhiều workspace, và điều này không gây hại gì với key chỉ có một workspace. | Region | API URL | | - | - | | GCP US (mặc định) | `https://api.smith.langchain.com` | | GCP EU | `https://eu.api.smith.langchain.com` | | GCP APAC | `https://apac.api.smith.langchain.com` | | AWS US | `https://aws.api.smith.langchain.com` | Với LangSmith tự host, hãy dùng API URL của triển khai đó. URL phải chấp nhận kết nối từ internet; nếu nằm sau tường lửa, xem [Truy cập dịch vụ private](https://docs.cloudthinker.io/vi/guide/connections/overview.md#truy-cập-dịch-vụ-nội-bộ). ## Quyền yêu cầu | Loại key | Hoạt động dưới danh nghĩa | Dùng khi | | - | - | - | | **Personal access token** | Người dùng đã tạo key, với toàn bộ quyền truy cập của người đó | Bạn đang tự thử nghiệm | | **Service key, giới hạn workspace** | Chỉ các workspace bạn chọn | Khuyến nghị cho workspace CloudThinker dùng chung | | **Service key, giới hạn organization** | Mọi workspace trong organization | Tránh dùng trừ khi CloudThinker cần mọi workspace | > [!TIP] > > Tạo một service key giới hạn trong workspace cho đúng workspace mà CloudThinker cần đọc. Trên LangSmith Enterprise, cấp cho key vai trò **Workspace Viewer** để có quyền chỉ đọc. Nếu không có vai trò chỉ đọc, key có thể ghi, và chỉ cài đặt Approvals của bạn quyết định một thao tác ghi có chạy mà không hỏi bạn hay không. ## Khả năng của agent | Khả năng | Bạn nhận được gì | | - | - | | **Project và lượt chạy** | Các lượt chạy lỗi, chậm hoặc tốn kém trong một project cụ thể, xếp hạng theo lỗi, độ trễ hoặc chi phí | | **Trace và thread** | Một trace, hoặc lịch sử tin nhắn của một thread hội thoại | | **Dataset và example** | Các dataset của bạn và các example bên trong một dataset | | **Experiment** | Kết quả experiment cho một dataset, bao gồm độ trễ, chi phí và feedback | | **Prompt** | Các prompt của bạn và template của một prompt | CloudThinker tóm tắt những gì tìm thấy. CloudThinker không in toàn bộ input, output hay nội dung tin nhắn của lượt chạy, và không đọc dữ liệu thanh toán hay mức sử dụng LangSmith qua kết nối này. ### Xác minh kết nối ```text theme={null} List my LangSmith projects and datasets ``` **Trạng thái thành công:** bạn nhận được tên project và dataset khớp với workspace của bạn trong LangSmith. Danh sách trống mà không có lỗi vẫn là kết nối hoạt động: workspace có thể chỉ đơn giản là chưa có dữ liệu. ### Ví dụ prompt Nêu chính xác tên project hoặc dataset. Xếp hạng lượt chạy cần tên project, còn experiment và example cần tên dataset. ```text theme={null} Show the five most expensive runs in the support-bot project from the last day and what drove their cost Find failed runs in the support-bot project and group them by error Compare the latest experiments on the support-eval dataset by latency, cost, and feedback ``` ## Quyền ghi CloudThinker mặc định chỉ đọc. CloudThinker chỉ ghi khi bạn yêu cầu chính xác thay đổi đó theo tên trong cuộc hội thoại: push một prompt, tạo hoặc cập nhật một dataset hay các example của nó, hoặc bắt đầu một experiment. Mọi thay đổi do agent thực hiện đều đi qua [Approvals](https://docs.cloudthinker.io/vi/guide/approvals/overview.md) 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](https://docs.cloudthinker.io/vi/guide/approvals/rules.md#khắc-phục-sự-cố) cho workspace của bạn. Chọn **Manual** nếu bạn muốn tự phê duyệt mọi thay đổi. Để loại trừ hoàn toàn thao tác ghi, hãy dùng key có vai trò chỉ đọc (xem [Quyền yêu cầu](#quyền-yêu-cầu)). ## Khắc phục sự cố > **401 Unauthorized** > > Key bị thiếu, gõ sai, đã hết hạn hoặc bị xóa. Key LangSmith đã hết hạn không thể kích hoạt lại. Tạo key mới, rồi mở **More → Workspace settings → Connections**, chọn **LangSmith** và thay **LANGSMITH\_API\_KEY**. > **403 Forbidden** > > Key không đọc được workspace đó. Key giới hạn organization cần **LANGSMITH\_WORKSPACE\_ID** đúng, và key giới hạn workspace chỉ hoạt động với các workspace bạn đã chọn. Kiểm tra cả hai, cùng với vai trò của key. > **Request thất bại hoặc danh sách trả về trống, dù key đúng** > > **LANGSMITH\_ENDPOINT** có thể không khớp với region của workspace. Đặt endpoint thành URL của region bạn trong [Chi tiết kết nối](#chi-tiết-kết-nối). > **404, hoặc không tìm thấy project hay dataset** > > Tên đó không tồn tại trong workspace này. Hãy yêu cầu CloudThinker liệt kê project hoặc dataset trước, rồi dùng tên chính xác. > **429 Too Many Requests** > > LangSmith giới hạn số request mỗi phút của một key. Chờ một phút, rồi đặt câu hỏi hẹp hơn, ví dụ một project và khoảng thời gian ngắn hơ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. - **Key giới hạn workspace**: giới hạn key trong một workspace để các workspace khác nằm ngoài tầm truy cập. - **Thời hạn**: đặt thời hạn cho key và thay key trước khi hết hạn. ## Liên quan > **[Langfuse](https://docs.cloudthinker.io/vi/guide/connections/langfuse.md)** > > Thêm trace LLM và prompt từ Langfuse > **[Lệnh và cú pháp prompt](https://docs.cloudthinker.io/vi/guide/commands.md)** > > Hướng câu hỏi đến một kết nối bằng # This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.