İçeriğe geç
ajan.io

Belgeler menüsü

Bu sayfada

Dosya arama

Organizasyon bilgisini iş akışlarına katmak için Bilgi merkezlerinde arama yapın ve bilgi alın.

Genel bakış

Dosya arama düğümü, ilgili bilgi ve bağlamı almak için Bilgi merkezlerini sorgular. İş akışınızı organizasyonunuzun bilgi merkezine bağlayın ve yüklenen belgelerde arama yaparak yapay zeka yanıtlarını zenginleştirin, bilgiyi doğrulayın veya kararlar için bağlam sağlayın.

En uygun olduğu durum: Bilgi erişimi, belge arama, bağlam zenginleştirme, RAG (Retrieval Augmented Generation) ve organizasyon bilgisine erişim.

Dosya aramayı ne zaman kullanmalı?

İdeal olduğu durumlar:

  • Şirket belgelerinde ve bilgi merkezlerinde arama
  • Yapay zeka ajan yanıtları için ilgili bağlam alma
  • Birden fazla belgede belirli bilgi bulma
  • RAG (Retrieval Augmented Generation) kalıplarını uygulama
  • Bilgiyi iç bilgiye karşı doğrulama
  • İş akışlarını organizasyon verisiyle zenginleştirme

İdeal olmadığı durumlar:

  • Gerçek zamanlı web araması (Web araması düğümünü kullanın)
  • Harici API’lerden veri getirme (HTTP isteği düğümünü kullanın)
  • Tekil dosyaları işleme (doğrudan dosya ekleri kullanın)

Yapılandırma

Bilgi merkezi

Çalışma alanınızın kullanılabilir Bilgi merkezlerinden arama yapılacak Bilgi merkezini seçin.

Seçenekler:

  • Bağlı Bilgi merkezlerinden seçin
  • Her Bilgi merkezi yüklenen belgeler içerir
  • Bilgi merkezleri PDF, Word, Markdown ve sunumlar gibi desteklenen metin tabanlı biçimleri kabul eder. Tablo dosyaları, görüntüler, ses veya video kabul etmez.

Arama sorgusu

İlgili bilgiyi bulmak için arama sorgusu. Manuel, Otomatik ve Prompt AI modlarını destekler.

Manuel mod örnekleri:

handlebars
{{trigger.output.customer_question}}
handlebars
Find information about {{trigger.output.product_name}} pricing and features

İstem modu:

text
Generate a search query to find relevant information about the customer's question: {{trigger.output.question}}

Maks. sonuç

Döndürülecek maksimum ilgili sonuç sayısı (varsayılan: 10)

Öneriler:

  • 1-3 sonuç: Odaklı, spesifik sorgular
  • 5-10 sonuç: Daha geniş bağlam gerektiğinde
  • 10+ sonuç: Kapsamlı aramalar (performansı etkileyebilir)

Nasıl çalışır?

  1. Sorgu seçilen Bilgi merkezine karşı işlenir
  2. Anlamsal arama en ilgili belge parçalarını bulur
  3. Sonuçlar ilgililiğe göre sıralanır
  4. Maks. sonuç ayarına göre ilk N sonuç döndürülür
  5. Alınan bilgi sonraki düğümler için kullanılabilir

Örnek kullanım senaryoları

Bilgi merkeziyle müşteri desteği

text
Form Trigger (Customer question)
→ File Search: Query Knowledge base with {{trigger.output.question}}
  Knowledge base: "Support Documentation"
  Max Results: 5
→ Agent: Answer question using search results
  Context: {{file_search.output.results}}
  Question: {{trigger.output.question}}
→ Notification: Send answer to customer

Ürün bilgisi arama

text
Integration Trigger (Slack question about product)
→ File Search: Search product knowledge
  Knowledge base: "Product Information"
  Query: {{trigger.output.message}}
  Max Results: 3
→ Agent: Summarize relevant product details
→ Action: Reply in Slack thread

Belge doğrulama

text
Form Trigger (User claim submission)
→ File Search: Find relevant policies
  Knowledge base: "Company Policies"
  Query: "{{trigger.output.claim_type}} policy requirements"
  Max Results: 5
→ Agent: Validate claim against policies
  Policies: {{file_search.output.results}}
  Claim: {{trigger.output.claim_details}}
→ Condition: Approved or requires review?

Arama sonuçlarına erişme

Alınan bilgilere sonraki düğümlerde erişin:

handlebars
{{file_search.output.results}}
{{file_search.output.results[0].text}}
{{file_search.output.results[0].fileName}}

Sonuç yapısı

Her sonuç şunları içerir:

  • text: Belgeden ilgili metin parçası
  • fileName: Kaynak dosyanın adı
  • fileUrl: Kaynak dosyaya erişim URL’si
  • mimeType: Kaynak dosyanın MIME türü
  • subsource: Ek kaynak referansı
  • subname: Ek ad referansı
  • fileId: Kaynak dosya için benzersiz tanımlayıcı
  • externalId: Bağlı kaynak sistemden harici referans kimliği
  • fileSize: Dosya boyutu (bayt)
  • connectionId: Dosyayı sağlayan entegrasyon bağlantısının kimliği
  • syncParams: Kaynak entegrasyondan senkron parametreleri
  • pageCount: Dosyadaki sayfa sayısı

Ajan istemlerinde kullanma:

handlebars
Context from knowledge base:
{{file_search.output.results}}

Based on the above context, answer this question:
{{trigger.output.question}}

Sınırlamalar

  • Bilgi merkezi kapsamı: Yalnızca seçilen Bilgi merkezi içinde arar
  • Sonuç kalitesi: Yüklenen belgelerin kalitesine ve eksiksizliğine bağlıdır
  • Parça boyutu: Büyük belgeler parçalara bölünür; ilgili bilgi birden fazla sonuca yayılabilir
  • Gerçek zamanlı güncellemeler: Belge değişikliklerinin arama sonuçlarında görünmesi için yeniden işlenmesi gerekir

Önemli: Doğru arama sonuçları için Bilgi merkezlerinizin güncel bilgiyle düzenli güncellendiğinden emin olun.

En iyi uygulamalar

Daha spesifik sorgular daha ilgili sonuçlar döndürür. Genel aramalar yerine anahtar terimler, ürün adları veya konular ekleyin.

5 sonuçla başlayın ve yanıt kalitesine göre ayarlayın. Çok az önemli bağlamı kaçırabilir; çok fazla ilgililiği seyreltebilir.

Daha hedefli aramalar için Bilgi merkezlerini konu veya alana göre düzenleyin. Teknik belgeleri pazarlama içeriğinden ayırın.

Dosya arama, Ajan düğümleriyle birleştirildiğinde en güçlüdür. Ajan alınan bilgiyi sentezleyip yorumlayabilir.

Bilgi merkezi içeriğinin yeterli olduğundan ve sorguların ilgili sonuçlar döndürdüğünden emin olmak için dosya aramanızı kullanıcıların sorabileceği gerçek sorularla test edin.

İlgili sonuç bulunamayan durumları ele almak için dosya aramasından sonra bir koşul ekleyin. Yedek yanıtlar veya yükseltme yolları sağlayın.

Sonraki adımlar