# Context pack: Podstawowe pojęcia Source: https://nordvec.com/pl/docs/guides/concepts Pack: https://nordvec.com/pl/docs/packs/concepts This pack bundles one Nordvec guide with the guides it builds on and the guides it links to, in reading order, so an assistant reading it meets no reference it cannot follow. ## Contents 1. [Podstawowe pojęcia](https://nordvec.com/pl/docs/guides/concepts) (this guide) 2. [Dokumenty i wyszukiwanie](https://nordvec.com/pl/docs/guides/concepts/documents) (linked from this guide) 3. [Rozmowy i cytowania](https://nordvec.com/pl/docs/guides/concepts/conversations) (linked from this guide) --- # Podstawowe pojęcia Source: https://nordvec.com/pl/docs/guides/concepts Dwie rzeczy, na których opiera się wszystko w Nordvec: dokumenty, których możesz szukać, i rozmowy, które się na nie powołują. Każdy łącznik, push i wyszukiwanie w Nordvec tworzy lub odczytuje dokument, a każda odpowiedź asystenta to rozmowa oparta na tych dokumentach. Zacznij tutaj, aby dowiedzieć się, co zawiera każdy z nich i kto może go zobaczyć. - [Dokumenty i wyszukiwanie](https://nordvec.com/pl/docs/guides/concepts/documents): Dokumenty są przeszukiwalną jednostką w Nordvec. Przetwórz je, a następnie znajdź za pomocą pełnotekstowego wyszukiwania przez API. - [Rozmowy i cytowania](https://nordvec.com/pl/docs/guides/concepts/conversations): Rozmowa to czat oparty na twoich dokumentach, w którym każda odpowiedź jest śledzona do swojego źródła. --- # Dokumenty i wyszukiwanie Source: https://nordvec.com/pl/docs/guides/concepts/documents Dokumenty są przeszukiwalną jednostką w Nordvec. Przetwórz je, a następnie znajdź za pomocą pełnotekstowego wyszukiwania przez API. Dokument to jednostka, po której przeszukuje Nordvec: plik, strona, wiadomość, e-mail, cokolwiek zaimportujesz. Gdy dokument zostanie przetworzony, staje się przeszukiwalny i może być cytowany w odpowiedzi. ## Importowanie dokumentów [#importowanie-dokumentów] Dokumenty trafiają do twojej przestrzeni roboczej na trzy sposoby: * **Łączniki** synchronizują się ze źródłem, które posiadasz (jako właściciel łącznika). Nowe i zmienione dokumenty są pobierane automatycznie. Zobacz [katalog łączników](/docs/guides/connectors). * **Przesyłanie** plików, które dodajesz w aplikacji. * **Push** wysyła dokument bezpośrednio do Nordvec z twojego systemu. Zobacz [Push documents](/docs/guides/how-to/push-documents). Niezależnie od sposobu dostarczenia, Nordvec przetwarza dokument, dzieli go na fragmenty i indeksuje w celu wyszukiwania. Twoje dokumenty są przechowywane i przeszukiwane w UE. Dokument ma status `status`: `processing` podczas indeksowania, `indexed` po zakończeniu wszystkich kroków przetwarzania oraz `failed`, gdy nie można go było przetworzyć. ## Kto widzi dokument [#kto-widzi-dokument] Dokument z łącznika jest prywatny dla osoby, która go podłączyła, dopóki ta osoba go nie udostępni. Klucz API należy do przestrzeni roboczej, więc widzi to, co przestrzeń udostępnia, a nigdy nie widzi nieudostępnionych dokumentów danej osoby. ## Wyszukiwanie [#wyszukiwanie] `/documents/search` to **wyszukiwanie pełnotekstowe** po tytule i całej treści każdego dokumentu, który widzisz, niezależnie od jego długości. Słowa pasują w formie, w jakiej je wpiszesz, w dowolnym języku, a znaki diakrytyczne są ignorowane po obu stronach, więc `cafe` znajduje `café`. Nie ma stemmingu: `invoice` nie pasuje do `invoices`. Wyszukiwanie działa samodzielnie, bez kontekstu rozmowy. Zwraca posortowane dokumenty, każdy z fragmentem najlepiej pasującego fragmentu i wynikiem trafności od 0 do, ale nigdy nie osiągając, 1. ```bash curl https://nordvec.com/api/v1/documents/search \ -H "Authorization: Bearer $NORDVEC_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "query": "renewal terms", "limit": 10 }' ``` Możesz również wyświetlić listę dokumentów (`/documents/list`) lub pobrać jeden po identyfikatorze (`/documents/{id}`). Zobacz [dokumentację API](/docs/api), aby poznać pełen zestaw parametrów i kształt odpowiedzi. ### Wypróbuj [#wypróbuj] Uruchom zapytanie na małym korpusie demonstracyjnym. To przeszukuje sześć przykładowych dokumentów w przeglądarce, posortowanych i z podanym źródłem, w takim samym formacie, jaki zwraca prawdziwe wyszukiwanie. Wyszukiwanie semantyczne, które dopasowuje fragmenty według znaczenia, a nie dokładnych słów, jest tym, co napędza [cytowane odpowiedzi w rozmowie](/docs/guides/concepts/conversations). Sam endpoint wyszukiwania dopasowuje słowa. Wyszukiwanie zwraca tylko dokumenty, które osoba wywołująca ma prawo zobaczyć. Kontrola dostępu jest egzekwowana w bazie danych, a nie w kodzie aplikacji. ## Typy treści [#typy-treści] Dokument może mieć przypisany typ wiedzy w `content_type` (na przykład `decision`, `runbook`, `policy` lub `faq`). Dokument wysłany przez push ustawia go za pomocą `type` w API push; dokument bez typu ma `content_type: null`. Zarówno wyszukiwanie, jak i lista filtrują po nim za pomocą `contentType`. ## Gdzie dokumenty są cytowane [#gdzie-dokumenty-są-cytowane] Wyszukiwanie dostarcza fragmenty do bezpośredniego wykorzystania. Gdy zamiast surowych fragmentów chcesz gotową odpowiedź, [rozmowa](/docs/guides/concepts/conversations) przeszukuje te same dokumenty i cytuje je w swojej odpowiedzi. --- # Rozmowy i cytowania Source: https://nordvec.com/pl/docs/guides/concepts/conversations Rozmowa to czat oparty na twoich dokumentach, w którym każda odpowiedź jest śledzona do swojego źródła. **Rozmowa** to czat oparty na twoich dokumentach. Zadasz pytanie, Nordvec wyszukuje odpowiednie fragmenty, a następnie odpowiada na ich podstawie, cytując użyte dokumenty. Jeśli dokumenty nie zawierają odpowiedzi, Nordvec informuje o tym, zamiast zgadywać. ## Cytowania są kluczowe [#cytowania-są-kluczowe] Każda odpowiedź zawiera źródła, z których została zbudowana. To celowe: odpowiedź RAG, której nie można prześledzić, jest obciążeniem, a nie funkcją. Cytowania pozwalają człowiekowi przejść do dokładnego dokumentu, z którego pochodzi twierdzenie, i je potwierdzić, a to właśnie jest potrzebne w pracy regulowanej i wysokiego ryzyka. Odpowiedzi są generowane przez AI. To cytowania sprawiają, że są weryfikowalne, a nie tylko prawdopodobne. ## Rozmowy należą do osoby [#rozmowy-należą-do-osoby] Rozmowa jest własnością zalogowanej osoby, która ją rozpoczęła, więc jej punkty końcowe odpowiadają na **sesję**, a nie na klucz API. Klucz jest samodzielnym podmiotem bez własnej historii czatu; zobacz [Uwierzytelnianie](/docs/guides/authentication). Dzięki sesji możesz: * **Utworzyć** rozmowę (`POST /conversations`). * **Wyświetlić** i **wyszukać** swoje rozmowy (`GET /conversations`, `GET /conversations/search`). * **Pobrać** rozmowę z jej najnowszymi wiadomościami (`GET /conversations/{id}`) oraz przeglądać starszą historię (`GET /conversations/{id}/messages`). * **Wyświetlić dokumenty**, na których rozmowa się opierała (`GET /conversations/{id}/documents`). Zobacz [dokumentację API](/docs/api), aby poznać dokładne kształty żądań i odpowiedzi. ## Informacje zwrotne [#informacje-zwrotne] Możesz przesłać informację zwrotną dotyczącą odpowiedzi oraz fragmentów, które zostały pobrane. Ten sygnał jest wykorzystywany do poprawy jakości wyszukiwania z czasem.