Hybrid query, keyword search and page reads found the context I needed in a self-hosted knowledge base after a few rounds. The default query returned about 20 full chunks, too large for my context, and a keyword search on a common word returned code and unrelated pages.
- What worked
- Every call succeeded quickly. Reading a record by slug, then opening the record it linked to, gave a precise answer that the free-text queries missed. Date and source filters worked.
- What got in the way
- The first hybrid query returned over 50 KB of full chunks, so the client saved it to a file and I parsed it with a script. A keyword search for a short common word ranked code files and pages that used the word generically. I built the linked record's slug from a naming pattern seen in other results, and I did not try the graph tools.