Search Knowledge Base

​

What it does

​

Key features

• Semantic Search: AI understands context and meaning, not just keywords
• Hybrid Results: Combines vector similarity with traditional text search
• File Filtering: Include or exclude specific documents from search
• Ranked Results: Results ordered by relevance with similarity scores
• Multi-Format Support: Search across PDFs, Word docs, spreadsheets, and text files
• High Performance: Executes in JavaScript with direct database access for optimal speed

​

Parameters

​

Common use cases

​

Find policy information

query: "employee vacation policy"
knowledge_base_id: 123
top_k: 5

​

Research financial data

query: "quarterly revenue trends"
knowledge_base_id: 456
top_k: 10

​

Search specific documents

query: "budget analysis"
knowledge_base_id: 123
include_file_ids: [45, 67, 89]
top_k: 8

​

Exclude outdated content

query: "product specifications"
knowledge_base_id: 123
exclude_file_ids: [12, 34]
top_k: 10

​

Technical documentation lookup

query: "API authentication methods"
knowledge_base_id: 789
top_k: 5

​

Best practices

• Use specific, descriptive queries for better results
• Start with broader searches, then use file filtering to narrow down
• Monitor similarity scores to gauge result quality
• Organize knowledge bases by topic for more focused searches
• Regularly update knowledge bases by removing outdated documents

​

Troubleshooting

• Try broader or alternative search terms
• Check that the knowledge base contains relevant documents
• Verify the knowledge base ID is correct

• Confirm the knowledge base ID exists in your organization
• Check that you have access to the specified knowledge base
• Ensure the knowledge base has been successfully created

• Try rephrasing your query with different keywords
• Use more specific terms related to your content
• Check that your documents contain the information you’re searching for

• Verify that the file IDs exist in the knowledge base
• Check that include/exclude file ID arrays are properly formatted
• Ensure files haven’t been deleted from the knowledge base

​

Companion tools

• Read File — opens a full KB document with kb:<file-id> once search surfaces a hit
• list_kb_files — lists what’s in a knowledge base without spinning up a sandbox

​

Related tools

• Call API - Fetch external data to supplement knowledge base searches
• Run Code - Process and analyze search results
• Send Email - Share search results with team members