Guides
Deep-dive documentation for every capability. Each guide shows both drag-and-drop AND Azi approaches.
Quick Navigation
Connecting Data→
IoT Hub, simulators, CosmosDB databases you own, external APIs
Surfaces→
Execution boundaries where queries run
Warm Queries→
Building queries with Azi, KQL basics
APIs→
Power BI, Grafana, custom integrations
Team→
Invitations, permissions, user management
Security→
API keys, secrets, authentication
Workflow→
Save vs Commit, navigation orientation
MCP Integration→
Claude Desktop, Copilot, custom AI clients
Workbenches→
Host any git-repo workbench as its own MCP server
Governance→
Audit trails, amendment logs, ALCOA+ compliance
Guide Structure
Every guide follows the same pattern:
| Section | Purpose |
|---|---|
| Goal | What you'll accomplish |
| Prerequisites | What you need before starting |
| Option A: UI | Drag-and-drop approach |
| Option B: Azi | Natural language approach |
| Verification | How to confirm success |
| Next Steps | Related guides |
Both options lead to the same result. Azi proposes, you approve. The UI executes directly. Choose based on preference.
Finding Answers
Common questions:
| Question | Guide |
|---|---|
| "How do I connect IoT Hub?" | Connecting Data → IoT Hub |
| "How do I test with fake data?" | Connecting Data → Simulator |
| "How do I set up a database?" | Connecting Data → CosmosDB Setup |
| "How do I get a REST API for my data?" | Surfaces → Database Tables |
| "How do I build complex queries?" | Warm Queries → Working with Azi |
| "How do I connect Power BI?" | APIs → Power BI |
| "How do I invite team members?" | Team → Inviting Members |
| "How do I manage API keys?" | Security → Secrets |
| "What's Save vs Commit?" | Workflow → Save vs Commit |
| "How do I connect Claude Desktop?" | MCP → Claude Desktop |
| "How do I host a workbench from my git repo?" | Workbenches → Install from Source |
| "How do I connect an AI to my hosted workbench?" | Workbenches → MCP Access |
| "How do I track workspace changes?" | Governance → Audit Event Log |
| "How do I document corrections?" | Governance → Amendment Log |
The Control Plane Difference
What makes these guides different:
| Traditional Docs | Control Plane Guides |
|---|---|
| "Click here, then here" | "Do it yourself OR ask Azi" |
| One path | Two paths, same result |
| Assume competence | Build competence |
| Feature-focused | Task-focused |
Need Help?
Didn't find what you need? Ask Azi in your workspace - she has context about your specific setup.