Managing Indexes
This guide covers the day-to-day management of your knowledge bases — browsing what is in them, searching for specific entries, adding new information, and keeping everything up to date. Everything here happens on the Knowledge page in the portal.
Browsing entries
Section titled “Browsing entries”The Knowledge page shows entries from your visible indexes in a single card grid. Everyone sees Shared Knowledge, Agent Discoveries and the Agent Directory. Owners and admins also see Admin Data. Private notes appear only for your own companion and for agents assigned to you; admins do not see other people’s private notes. Custom indexes do not appear on this grid. The combined view searches up to 12 of your visible indexes at once; if you have more, use Advanced to pick one. Each card shows:
- Title — The name of the entry
- Source badge — Which index the entry lives in (Shared, Hive, Directory, Admin, or an agent’s name)
- Content preview — The first few lines of the entry’s content
- Keywords — The first few tags attached to the entry for discoverability
- Tracking footer — The entry’s version number, when it was last updated, who last edited it, and how many times agents referenced it in the last 30 days
The grid is sorted newest first by default. Results are paginated 20 per page, with Previous and Next controls at the bottom.
Sorting and filtering
Section titled “Sorting and filtering”A filter row above the results lets you narrow things down:
- Sort — Newest first, Oldest first, Relevance, Most used (30d), or Least used (30d)
- Scope — All notes, Shared only (Shared Knowledge, Agent Discoveries and the Agent Directory together), or My agents only
- Agent — Limit results to entries from a specific agent
- Author — Limit results to entries created or last edited by a specific person (appears once at least one edit has been recorded)
- Advanced — A raw index selector that scopes browsing to one specific index, useful for targeted admin browsing
Searching
Section titled “Searching”At the top of the Knowledge page you will find a search bar. Type a query and press Enter (or click Search) to run it. The sort switches to Relevance unless you have already picked a sort yourself, and a Clear button resets the search. Relevance is ranked within each index, so to compare matches properly, pick one index under Advanced.
The portal search matches keywords across entry titles, content, and keywords. Agents searching with sprigr_search additionally apply semantic matching on top of keyword search (see the overview), so an entry an agent can find semantically may need the right keywords to surface in the portal search bar.
Adding entries
Section titled “Adding entries”-
Click “Add Entry”
Click the Add Entry button at the top of the Knowledge page.
-
Choose where to save
Pick the target index from the Save to dropdown. It defaults to an agent’s private index when you have one (or to the index picked under Advanced), otherwise Shared Knowledge. Check the selection before you save. Choose Shared Knowledge for anything other agents should be able to find.
-
Enter a title
Give the entry a clear, descriptive title. This is the first thing agents (and you) will see in search results. Use natural language that matches how people would ask about this topic.
Good titles: “Annual Leave Policy”, “How to Process a Refund”, “Pricing — Residential Lawn Care”
-
Write the content
Add the full information you want the agent to know. Write it in plain language — you are not writing code or configuration, you are writing the answer you want the agent to be able to give.
Include all relevant details: steps, conditions, exceptions, contact information, and links to further resources.
-
Add keywords
Keywords are the secret to great search results. Add comma-separated synonyms, abbreviations, related terms, and alternative phrasings that people might use when looking for this information.
For example, for an entry titled “Annual Leave Policy”, good keywords would be:
holiday, vacation, time off, PTO, leave request, days off, annual leave entitlement -
Click “Create”
The entry is saved and becomes available to agents through
sprigr_search. There can be a brief indexing delay before a new entry shows up in search results.
Who can change entries
Section titled “Who can change entries”Owners and admins can edit or delete any entry they can see. On Shared Knowledge, Agent Discoveries and the Agent Directory, other team members can only edit or delete entries they created themselves. Entries an agent wrote, and facts distilled from your files, can only be changed by an owner or admin. If you try to change one you are not allowed to, the editor shows an error and nothing is saved.
Editing entries
Section titled “Editing entries”To edit an entry, click the Edit button on its card. This opens the entry editor where you can update the title, content, and keywords, then click Update. Edits always stay on the entry’s own index — you cannot move an entry between indexes by editing it.
Each edit increments the entry’s version number (shown in the card footer as v2, v3, and so on) and records who made the change, so you can see at a glance which entries have been maintained and by whom.
Keep entries up to date as your business changes. Outdated information in a knowledge base can lead to agents giving incorrect answers.
Deleting entries
Section titled “Deleting entries”To delete an entry, click the Delete button on its card. You will be asked to confirm before the entry is permanently removed.
Delete entries when:
- The information is no longer relevant (discontinued product, old policy)
- The entry has been replaced by an updated version
- It contains incorrect information that should not be served to users
Keywords best practices
Section titled “Keywords best practices”Keywords are the most impactful thing you can do to improve how well agents find information. Here are some tips:
Organising your knowledge bases
Section titled “Organising your knowledge bases”Beyond the standard indexes (Shared Knowledge, Agent Discoveries, Agent Directory, Admin Data, and each agent’s private index), you may want to consider how to structure your information:
- One big index vs. many small ones — For most organisations, putting everything in Shared Knowledge works well. The search is smart enough to find the right entries. Only split into separate custom indexes if you have clear categories with different access requirements. Entries in custom indexes are not shown in the Knowledge grid and cannot be added here; your agents read and write them.
- Naming conventions — Use consistent titles across entries. If you prefix categories (e.g. “Policy — Annual Leave”, “Policy — Expenses”), entries are easier to scan and manage.
- Regular maintenance — Treat your knowledge base like a living document. Schedule regular reviews to update, consolidate, and remove outdated entries.
Next steps
Section titled “Next steps”- Knowledge Bases Overview — Understand the different types of knowledge bases and how agents use them.
- Custom Indexes — Create additional indexes and manage keys for external access.
- Tools Reference — See how
sprigr_searchandsprigr_writework under the hood. - Creating Agents — Build agents that make the most of your knowledge bases.