190 lines
4.4 KiB
Markdown
190 lines
4.4 KiB
Markdown
# VAPORA Tutorials
|
|
|
|
Step-by-step guides to learn VAPORA from basics to advanced workflows.
|
|
|
|
## Learning Path
|
|
|
|
Follow these tutorials in order to build comprehensive understanding:
|
|
|
|
### 1. Getting Started (15 min)
|
|
- Build VAPORA from source
|
|
- Start backend and frontend services
|
|
- Run first agent
|
|
- Verify complete stack is operational
|
|
|
|
**Start here:** [01-getting-started.md](01-getting-started.md)
|
|
|
|
### 2. Basic Agents (20 min)
|
|
- Create an agent registry
|
|
- Register agents with capabilities
|
|
- Execute simple agent tasks
|
|
- Understanding agent metadata
|
|
|
|
**Prerequisites:** Complete Getting Started
|
|
|
|
**Start here:** [02-basic-agents.md](02-basic-agents.md)
|
|
|
|
### 3. LLM Routing (25 min)
|
|
- Configure multiple LLM providers
|
|
- Route requests to optimal providers
|
|
- Understand provider selection logic
|
|
- Cost comparison
|
|
|
|
**Prerequisites:** Complete Basic Agents
|
|
|
|
**Start here:** [03-llm-routing.md](03-llm-routing.md)
|
|
|
|
### 4. Learning Profiles (30 min)
|
|
- Build expertise profiles from execution history
|
|
- Understand recency bias
|
|
- Confidence scoring
|
|
- Agent improvement over time
|
|
|
|
**Prerequisites:** Complete LLM Routing
|
|
|
|
**Start here:** [04-learning-profiles.md](04-learning-profiles.md)
|
|
|
|
### 5. Budget Management (25 min)
|
|
- Set per-role budget limits
|
|
- Track spending
|
|
- Enforce budget tiers
|
|
- Automatic fallback to cheaper providers
|
|
|
|
**Prerequisites:** Complete Learning Profiles
|
|
|
|
**Start here:** [05-budget-management.md](05-budget-management.md)
|
|
|
|
### 6. Swarm Coordination (30 min)
|
|
- Register agents in swarm
|
|
- Assign tasks with load balancing
|
|
- Understand scoring algorithm
|
|
- Multi-agent workflows
|
|
|
|
**Prerequisites:** Complete Budget Management
|
|
|
|
**Start here:** [06-swarm-coordination.md](06-swarm-coordination.md)
|
|
|
|
### 7. Knowledge Graph (25 min)
|
|
- Record execution history
|
|
- Query similar past tasks
|
|
- Generate learning curves
|
|
- Recommendation system
|
|
|
|
**Prerequisites:** Complete Swarm Coordination
|
|
|
|
**Start here:** [07-knowledge-graph.md](07-knowledge-graph.md)
|
|
|
|
### 8. REST API (30 min)
|
|
- Create projects and tasks via API
|
|
- Manage agents through API
|
|
- Real-time WebSocket updates
|
|
- Error handling
|
|
|
|
**Prerequisites:** Complete Knowledge Graph
|
|
|
|
**Start here:** [08-rest-api.md](08-rest-api.md)
|
|
|
|
### 9. Frontend Integration (20 min)
|
|
- Leptos UI components
|
|
- Connect frontend to backend
|
|
- Real-time task updates
|
|
- Kanban board usage
|
|
|
|
**Prerequisites:** Complete REST API
|
|
|
|
**Start here:** [09-frontend-integration.md](09-frontend-integration.md)
|
|
|
|
### 10. Production Deployment (30 min)
|
|
- Kubernetes deployment
|
|
- Monitoring with Prometheus
|
|
- Scaling agents horizontally
|
|
- Production best practices
|
|
|
|
**Prerequisites:** Complete Frontend Integration
|
|
|
|
**Start here:** [10-production-deployment.md](10-production-deployment.md)
|
|
|
|
## Total Learning Time
|
|
|
|
- Estimated: ~4 hours for complete learning path
|
|
- Can be completed individually
|
|
- Each tutorial is self-contained with examples
|
|
|
|
## Quick Reference
|
|
|
|
### By Topic
|
|
|
|
**Agent Management**
|
|
- Tutorial 2: Basic Agents
|
|
- Tutorial 4: Learning Profiles
|
|
- Tutorial 6: Swarm Coordination
|
|
|
|
**LLM & Costs**
|
|
- Tutorial 3: LLM Routing
|
|
- Tutorial 5: Budget Management
|
|
|
|
**Data & Persistence**
|
|
- Tutorial 7: Knowledge Graph
|
|
- Tutorial 8: REST API
|
|
|
|
**User Interfaces**
|
|
- Tutorial 9: Frontend Integration
|
|
- Tutorial 10: Production Deployment
|
|
|
|
### By Complexity
|
|
|
|
**Beginner** (Tutorials 1-3)
|
|
- Get VAPORA running
|
|
- Understand components
|
|
- First agent execution
|
|
|
|
**Intermediate** (Tutorials 4-7)
|
|
- Multi-agent workflows
|
|
- Cost control
|
|
- Learning & optimization
|
|
|
|
**Advanced** (Tutorials 8-10)
|
|
- Full-stack integration
|
|
- Production deployment
|
|
- Monitoring & scaling
|
|
|
|
## Examples Directory
|
|
|
|
For code examples, see `examples/`:
|
|
|
|
- **Basic examples** - `crates/*/examples/01-*.rs`
|
|
- **Intermediate** - `crates/*/examples/0[2-3]-*.rs`
|
|
- **Full-stack** - `examples/full-stack/`
|
|
|
|
Each tutorial references relevant examples you can run.
|
|
|
|
## Hands-On Practice
|
|
|
|
Each tutorial includes:
|
|
- Prerequisites checklist
|
|
- Step-by-step instructions
|
|
- Code examples (from examples/ directory)
|
|
- Expected output
|
|
- Common troubleshooting
|
|
- Next steps
|
|
|
|
## Getting Help
|
|
|
|
- Check **Troubleshooting** section in each tutorial
|
|
- Review example code in `examples/`
|
|
- Run examples with `--verbose` flag
|
|
- Check logs: `RUST_LOG=debug cargo run`
|
|
|
|
## Feedback
|
|
|
|
Found an issue? Want to suggest improvements?
|
|
|
|
- Report issues: https://github.com/anthropics/claude-code/issues
|
|
- Reference: "VAPORA Tutorial: [number] - [title]"
|
|
|
|
---
|
|
|
|
**Estimated completion time: 4 hours**
|
|
|
|
**Current progress:** Pick a tutorial to start →
|