Azure AI Arama
Dizine eklenmiş belgeleriniz üzerinde anlamsal vektör aramaları yapmak için Azure AI Search'ü ajan'a bağlayın
Genel Bakış
Azure AI Search, Microsoft'un yapay zeka destekli bilgi alma platformudur. Bağlandıktan sonra, indekslenmiş belgeleriniz üzerinde doğrudan ajan konuşmalarından anlamsal vektör aramaları gerçekleştirebilirsiniz.
Kimlik Doğrulama: API Anahtarı Kategori: Vektör Veritabanı Kullanılabilirlik: Tüm çalışma alanı planları
Önkoşullar
Entegrasyonu ayarlamadan önce aşağıdakilere sahip olduğunuzdan emin olun:
- Azure AI Arama erişimine sahip bir Azure aboneliği
- En az bir dizine sahip bir Azure AI Arama hizmeti örneği
- Azure AI Arama hizmetiniz için bir yönetici API anahtarı
- Dizininize vektör yerleştirmeleri ile yüklenen belgeler
Azure AI Arama'da yeniyseniz vektör arama desteğiyle ilk dizininizi ayarlamak için Microsoft'un Vector Search documentation belgesine bakın.
Kurulum
Navigate to Integrations
Ajanda, Integrations'e gidin ve entegrasyon listesinde Azure AI Search'ü bulun.
Kimlik bilgilerinizi girin
Gerekli konfigürasyon alanlarını doldurun (bkz. table below).
Bağlantıyı test edin
Entegrasyonu kaydedin — ajan, dizininizin mevcut ve erişilebilir olduğunu doğrulayacaktır.
Aramaya başla
Herhangi bir aracıda entegrasyonu @ ile etiketleyin veya indekslenmiş belgelerinizi aramak için aracınıza Belgeleri ara eylemini ekleyin.
Configuration Parameters
Zorunlu Alanlar
| Alan | Açıklama | Example |
|---|---|---|
| Ad | Bu bağlantı için bir ad | Company Knowledge Base |
| API Anahtarı | Azure Portal → Ayarlar → Anahtarlar → Birincil yönetici anahtarı oluşturun | Yönetici anahtarınız |
| Dizin Adı | Azure AI Arama dizininizin tam adı | ajan-prod-company |
| URL | Azure AI Arama hizmeti uç noktanız | https://my-service.search.windows.net |
| Arama Alanı | Dizin şemanızdaki vektör alanı adı | contentVector |
| En İyi K | Alınacak arama sonucu sayısı | 5 |
İsteğe Bağlı Alanlar
| Alan | Description | Varsayılan |
|---|---|---|
| Yerleştirme Modeli | Model used for embeddings (display only) | Ada v2 |
| Seç | Comma-separated fields to return | Tüm alanlar |
| Filtre | Sonuçları daraltmak için OData filtre ifadesi | Yok |
Kimlik bilgilerinizi nerede bulabilirsiniz: * Hizmet URL'si: Bkz. Manage your Azure AI Search service — uç noktanız Genel Bakış sayfasında listelenir * API Anahtarı: Bkz. Connect using API keys — Azure Portal → Ayarlar → Anahtarlar → birincil yönetici anahtarı oluşturun
Yaygın Kullanım Durumları
- Kurumsal Bilgi Arama — Doğal dili kullanarak şirket içi belgelerde, politikalarda ve bilgi tabanlarında arama yapın
- Araştırma ve Analiz — Büyük belge koleksiyonlarından ilgili araştırma makalelerini, raporları ve verileri bulun
- Müşteri Desteği — Müşteri sorularını yanıtlamak için ürün bilgilerini, SSS'leri ve destek makalelerini hızla alın
- İçerik Keşfi — Arşivlerden, wiki'lerden veya belge havuzlarından ilgili içeriği ortaya çıkarın
Sorun Giderme
| Sayı | Sebep | Çözüm |
|---|---|---|
| Index not found | Dizin adı eşleşmiyor veya mevcut değil | Azure Portal'daki dizin adının tam olarak yapılandırmanızla eşleştiğini doğrulayın (büyük/küçük harfe duyarlı) |
| No search results | Vektör alanı adı yanlış veya filtre çıkışı engelliyor | Vektör alanı adının dizin şemanızla eşleştiğini doğrulayın ve herhangi bir OData filtre ifadesinin tüm sonuçları hariç tutmadığını kontrol edin |
| Low search scores | Gömme modeli uyuşmazlığı | Tüm belgelerin aynı gömme modelini kullandığından emin olun (ör. text-embedding-ada-002) |
| Kimlik doğrulama başarısız oldu | Geçersiz veya süresi dolmuş API anahtarı | Azure Portal'dan yeni bir yönetici anahtarı kopyalayın → Anahtarlar |
Doğrulama kontrol listesi * Hizmet URL biçimi:
https://[service-name].search.windows.net* Dizin adı tam olarak eşleşir (büyük/küçük harfe duyarlı) * Arama alanı vektör alanı adınızla eşleşir (ör.contentVector) * Belgeler vektör eklemeleri içerir