Wiedza / RAG

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

**Wiedza** polega na tym, że AiHummer opiera odpowiedzi na Twoich dokumentach, a nie na danych treningowych modelu. Wprowadzasz treść, a agent pobiera odpowiednie fragmenty z `search_knowledge` narzędzie, a odpowiedzi wracają **z cytowaniami**. Dla trudniejszych pytań, `deep_research` narzędzie przeprowadza wieloetapowe śledztwo i sporządza raport z cytatami. Wiedza jest zarządzana zgodnie z `/v1/admin/knowledge/*` i `/v1/admin/knowledge/connectors/*`. ## Spożywanie treści Możesz spożyć **dokumenty, pliki PDF i adresy URL** do bazy wiedzy. Zaimportowane treści są indeksowane, aby mogły być pobierane w czasie udzielania odpowiedzi i przypisywane do ich źródła. > [!TIP] > Przyjmij kanoniczną wersję dokumentu raz i pozwól agentom ją cytować, zamiast > niż wklejanie długich fragmentów do poleceń. Cytowane wyszukiwanie utrzymuje odpowiedzi > weryfikowalne i twój kontekst mały. ## Oparte na faktach odpowiedzi i narzędzia Dwa narzędzia udostępniają bazę wiedzy agentowi: | Narzędzie | Co to robi | |---|---| | `search_knowledge` | Pobiera odpowiednie fragmenty i uzasadnia odpowiedź cytatami. | | `deep_research` | Przeprowadza wieloetapowy proces badawczy w całej bazie wiedzy i tworzy raport z cytowaniami. | Oboje docierają na zakręcie jako **wyniki narzędzia**, nigdy jako wstrzykiwane instrukcje — ta sama dyscyplina dotycząca wstrzykiwania poleceń stosowana jest wszędzie w AiHummer. Odpowiedzi niosą **cytaty** tak aby czytelnik mógł śledzić twierdzenie aż do jego źródła. > [!NOTE] > `deep_research` jest przeznaczone do prawdziwych pytań wieloetapowych — zajmuje więcej czasu i > tokenów niż jeden `search_knowledge` połączenie. Sięgnij po to przy jednym odzyskaniu > to nie wystarcza. ## Łączniki wiedzy Poza ręcznym wprowadzaniem, wiedza może być pobierana z zewnętrznych źródeł za pomocą łączy zarządzanych w ramach `/v1/admin/knowledge/connectors/*`. Dostępnych jest siedem konektorów; poświadczenia każdego z nich znajdują się w zaszyfrowanym sejfie na tajemnice, a w tle działa harmonogram uruchamiający synchronizacje: | Złącze | Co to ciągnie | |---|---| | **Dysk Google** (`gdrive`) | Pliki Google Drive za pomocą konta serwisowego (JSON z poświadczeniami). | | **Microsoft Graph** (`msgraph`) | Dokumenty SharePoint / OneDrive za pomocą aplikacji Microsoft Graph. | | **Pojęcie** (`notion`) | Strony Notion za pomocą tokenu integracji wewnętrznej. | | **Slack** (`slack`) | Historia wiadomości w kanale Slack za pomocą tokenu Web API (wszystkie kanały lub skonfigurowana lista). | | **S3** (`s3`) | Obiekty z koszyka zgodnego z S3 (AWS S3, GCS w trybie S3, MinIO itp.), opcjonalnie pod prefiksem. | | **SQL** (`db`) | Wiersze zapytania SQL tylko do odczytu w bazie danych, zaimportowane jako dokumenty. | | **Zlewisko** (`confluence`) | Strony Confluence Cloud (Podstawowe uwierzytelnianie za pomocą tokena API Atlassian), opcjonalnie ograniczone do jednej przestrzeni. | Osobno, jednorazowy **Eksport Slack** importuje ZIP eksportu przestrzeni roboczej przesłany ręcznie — bez przechowywanego sekretu i bez harmonogramu. > [!WARNING] > Konektor Google Drive jest sprawdzony w praktyce; pozostałe są zaimplementowane i > objęte testami, ale sprawdź je w odniesieniu do własnych danych przed ich wykorzystaniem > w produkcji. ## Magazyn wektorów i osadzenia Domyślnie wyszukiwanie może działać na **magazyn w pamięci z osadzaczem skrótów**, co wystarczy, aby rozpocząć. Do semantycznego wyszukiwania na poziomie produkcyjnym, skieruj AiHummera na **prawdziwy magazyn wektorów i osadzacz**: ```bash AIHUMMER_QDRANT_URL=http://localhost:6333 AIHUMMER_EMBEDDER_URL=http://localhost:8081 ``` Gdy te są ustawione, pobieranie i `search_knowledge` użyj zewnętrznego magazynu wektorów i osadzacza zamiast pamięciowej alternatywy. > [!NOTE] > Osadzacz semantyczny to **wybór, nie domyślnie**: instalator natywny gospodarza > zabezpiecza je tylko wtedy, gdy zdasz `--with-embedder` (Ollama z lekkim > wielojęzyczny model; następnie wskazuje `AIHUMMER_EMBEDDER_URL` w > `http://127.0.0.1:11434/api/embeddings`). Bez osadnika, wyszukiwanie działa > na leksykalnym awaryjnym ## API administratora | Zasób | Cel | |---|---| | `/v1/admin/knowledge` | Zarządzanie bazą wiedzy, w tym pobieranie | | `/v1/admin/knowledge/connectors` | Skonfiguruj łączniki KB (Drive, Graph, Notion, Slack, S3, SQL, Confluence) | ## Dokąd dalej - Zobacz `search_knowledge` i `deep_research` obok każdego innego narzędzia w [Narzędzia](/pl/v1.0/concepts/tools) i [katalog narzędzi](/pl/v1.0/reference/tools-catalog). - Dodaj długoterminowe przypominanie na rozmowę z [Pamięć (Einstein)](/pl/v1.0/concepts/memory-einstein).