Knowledge Graph concepts
Knowledge Graph is a structured way to store and retrieve information from your documents, websites, and data sources. Unlike traditional search systems that rely on keyword matching or vector similarity, Knowledge Graph creates a network of interconnected information that captures relationships between concepts, entities, and ideas.How Knowledge Graph works
Knowledge Graph processes your data through several stages:- Content ingestion: upload files, connect data sources, or add website URLs
- Graph construction: analyze content to identify entities, concepts, and relationships
- Indexing: create a searchable graph structure that captures semantic connections
- Query processing: when you ask questions, the system traverses the graph to find relevant information
- Response generation: combine retrieved information with AI to generate accurate, contextual answers
Data sources and formats
Knowledge Graph supports multiple ways to add data:| Source type | Description | Supported formats/features | Learn more |
|---|---|---|---|
| File uploads | Upload documents directly | - PDF, TXT, DOC/DOCX, PPT/PPTX - CSV, XLS/XLSX - EML, HTML, SRT | Manage Knowledge Graph data |
| Data connectors | Connect to external platforms | - Confluence: Access team documentation and wikis - Notion: Import workspaces and databases - Google Drive: Connect to shared drives and documents - SharePoint: Access Microsoft 365 content | Data connectors guide |
| Website integration | Add web content | - Add specific URLs or entire domains - Configure page inclusion/exclusion - Automatic content updates | Website integration guide |
Query capabilities
Knowledge Graph supports natural language questions and querying across multiple graphs. You can configure the retrieval to break it down into subqueries, support streaming, get inline citations, and fine-tune the search parameters. Core features:- Natural language questions: ask questions in plain, conversational language without needing special syntax or query formats. For example, “What is our refund policy?” or “Tell me about our enterprise pricing tiers” will work naturally.
- Multi-graph queries: search across multiple Knowledge Graphs simultaneously. For example, you can compare data across departments or time periods.
- Subqueries: break down complex questions into smaller parts automatically
- Streaming responses: get answers as they’re generated for real-time applications
- Inline citations: get answers with embedded source references to verify information
- Query configuration: fine-tune search parameters including search weight, grounding level, maximum snippets and tokens, and semantic thresholds
Add Knowledge Graph to your Writer applications
Add Knowledge Graph to your Writer applications to create conversational AI, generate content, and enable tool calling in complex workflows. Get started with these guides:- Create and manage Knowledge Graphs: set up your first Knowledge Graph via the Writer API and SDKs
- Ask questions to Knowledge Graphs: query your data directly via the Writer API and SDKs
- Build chat applications with Knowledge Graph: create conversational AI that can reference your specific data
- Use Knowledge Graph with tool calling: integrate Knowledge Graph with Agent Builder
- Enable inline citations: get source references in responses from Knowledge Graph queries
- Knowledge Graph query configuration: fine-tune search parameters
Best practices
Organize your data
- Create separate Knowledge Graphs for different topics or departments
- Use descriptive names and descriptions to help the AI understand context
- Regularly update content to ensure accuracy
Optimize queries
- Ask specific, well-formed questions for better results
- Use the query configuration parameters to fine-tune responses
- Enable subqueries for complex multi-part questions
Monitor and improve
- Review source citations to understand how information is being retrieved
- Update Knowledge Graphs with new information as it becomes available
- Test different query approaches to find what works best for your use case
Next steps
- Learn how to create and manage Knowledge Graphs
- Explore the Knowledge Graph API reference
- See how to ask questions to Knowledge Graphs
- Understand Knowledge Graph query configuration
- For additional help, visit the Writer Help Center for detailed guides and troubleshooting