Knowledge Sources
Learn how to provide context and information to Kubiya agents through knowledge sources
Knowledge Sources
Knowledge sources provide Kubiya agents with the context and information they need to deliver accurate, relevant responses and take appropriate actions. By connecting agents to knowledge sources, you can customize them with domain-specific information without additional training.
What Are Knowledge Sources?
Knowledge sources are collections of information that agents can reference during conversations. Unlike the general knowledge contained in foundation models, these sources provide:
- Organization-specific information: Internal documentation, policies, and procedures
- Technical context: System architecture, infrastructure details, and troubleshooting guides
- Domain expertise: Specialized knowledge relevant to your business or industry
- Current data: Up-to-date information that may not be in the model's training data
Knowledge sources bridge the gap between an agent's general capabilities and your organization's specific context.
Types of Knowledge Sources
Kubiya supports several types of knowledge sources:
Document Repositories
- Documentation sites
- Wikis and knowledge bases
- PDF libraries
- Confluence spaces
- SharePoint sites
Code and Configuration
- GitHub/GitLab repositories
- Infrastructure as Code files
- Configuration management databases
- API specifications
Structured Data
- Databases
- CSV files
- JSON/YAML datasets
- Spreadsheets
Live Systems
- Service catalogs
- CMDB entries
- Asset management systems
- Monitoring dashboards
How Knowledge Sources Work
When an agent receives a query:
- The agent analyzes the request to determine what information is needed
- It searches relevant knowledge sources for context
- Retrieved information is processed and integrated into the agent's reasoning
- The agent generates a response based on both its core capabilities and the specific knowledge
Setting Up Knowledge Sources
To add a knowledge source to your Kubiya environment:
- Identify valuable sources: Determine what information would help your agents
- Prepare the content: Organize and format information for effective retrieval
- Configure connections: Set up access to the source repositories
- Index the content: Process the information for quick agent reference
- Assign to agents: Connect relevant knowledge sources to specific agents
Knowledge Source Configuration
A typical knowledge source configuration includes:
Knowledge Retrieval Methods
Kubiya uses several techniques to retrieve and utilize knowledge:
Semantic Search
Finds information based on meaning rather than exact keyword matches
Chunking
Breaks large documents into manageable pieces for more precise retrieval
Cross-referencing
Connects related information across different sources
Citation
Tracks the origin of information to provide references in responses
Best Practices for Knowledge Sources
For optimal knowledge integration:
- Keep content organized: Structure information logically for better retrieval
- Update regularly: Ensure information remains current and accurate
- Include context: Provide sufficient background for standalone understanding
- Balance coverage: Include enough detail without overwhelming the system
- Monitor usage: Track which sources are most helpful and refine accordingly
Quality is more important than quantity. Well-organized, relevant information is more valuable than large volumes of unfocused content.
Common Knowledge Source Use Cases
Effective use cases for knowledge sources include:
- IT support: Technical documentation and troubleshooting guides
- HR assistance: Policy documents and employee handbooks
- Compliance: Regulations, standards, and procedure documents
- Product information: Specifications, FAQs, and user guides
- Customer support: Known issues, solutions, and service catalogs
Example: Enhancing Agent Responses
Without knowledge sources:
User: "How do I request access to the production database?"
Agent: "Generally, database access requests require approval from a database administrator. Would you like me to help you find your organization's process for this?"
With knowledge sources:
User: "How do I request access to the production database?"
Agent: "To request production database access, you'll need to:
- Submit a ticket in ServiceNow using the 'Database Access Request' template
- Select 'Production' environment and specify which databases you need
- Include business justification and duration needed
- Your request will be reviewed by the Database Team (SLA: 24 hours)
- Once approved, credentials will be provisioned through Vault
Would you like me to initiate this request for you?"
Next Steps
- Learn about Agents that use knowledge sources
- Explore Tools that extend agent capabilities
- Connect your first knowledge source