Overview
How-to walkthroughs
These guides are task-oriented how-tos. Each one walks you through a single workflow end to end — building an ontology, connecting a feed, running an optimization, merging a branch — with concrete prompts you can type to Jax. Read them when you know roughly what you want to do and need the steps to get there.
Guides differ from tutorials. A tutorial takes you from an empty project to a finished result on one worked example (such as the FTTH network). A guide is narrower: it teaches one capability you can apply to any domain. If you are brand new, start with the Quickstart, then come back here.
What you should know first
Every guide assumes you have a project open in the workspace and that you are comfortable talking to Jax. You do not need to know how the engines work internally — the guides point you at the right one as you go. The core ideas worth skimming first are the Ontology (your typed world model) and the Nexma DataStore (where everything lives).
The guides
| Guide | What you will do |
|---|---|
| Designing with Jax | Drive Jax to produce designs by iterating in small, reviewable steps |
| Prompting Jax | Write requests that are specific, scoped, and constraint-aware |
| Build an ontology | Define entity types, link types, properties, and constraints |
| Work with skills | Load, switch, extend, and compose Skills onto an ontology |
| Connect a data source | Add a feed with Nexma SyncEngine and map it to your ontology |
| Run an optimization | Pose a problem to Nexma MathEngine and read the result |
| Branch, review and merge | Explore alternatives in isolation and promote the best to Main |
| Build an automation | Create a scheduled or event-driven workflow that runs on its own |
| Ask a spatial question | Use Nexma GeoEngine to answer a question as a map |
How to use a guide
Each guide opens with what you will accomplish and what you need in place first. The numbered steps are meant to be followed in order — most build on the one before. Example prompts appear in blockquotes; you can type them to Jax almost verbatim, swapping in your own entity names, paths, and scopes.
You do not have to finish a guide in one sitting. The Nexma DataStore persists everything, and branches let you park a half-finished exploration and return to it later without losing context.
Where to go next
- New to the platform? Run the Quickstart and then the FTTH tutorial.
- Want the concepts behind the steps? Read the Jax overview and the Ontology page.
- Looking for a specific call or field? See the API reference.