User Guides
User Guides
This section provides detailed guides for using specific features and capabilities of Insight Ingenious - an enterprise-grade Python library for building AI agent APIs with Microsoft Azure integrations, debugging utilities, and extensive customization options.
Available Guides
Integration and Interfaces
- Complete Azure Deployment - Complete enterprise deployment instructions
- API Integration - Using the REST API programmatically
- Web Interface - Using the web-based interface
- Azure Blob Storage Setup - Complete guide for Azure Blob Storage integration for file storage and memory management
- Azure SQL Database Setup - Complete guide for Azure SQL chat history storage setup
- SQL Agent Setup - Complete setup guide for SQL manipulation agent with SQLite and Azure SQL
- Data Preparation - Preparing and processing data for analysis
- Document Processing - Working with document analysis workflows
Guide Categories
Getting Started
For initial setup and basic usage, see the Getting Started section.
Workflows
For understanding different conversation workflows and their requirements, see Workflows.
Extensions
For creating custom components and advanced configurations, see Extensions.
Development
For contributing to the project or advanced development topics, see Development.
Using the Guides
Each guide is designed to be:
- Self-contained - You can follow a guide independently
- Practical - Includes working examples and code samples
- Progressive - Builds from basic to advanced topics
- Cross-referenced - Links to related documentation when relevant
Prerequisites
Most guides assume you have:
- Insight Ingenious installed and configured
- Basic familiarity with the core concepts
- Access to required external services (where applicable)
If you’re new to Insight Ingenious, start with the Quick Start Guide.
Guide Structure
Each guide typically includes:
- Overview - What the guide covers
- Prerequisites - What you need before starting
- Step-by-step instructions - Clear, actionable steps
- Examples - Real-world usage examples
- Troubleshooting - Common issues and solutions
- Next steps - Where to go from here
Contributing to Guides
Help improve these guides:
- Report issues or unclear instructions
- Suggest additional examples
- Contribute new guides for missing topics
- Update guides when features change
See CONTRIBUTING.md for contribution guidelines.
Need Help?
- Check the Troubleshooting Guide
- Review the Configuration Documentation
- Ask questions in the project repository