Azure AI Search adalah alat agen bawaan yang memungkinkan agen untuk melakukan kueri pada indeks Azure AI Search Anda dan menggunakan dokumen yang dikembalikan dalam jawabannya.

Konfigurasi

Diperlukan

Untuk memulai, Anda memerlukan URL endpoint Azure AI Search, nama indeks, dan kunci API. Tentukan variabel tersebut di dalam file .env Anda:

AZURE_AI_SEARCH_SERVICE_ENDPOINT="..."
AZURE_AI_SEARCH_INDEX_NAME="..."
AZURE_AI_SEARCH_API_KEY="..."

AZURE_AI_SEARCH_SERVICE_ENDPOINT

Ini adalah URL dari endpoint pencarian. URL ini bisa didapatkan dari halaman utama layanan pencarian di konsol manajemen Cognitive Search (contoh: https://example.search.windows.net).

AZURE_AI_SEARCH_INDEX_NAME

Ini adalah nama indeks yang akan dicari (contohnya, hotels-sample-index).

AZURE_AI_SEARCH_API_KEY

Ini adalah kunci autentikasi yang digunakan saat memanfaatkan endpoint pencarian. Harap terbitkan kunci tersebut dari konsol manajemen. Gunakan Nilai (Value), bukan nama kunci autentikasi tersebut.

Pengantar tutorial

Buat atau masuk ke akun Anda di Azure Portal

1. Kunjungi https://azure.microsoft.com/en-us/ dan klik Get started atau Try Azure for Free untuk membuat akun dan masuk.

2. Pilih bayar per penggunaan atau Azure Free dengan $200.

Membuat layanan Azure AI Search

1. Akses panel kontrol Anda.

2. Klik pada Create a resource.

3. Cari Azure Search di bilah pencarian lalu tekan enter.

4. Sekarang, klik pada Create.

5. Konfigurasikan pengaturan dasar, buat Resource Group baru atau pilih yang sudah ada, beri nama Service Name sesuai preferensi Anda, lalu pilih lokasi.

6. Klik pada Change Pricing Tier.

Sekarang pilih opsi gratis atau pilih opsi yang Anda inginkan (mungkin dikenakan biaya).

7. Klik pada Review + create dan tunggu hingga sumber daya selesai dibuat.

Buat indeks Anda

1. Klik pada Import data.

2. Ikuti tutorial Microsoft: https://learn.microsoft.com/en-us/azure/search/search-get-started-portal, setelah selesai, simpan nama yang diberikan ke indeks di suatu tempat.

3. Sekarang Anda memiliki AZURE_AI_SEARCH_INDEX_NAME Anda, salin dan simpan di tempat yang aman secara lokal.

Dapatkan Endpoint

1. Pada Url: Anda memiliki AZURE_AI_SEARCH_SERVICE_ENDPOINT Anda, salin dan simpan di tempat yang aman secara lokal.

2. Pada panel sebelah kiri, klik keys.

3. Klik pada Add dan masukkan nama untuk kunci Anda.

4. Salin kunci tersebut untuk mendapatkan AZURE_AI_SEARCH_API_KEY.

Menambahkan Tool ke Agent

Setelah menambahkan variabel lingkungan, mulai ulang LibreChat dan tambahkan Azure AI Search ke agen.

Di LibreChat, pilih Agents, buat atau edit agen, buka daftar Tools agen tersebut, pilih Azure AI Search, lalu simpan agen tersebut.

Uji Coba

Ajukan pertanyaan kepada agen yang seharusnya dijawab oleh indeks Azure AI Search Anda. Jika alat tersebut mengembalikan terlalu banyak konten, sesuaikan AZURE_AI_SEARCH_SEARCH_OPTION_TOP dan AZURE_AI_SEARCH_SEARCH_OPTION_SELECT.

Opsional

Berikut adalah nilai konfigurasi yang tidak wajib tetapi dapat ditentukan sebagai parameter selama pencarian.

Jika ada kekhawatiran bahwa data hasil pencarian mungkin terlalu besar dan melebihi ukuran prompt, pertimbangkan untuk mengurangi ukuran data hasil pencarian dengan menggunakan AZURE_AI_SEARCH_SEARCH_OPTION_TOP dan AZURE_AI_SEARCH_SEARCH_OPTION_SELECT.

Untuk detail mengenai setiap parameter, silakan merujuk pada dokumen berikut: https://learn.microsoft.com/en-us/rest/api/searchservice/search-documents

AZURE_AI_SEARCH_API_VERSION=2023-10-01-Preview
AZURE_AI_SEARCH_SEARCH_OPTION_QUERY_TYPE=simple
AZURE_AI_SEARCH_SEARCH_OPTION_TOP=3
AZURE_AI_SEARCH_SEARCH_OPTION_SELECT=field1, field2, field3

AZURE_AI_SEARCH_API_VERSION

Tentukan versi API pencarian. Saat menggunakan fitur baru seperti pencarian semantik atau pencarian vektor, Anda mungkin perlu menentukan versi pratinjau. Nilai defaultnya adalah 2023-11-1.

AZURE_AI_SEARCH_SEARCH_OPTION_QUERY_TYPE

Tentukan simple atau full. Nilai default-nya adalah simple.

AZURE_AI_SEARCH_SEARCH_OPTION_TOP

Tentukan jumlah item yang akan dicari. Nilai defaultnya adalah 5.

AZURE_AI_SEARCH_SEARCH_OPTION_SELECT

Tentukan kolom indeks yang akan diambil, dipisahkan dengan koma. Harap dicatat bahwa ini bukanlah kolom yang akan dicari.