Runtime How-To

Task-focused guides for common Runtime operations.

Overview

These guides show you how to accomplish specific tasks with the PromptKit Runtime. Each guide focuses on a single goal with practical, working code.

Getting Started

New to Runtime? Start with:

1. Configure Pipeline - Set up basic execution
2. Setup Providers - Connect to LLM providers
3. Handle Errors - Robust error handling

Guide Categories

Pipeline Configuration

• Configure Pipeline - Pipeline setup and configuration
• Handle Errors - Error handling strategies
• Manage State - Conversation persistence

Providers

• Setup Providers - LLM provider configuration
• Switch Providers - Multi-provider strategies
• Monitor Costs - Cost tracking and optimization

Tools & MCP

• Implement Tools - Create custom tools
• Integrate MCP - Connect MCP servers
• Validate Tools - Tool argument validation

Observability

• Prometheus Metrics - Monitor with Prometheus and Grafana
• Monitor Costs - Cost tracking and optimization

Advanced Topics

• Streaming Responses - Real-time output
• Custom Middleware - Extend pipeline behavior
• Performance Tuning - Optimize throughput

Quick Reference

Task	Guide	Time
Set up basic pipeline	Configure Pipeline	5 min
Connect to OpenAI/Claude	Setup Providers	5 min
Add MCP tools	Integrate MCP	10 min
Track costs	Monitor Costs	5 min
Monitor with Prometheus	Prometheus Metrics	10 min
Handle errors	Handle Errors	10 min
Stream responses	Streaming Responses	10 min
Persist conversations	Manage State	15 min

Code Examples

All guides include:

• ✅ Complete working code
• ✅ Step-by-step instructions
• ✅ Common pitfalls and solutions
• ✅ Best practices
• ✅ Related reference documentation

See Also

• Reference - Complete API documentation
• Tutorials - Learn by building
• Explanation - Architecture and concepts