> For the complete documentation index, see [llms.txt](https://docs.graphlit.dev/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.graphlit.dev/api-guides/use-cases.md).

# Use Case Library

**Comprehensive code examples for every Graphlit API operation** - organized for maximum discoverability.

***

## 🚀 New to Graphlit?

**Start with the basics first**: [Quickstart: Your First Agent](/getting-started/quickstart.md)

**Can't find what you need?** Open **Ask Graphlit** in the Developer Portal (or visit [ask.graphlit.dev](https://ask.graphlit.dev)) - AI assistant that writes code for you

***

## 🎯 I Want To... (Find by Task)

### Getting Content In

* [**Ingest a PDF or Word doc**](/api-guides/use-cases/content/content-ingest-uri-basic.md) - From any URL
* [**Ingest text or notes**](/api-guides/use-cases/content/content-ingest-text.md) - Plain text content
* [**Connect Slack**](/api-guides/use-cases/feeds/messaging/feed-create-slack.md) - Auto-sync messages
* [**Connect Gmail**](https://github.com/graphlit/graphlit-samples/tree/main/python/Notebook%20Examples/Data%20Connectors) - Auto-sync emails
* [**Connect Google Drive**](/api-guides/use-cases/feeds/cloud-storage/feed-create-google-drive.md) - Auto-sync files
* [**See all 30+ feeds →**](/api-guides/use-cases/feeds.md)

### Searching & Finding

* [**Basic semantic search**](/api-guides/use-cases/content/content-search-vector-explained.md) - Search by meaning
* [**Search with filters**](/api-guides/use-cases/content/content-search-with-filters.md) - Filter by date, type, etc.
* [**Hybrid search (best results)**](/api-guides/use-cases/content/content-search-hybrid-deep-dive.md) - Combines vector + keyword
* [**Find similar content**](/api-guides/use-cases/content/content-query-similar.md) - "More like this"

### AI Conversations

* [**Basic Q\&A chat**](/api-guides/use-cases/conversations/conversation-create-and-prompt.md) - Ask questions about content
* [**Streaming responses**](/api-guides/use-cases/conversations/conversation-stream-agent-real-time-ui.md) - Real-time UI with events
* [**Get source citations**](/api-guides/use-cases/conversations/conversation-prompt-with-citations.md) - Answers with page numbers
* [**Multi-turn conversations**](/api-guides/use-cases/conversations/conversation-multi-turn-with-context.md) - Memory across turns
* [**Tool calling**](/api-guides/use-cases/conversations/conversation-prompt-agent.md) - Let AI use tools

### Extracting Knowledge

* [**Extract entities from PDFs**](/api-guides/use-cases/knowledge-graph/knowledge-graph-from-pdf-documents.md) - People, companies, places
* [**Extract from emails**](/api-guides/use-cases/knowledge-graph/knowledge-graph-from-emails.md) - Contacts and organizations
* [**Extract from meetings**](/api-guides/use-cases/knowledge-graph/knowledge-graph-from-meetings.md) - Attendees and topics
* [**Query knowledge graph**](/api-guides/use-cases/knowledge-graph/observable-query-entities.md) - Find entities
* [**Find relationships**](/api-guides/use-cases/knowledge-graph/observable-relationship-queries.md) - Who works where

### Advanced

* [**Configure processing (Workflows)**](/api-guides/use-cases/workflows/workflow-create-extraction.md) - Customize extraction
* [**Choose AI models (Specifications)**](/api-guides/use-cases/specifications/specification-create-custom-model.md) - Pick the right LLM
* [**Multi-tenant setup**](/api-guides/use-cases/production/production-multi-tenant-isolation.md) - Separate customer data

***

## 📚 Browse by API Entity (Advanced)

**For developers who understand the Graphlit data model:**

### [Content Foundations](/api-guides/use-cases/content.md) (27 guides)

Understanding content types, metadata, search, and the tri-store architecture.

**Start here**: [Content Type vs File Type](/api-guides/use-cases/content/content-type-vs-file-type-explained.md) | [Hybrid Search](/api-guides/use-cases/content/content-search-hybrid-deep-dive.md)

***

### [Knowledge Graph](/api-guides/use-cases/knowledge-graph.md) (24 guides)

Extract entities, build knowledge graphs, and query relationships.

**Popular**: [PDF Entity Extraction](/api-guides/use-cases/knowledge-graph/knowledge-graph-from-pdf-documents.md) | [Email Entities](/api-guides/use-cases/knowledge-graph/knowledge-graph-from-emails.md) | [Observable Model](/api-guides/use-cases/knowledge-graph/observable-observation-model-explained.md)

***

### [Data Source Feeds](/api-guides/use-cases/feeds.md) (31 guides)

Connect 25+ data sources: Slack, Gmail, GitHub, Google Drive, Jira, and more.

**By Type**: [Messaging](/api-guides/use-cases/feeds/messaging.md) | [Cloud Storage](/api-guides/use-cases/feeds/cloud-storage.md) | [Project Management](/api-guides/use-cases/feeds/project-management.md) | [Social Media](/api-guides/use-cases/feeds/social-media.md)

***

### [Conversations & RAG](/api-guides/use-cases/conversations.md) (10 guides)

Build AI agents with streaming responses, multi-turn context, and entity-filtered RAG.

**Popular**: [Stream Agent Real-Time UI](/api-guides/use-cases/conversations/conversation-stream-agent-real-time-ui.md) | [Prompt with Citations](/api-guides/use-cases/conversations/conversation-prompt-with-citations.md)

***

### [Workflows](/api-guides/use-cases/workflows.md) (6 guides)

Configure content processing pipelines with preparation and extraction stages.

**Start here**: [Entity Extraction Workflow](/api-guides/use-cases/knowledge-graph/workflow-configure-entity-extraction.md) | [Complex Multi-Stage](/api-guides/use-cases/workflows/workflow-complex-all-stages.md)

***

### [Specifications](/api-guides/use-cases/specifications.md) (6 guides)

Configure LLM models, embeddings, and custom specifications.

**Popular**: [Custom Models](/api-guides/use-cases/specifications/specification-create-custom-model.md) | [Embedding Configuration](/api-guides/use-cases/specifications/specification-create-embedding.md)

***

### [Collections](/api-guides/use-cases/collections.md) (4 guides)

Organize content into collections for scoped queries and management.

**Start here**: [Create and Manage Collections](/api-guides/use-cases/collections/collection-create-and-manage.md)

***

### [Alerts](/api-guides/use-cases/alerts.md) (2 guides)

Scheduled content publishing operations.

**Note**: Alerts are periodic publishing operations, not monitoring alerts.

***

### [Views](/api-guides/use-cases/views.md) (2 guides)

Organize and display content in customizable layouts.

**Start here**: [Create Semantic Search View](/api-guides/use-cases/views/view-create.md)

***

### [Production Patterns](/api-guides/use-cases/production.md) (5 guides)

Cost optimization, monitoring, multi-tenant isolation, and production best practices.

**Popular**: [Cost Optimization](/api-guides/use-cases/production/cost-optimization-model-selection.md) | [Multi-Tenant Isolation](/api-guides/use-cases/production/production-multi-tenant-isolation.md)

***

## Most Popular Use Cases

1. [Knowledge Graph from PDFs](/api-guides/use-cases/knowledge-graph/knowledge-graph-from-pdf-documents.md) - Complete PDF → entities pipeline
2. [Streaming Conversation with Citations](/api-guides/use-cases/conversations/conversation-stream-agent-real-time-ui.md) - Real-time RAG with sources
3. [Create Slack Feed](/api-guides/use-cases/feeds/messaging/feed-create-slack.md) - Sync Slack messages with entity extraction
4. [Hybrid Search Deep Dive](/api-guides/use-cases/content/content-search-hybrid-deep-dive.md) - Understanding RRF algorithm
5. [Entity Extraction Workflow](/api-guides/use-cases/knowledge-graph/workflow-configure-entity-extraction.md) - Configure entity extraction

***

## Documentation Philosophy

Every use case includes:

* **TypeScript canonical examples** with Python/C# adaptations
* **Complete, working code** ready to copy-paste
* **Configuration options** and variations
* **Developer hints** and gotchas
* **Common issues & solutions**
* **Production patterns** from real applications

***

## Quick Links

**Getting Started**: [Quickstart: Your First Agent](/getting-started/quickstart.md) | [Knowledge Graph Tutorial](/tutorials/knowledge-graph.md)

**Platform Concepts**: [Key Concepts](/platform/key-concepts.md) | [Semantic Memory](/platform/semantic-memory.md)

**Sample Apps**: [GitHub Samples Repository](https://github.com/graphlit/graphlit-samples)

***

**Total**: 117 verified use case guides | Updated: January 2025 | **All code verified against TypeScript SDK**