Bilgi / RAG

AIHUMMER_QDRANT_URL=http://localhost:6333
AIHUMMER_EMBEDDER_URL=http://localhost:8081

**Bilgi** AiHummer'ın cevapları modelin eğitim verilerinden ziyade belgelerinizde nasıl temellendirdiğidir. İçeriği alırsınız, ajan ilgili pasajları getirir. `search_knowledge` araç ve cevaplar geri gelir **alıntılarla**. Daha zor sorular için, `deep_research` araç çok adımlı bir araştırma yürütür ve kaynak gösterilen bir rapor üretir. Bilgi yönetimi altında yürütülür `/v1/admin/knowledge/*` ve `/v1/admin/knowledge/connectors/*`. ## İçerik tüketmek Alabilirsiniz **Belgeler, PDF'ler ve URL'ler** bilgi tabanına. Alınan içerik, cevap zamanı geri çağrılabilmesi ve kaynağına atıfta bulunulabilmesi için indekslenir. > [!TIP] > Bir belgenin kanonik sürümünü bir kez alın ve ajanların onu atıfta bulunmasına izin verin, bunun yerine > uzun pasajları istemlere yapıştırmaktan daha iyidir. Alıntılanmış geri getirme, cevapları korur > doğrulanabilir ve bağlamınız küçük. ## Temellendirilmiş cevaplar ve araçlar İki araç, bilgi tabanını bir ajana açar: | Araç | Ne yapar | |---|---| | `search_knowledge` | İlgili pasajları alır ve yanıtı alıntılarla destekler. | | `deep_research` | Bilgi tabanı genelinde çok aşamalı bir araştırma süreci yürütür ve kaynak gösterilmiş bir rapor hazırlar. | İkisi de dönüşte gelir **araç sonuçları**, hiçbir zaman enjekte edilmiş talimatlar olarak — AiHummer'da her yerde uygulanan aynı istem enjeksiyonu disiplini. Cevaplar taşır **alıntılar** böylece bir okuyucu bir iddiayı kaynağına kadar izleyebilir. > [!NOTE] > `deep_research` gerçek çok adımlı sorular için — daha fazla zaman alır ve > tek birden daha fazla jeton `search_knowledge` çağrı. Bir alım olduğunda ona uzan > yeterli değil. ## Bilgi bağlayıcıları Manuel veri almanın ötesinde, bilgi, altında yönetilen bağlayıcılar aracılığıyla harici kaynaklardan çekilebilir `/v1/admin/knowledge/connectors/*`. Yedi bağlayıcı mevcuttur; her birinin kimlik bilgileri şifrelenmiş gizli bilgiler kasasında saklanır ve arka planda bir zamanlayıcı senkronizasyonları çalıştırır: | Bağlayıcı | Ne çekiyor | |---|---| | **Google Drive** (`gdrive`) | Bir servis hesabı (kimlik doğrulama JSON'u) aracılığıyla Google Drive dosyaları. | | **Microsoft Graph** (`msgraph`) | Microsoft Graph uygulaması üzerinden SharePoint / OneDrive belgeleri. | | **Notion** (`notion`) | Notion sayfaları dahili bir entegrasyon belirteci aracılığıyla. | | **Slack** (`slack`) | Web API belirteci aracılığıyla Slack kanal mesaj geçmişi (tüm kanallar veya yapılandırılmış bir liste). | | **S3** (`s3`) | Bir S3 uyumlu kovadan (AWS S3, S3 modundaki GCS, MinIO vb.) gelen nesneler, isteğe bağlı olarak bir önek altında. | | **SQL** (`db`) | Belgelere olarak alınan bir veritabanına karşı read-only SQL sorgusunun satırları. | | **Kavşak** (`confluence`) | Confluence Cloud sayfaları (Atlassian API belirteci ile Temel kimlik doğrulama), isteğe bağlı olarak tek bir alanla sınırlandırılabilir. | Ayrı olarak, tek seferlik **Slack dışa aktarımı** import, elle yüklenen bir workspace-export ZIP dosyasını alır — saklanan bir gizli anahtar ve zamanlama yoktur. > [!WARNING] > Google Drive bağlantısı canlı olarak kanıtlanmıştır; diğerleri uygulanmıştır ve > testlerle kapsanmıştır, ancak onlara güvenmeden önce kendi verilerinizle doğrulayın > üretimde. ## Vektör deposu ve gömme Varsayılan olarak, alma bir üzerinde çalışabilir **hash yerleştirici ile bellek içi depo**, bu başlamak için yeterlidir. Üretim kalitesinde semantik alıntı için AiHummer'ı bir **gerçek vektör deposu ve gömmeleyici**: ```bash AIHUMMER_QDRANT_URL=http://localhost:6333 AIHUMMER_EMBEDDER_URL=http://localhost:8081 ``` Bunlar ayarlandığında, alım ve `search_knowledge` Bellekteki yedek yerine harici vektör deposunu ve gömmeleyiciyi kullanın. > [!NOTE] > Semantik gömme aracı **varsayılan değil, katılmak isteyen**: ev sahibi-yerel kurucu > sadece geçtiğinizde hükümler `--with-embedder` (Ollama hafif bir şekilde > çok dilli model; sonra işaret eder `AIHUMMER_EMBEDDER_URL` de/da > `http://127.0.0.1:11434/api/embeddings`). Bir yerleştirici olmadan, getirme çalışmaları > sözcüksel geri dönüşte. ## Yönetici API | Kaynak | Amaç | |---|---| | `/v1/admin/knowledge` | Bilgi tabanı yönetimi, alım dahil | | `/v1/admin/knowledge/connectors` | KB bağlayıcılarını yapılandırın (Drive, Graph, Notion, Slack, S3, SQL, Confluence) | ## Sonra nereye? - Gör `search_knowledge` ve `deep_research` her diğer araçla birlikte [Araçlar](/tr/v1.0/concepts/tools) ve [araçlar kataloğu](/tr/v1.0/reference/tools-catalog). - Her konuşma için uzun vadeli hatırlamayı ekle [Bellek (Einstein)](/tr/v1.0/concepts/memory-einstein).