config.yaml it becomes, and the resources that brief needs. Point wxctl at the config to plan, apply, test, and tear it back down. For a hand-authored, step-by-step build, see the worked example. To generate a config from a scenario, see the compose flow.
Examples sit on a three-tier ladder: primitives/ (product-neutral building blocks), products/<product>/ (one product, one capability), and solutions/ (spanning products). The Group column shows the ladder position, Industry is a discovery aid, and the Tier badge marks complexity, from Light to Heavy. The calculator-weather-agents starter is covered in the quickstart.
| Group | Example | Industry | Tier | Scenario | Resources |
|---|---|---|---|---|---|
| watsonx-orchestrate | hr-chatbot | Cross-industry | Light | HR chatbot answering policy questions from the handbook and looking up employee records | agent · knowledge_base · tool |
| watsonx-orchestrate | ap-processing | Finance | Medium | Invoice & AP agent: 3-way matching, duplicate detection, exception routing | agent · knowledge_base · tool ×2 · orchestrate_connection |
| watsonx-orchestrate | retail-bank-support | Finance | Medium | Retail-bank support agent answering product/fee questions and looking up accounts on a custom gateway model | agent · model · knowledge_base · tool ×2 · orchestrate_connection |
| watsonx-orchestrate | claims-intake-flow | Insurance | Medium | Claims-intake assistant validating eligibility with a python tool, an OpenAPI tool, and a decisions flow on a gateway model | agent · model · tool (python) · tool (openapi) · tool (flow) · space · orchestrate_connection |
| watsonx-orchestrate | model-router | Cross-industry | Medium | Multi-model gateway routing: a fast triage agent and a deep specialist behind a supervisor that routes by complexity | agent ×3 · model ×2 · space · orchestrate_connection |
| watsonx-orchestrate | ops-mcp-assistant | Cross-industry | Heavy | Ops assistant backed by a custom local MCP server that wxctl packages and uploads | agent · model · toolkit (local MCP) · space · orchestrate_connection |
| watsonx-ai | credit-risk-model | Finance | Medium | Deploy a transparent credit-risk scoring model on watsonx.ai and score a loan applicant | space · package_extension · software_specification · wml_function · wml_script · ai_service · wml_deployment |
| watsonx-data | lakehouse-analytics | Retail | Heavy | SaaS retail lakehouse: land CSVs in COS, register Iceberg + Db2 catalogs, query with Presto and Spark, run a Spark ingestion job | storage_connection · s3_bucket · s3_object · catalog · storage_registration · database_connection · database_registration · presto_engine · spark_engine · schema · ingestion_job |
| watsonx-data | lakehouse-engines | Retail | Heavy | Software (CP4D) retail lakehouse with the full engine zoo: Presto, Prestissimo, external Db2, a generic engine, and a Spark ingestion job | storage_connection · s3_bucket · storage_registration · database_connection · database_registration · presto_engine · prestissimo_engine · db2_engine · other_engine · ingestion_job |
| watsonx-data | sal-enrichment | Finance | Heavy | Enable the watsonx.data Semantic Automation Layer and auto-enrich a customer table against a glossary (Software / CP4D only) | integration · sal_integration · sal_glossary · sal_global_settings · sal_enrichment_settings · sal_enrichment_job |
| knowledge-catalog | data-glossary | Finance | Heavy | Customer-data governance taxonomy: category hierarchy, business term, bulk term import, and data-protection rules | category ×2 · business_term · business_terms · rule · rules |
| solutions | credit-risk-governance | Finance | Heavy | Four products in one config: deploy a credit-risk model, govern it with an OpenScale quality monitor, and front it with an Orchestrate loan-decision agent | space · software_specification · wml_function · wml_deployment · service_provider · data_mart · subscription · monitor_instance · orchestrate_connection ×2 · model · tool · agent |
Run an example
Every example is self-contained and credential-free: secrets are${env:VAR} placeholders, never literals. Configure a profile, export any env vars the example lists, then from the example directory:
Next steps
Worked example
Build a tool, an agent, and a test by hand, then plan, apply, and test.
Automation & CI
Run these configs unattended in a pipeline.

