# Công cụ dữ liệu ngoài

Trước đây, [Việc Nhập Kiến Thức](knowledge-import-nhap-kien-thuc) cho phép các nhà phát triển tải trực tiếp các văn bản dài dưới nhiều định dạng khác nhau và dữ liệu có cấu trúc để xây dựng kiến thức, cho phép các ứng dụng AI trò chuyện dựa trên ngữ cảnh mới nhất được tải lên bởi người dùng. Với bản cập nhật này, công cụ dữ liệu bên ngoài giúp các nhà phát triển sử dụng khả năng tìm kiếm của riêng họ hoặc dữ liệu bên ngoài như các cơ sở kiến thức nội bộ làm ngữ cảnh cho các mô hình ngôn ngữ lớn (LLMs). Điều này được thực hiện bằng cách mở rộng API để truy xuất dữ liệu bên ngoài và nhúng nó vào các Prompt. So với việc tải kiến thức lên đám mây, sử dụng công cụ dữ liệu bên ngoài mang lại lợi ích đáng kể trong việc đảm bảo an ninh cho dữ liệu riêng tư, tùy chỉnh tìm kiếm và nhận dữ liệu thời gian thực.

## Nó hoạt động như thế nào?

Khi người dùng cuối gửi yêu cầu đến hệ thống trò chuyện, nền tảng backend sẽ kích hoạt công cụ dữ liệu bên ngoài (tức là gọi API của chính nó), truy vấn thông tin bên ngoài liên quan đến câu hỏi của người dùng, chẳng hạn như hồ sơ nhân viên, bản ghi thời gian thực, v.v. Công cụ sau đó sẽ trả về các phần liên quan đến yêu cầu hiện tại thông qua API. Nền tảng backend sẽ lắp ráp các kết quả trả về thành văn bản làm ngữ cảnh được nhúng vào Prompt, để tạo ra các phản hồi cá nhân hóa hơn và đáp ứng nhu cầu của người dùng một cách chính xác hơn.

## Bắt đầu nhanh

1. Trước khi sử dụng công cụ dữ liệu bên ngoài, bạn cần chuẩn bị một API và một API Key để xác thực. Truy cập [External\_data\_tool](extension-tien-ich/mo-rong-dua-tren-api/external_data_tool).
2. ChatX cung cấp quản lý API tập trung; Sau khi thêm cấu hình mở rộng API trong giao diện cài đặt, chúng có thể được sử dụng trực tiếp trên các ứng dụng khác nhau trên ChatX.

<figure><img src="https://content.gitbook.com/content/SK9x6AT8FGi77omZphkL/blobs/mwn5Qy0AfaLZlVV2yJfL/Capture.JPG" alt=""><figcaption><p>Tiện ích mở rộng dựa trên API</p></figcaption></figure>

3. Lấy ví dụ "Truy vấn Thời tiết", nhập tên, điểm cuối API và API Key vào hộp thoại "Thêm Phần mở rộng API mới". Sau khi lưu, chúng ta có thể gọi API.

<figure><img src="https://content.gitbook.com/content/SK9x6AT8FGi77omZphkL/blobs/mZaOrq7hhXU4g4u6gDeq/Capture.JPG" alt=""><figcaption><p>Truy vấn Thời tiết</p></figcaption></figure>

4. Trên trang sắp xếp prompt, nhấp vào nút "+ Thêm" bên phải "Tools", và trong hộp thoại "Thêm Công cụ" mở ra, điền tên và tên biến (tên biến sẽ được tham chiếu trong Prompt, vì vậy hãy sử dụng tiếng Anh), cũng như chọn mở rộng dựa trên API đã thêm ở Bước 2.

<figure><img src="https://docs.dify.ai/~gitbook/image?url=https%3A%2F%2F3866086014-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FRncMhlfeYTrpujwzDIqw%252Fuploads%252Fgit-blob-62eb07602185035e12d1e37633c6aefa12fa167c%252Fapi_based_extension1.png%3Falt%3Dmedia&#x26;width=768&#x26;dpr=4&#x26;quality=100&#x26;sign=afa364af03aa37304dba281a1c525b0f11121893c6a088a8fa554e7eac03b85e" alt=""><figcaption><p>External_data_tool</p></figcaption></figure>

5. Trong hộp sắp xếp prompt, chúng ta có thể lắp ráp dữ liệu bên ngoài đã truy vấn vào Prompt. Ví dụ, nếu chúng ta muốn truy vấn thời tiết hôm nay ở London, chúng ta có thể thêm một biến tên là location, nhập "London", và kết hợp nó với tên biến mở rộng của công cụ dữ liệu bên ngoài là `weather_data`. Đầu ra gỡ lỗi sẽ như sau:

<figure><img src="https://docs.dify.ai/~gitbook/image?url=https%3A%2F%2F3866086014-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FRncMhlfeYTrpujwzDIqw%252Fuploads%252Fgit-blob-dea5d9af7fd60ac4b7218fa0046fc5ae7aacbd8d%252FWeather_search_tool.jpeg%3Falt%3Dmedia&#x26;width=768&#x26;dpr=4&#x26;quality=100&#x26;sign=75e5ac398abf6935cbdf67ebd6d82e29f8948cfef1704993f7a027b4bd8790e9" alt=""><figcaption><p>Weather_search_tool</p></figcaption></figure>

Trong Nhật ký Prompt, chúng ta cũng có thể thấy dữ liệu thời gian thực được trả về bởi API:

<figure><img src="https://docs.dify.ai/~gitbook/image?url=https%3A%2F%2F3866086014-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FRncMhlfeYTrpujwzDIqw%252Fuploads%252Fgit-blob-290c6c06cdc35e9b8ab11a2a38ad864edc3b53ff%252Flog.jpeg%3Falt%3Dmedia&#x26;width=768&#x26;dpr=4&#x26;quality=100&#x26;sign=e698f4ce4decd205468adcfeccf9482ca479e75efb1d4f2ad20ed4b6fc368753" alt="" width="375"><figcaption><p>Nhật kí Prompt</p></figcaption></figure>
