Author or serialize a flow as a diagram You can write a whole flow as a mermaid flowchart and compile it by passing the string to flow(). Any flow renders back with String(flow), so the diagram and the program stay in sync. java academy academy/topics/flow-mermaid website/content-src/academy/course.mjs academy Author or serialize a flow as a diagram
ax
Java dev.axllm:ax
TypeScript Python Java C++ Go Rust
Unit 4 · Connect AI steps into a workflow

Author or serialize a flow as a diagram

You can write a whole flow as a mermaid flowchart and compile it by passing the string to flow(). Any flow renders back with String(flow), so the diagram and the program stay in sync.

flow(mermaid)7 focused minutesNot started
Unit example (nearest native match)

See the idea in context

String mermaid = "flowchart TD\n  %%ax classify: request:string -> route:class \"support, sales\"\n  classify{route}";
AxFlow program = Ax.flow(mermaid);
System.out.println(program);
  1. Write the diagram

    Node contracts live in %%ax directives; labeled edges become branches and loops.

  2. Compile with flow()

    A string argument to flow() compiles the dialect into a runnable flow.

  3. Render it back

    String(wf) returns the diagram, so flow(String(wf)) round-trips the program.

Run itIn your own project
// Gradle (build.gradle):
implementation 'dev.axllm:ax:22.0.4'
// Maven (pom.xml):
<dependency>
  <groupId>dev.axllm</groupId>
  <artifactId>ax</artifactId>
  <version>22.0.4</version>
</dependency>

import dev.axllm.ax.Ax;

var llm = Ax.ai("openai", Map.of("apiKey", System.getenv("OPENAI_API_KEY")));
var classify = Ax.ax("review:string -> sentiment:class \"positive, negative, neutral\"");

Set OPENAI_APIKEY in your environment before running provider-backed code.

In the ax repo

From a clone of the ax repo:

npm run example -- java src/examples/java/flows/BranchFlowExample.java
Active practice

Show that you can use it

Answer 2 in a row to learn this · attempt 1
Keep exploring

Source-backed follow-up