🚀 IBM Watsonx Orchestrate

WXO Labs & Tutorial Guide From Zero to Hero

Master IBM Watsonx Orchestrate through 14 progressive hands-on labs. Build production-ready AI agents with MCP, security, monitoring, and enterprise integration.

14
Labs
4
Levels
30+
Hours
🔧
Python Tools
🤖
AI Agents
🔐
Security
📊
Monitoring

Your Learning Journey

Progressive labs designed to take you from beginner to expert

🟢 Foundation

Labs 1-3: Core concepts, tool creation, basic patterns

🟡 Integration

Labs 4-8: Context, async jobs, files, MCP basics & advanced

🔴 Security & Scale

Labs 9-11: RBAC, SSO, deployment automation

🏆 Production

Labs 12-14: Monitoring, logging, evaluation pipelines

🟢 Easy

Beginner Labs

Build your foundation with core WXO concepts

Lab 1 ⏱️ 30 min

Hello World - Your First WXO Tool

Learn the fundamentals of WXO tool creation. Build a simple greeting service and understand the basic architecture.

Python CLI Agents
Lab 2 ⏱️ 45 min

Input Defaults & UI Patterns

Master Pydantic models and field validation. Create tools with smart defaults that improve user experience.

Pydantic Validation UX
Lab 3 ⏱️ 60 min

File Upload & Processing

Handle file uploads and process Excel data with pandas. Build tools that analyze and transform uploaded files.

Files Pandas Data
🟡 Intermediate

Intermediate Labs

Master advanced patterns and integrations

Lab 4 ⏱️ 90 min

Context Injection & Variables

Learn to manage state across tool calls. Build agents that remember user information and context.

Context State AgentRun
Lab 5 ⏱️ 120 min

Async Tools & Long-Running Jobs

Implement background jobs and polling patterns. Build non-blocking tools for long-running operations.

Async Threading Polling
Lab 6 ⏱️ 90 min

File Downloads & Streaming

Generate PDFs and provide download links. Handle binary data and implement streaming patterns.

PDF Downloads Streaming
Lab 7 ⏱️ 90 min

MCP Basics — Your First MCP Server

Deploy an MCP toolkit to WXO with STDIO transport. Debug discovery issues and understand the --package-root pattern.

MCP STDIO Toolkits
Lab 8 ⏱️ 120 min

MCP Advanced — User Context & Credentials

Bearer token identity propagation, SSE deployments, and key-value connections injected as environment variables.

MCP SSE JWT
🔴 Advanced

Advanced Labs

Enterprise security and deployment patterns

Lab 9 ⏱️ 120 min

RBAC Plugin - Role-Based Access Control

Implement security plugins and authorization logic. Restrict agent access based on user roles.

Security RBAC Plugins
Lab 10 ⏱️ 180 min

SSO Integration with Microsoft Entra ID

Configure enterprise SSO with SAML. Propagate user identity from Entra ID to your tools.

SSO SAML Entra ID
Lab 11 ⏱️ 150 min

Agent Export/Import & CI/CD

Automate agent deployment across environments. Build CI/CD pipelines for production releases.

DevOps CI/CD Automation
🏆 Expert

Expert Labs

Production-grade systems and monitoring

Lab 12 ⏱️ 240 min

Conversation Logging & Audit Vault

Build a tamper-proof audit system. Implement server-side logging with real-time dashboards.

Audit Compliance Dashboard
Lab 13 ⏱️ 240 min

Observability Dashboard

Monitor agent health and performance. Track token usage, errors, and system metrics.

Monitoring Metrics Observability
Lab 14 ⏱️ 300 min

RAG Evaluation Pipeline

Evaluate RAG quality with automated metrics. Build testing pipelines for production AI systems.

RAG Evaluation Testing

Additional Resources

📚

Documentation

Official WXO developer documentation and API references

View Docs →
💻

GitHub Repository

Access all test scripts, examples, and source code

View Repo →
🔧

CLI Reference

Complete guide to orchestrate CLI commands and options

View Guide →
🐛

Troubleshooting

Common issues, solutions, and debugging techniques

View Guide →