🚀 IBM Watsonx Orchestrate

WXO Labs & Tutorial Guide From Zero to Hero

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

16
Labs
4
Levels
35+
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, 15: RBAC, SSO, CI/CD, remote MCP integration

🏆 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
Lab 15 ⏱️ 120 min

External Remote MCP Server Integration & Observability

Connect WxO to external remote MCP servers using Streamable HTTP and SSE. Configure custom header authentication (kind: api_key), troubleshoot 422 Gateway errors, and trace live JSON-RPC calls.

Remote MCP Streamable HTTP SSE Observability Code Engine
Lab 16 ⏱️ 120 min

IBM Planning Analytics (TM1) Enterprise MCP Integration

Connect watsonx Orchestrate AI agents to IBM Planning Analytics SaaS over Model Context Protocol. Implement dual authentication: API Key (Basic Auth) and OAuth 2.0 Auth Code Flow with mandatory v0userContext scope, querying cubes, dimensions, and MDX views.

Planning Analytics TM1 Remote MCP OAuth 2.0 API Key Enterprise AI
🏆 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

🎓

WXO Blog Series (15 Parts)

Hands-on developer tutorials covering all 15 labs from Zero to Hero

Browse All 15 Articles →
📚

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 →