# 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**


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.graphlit.dev/api-guides/use-cases.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.