Your first suite

A project is one contact flow. Its workspace walks you through six stages in order: Flow, Grammar, Evolve, Suite, Run and Results. Each one shows what it needs before you can move on.

In the console

1. Projects › New project. Import the flow from your Connect instance, or upload a Connect export or cxblueprint output. Importing from Connect links the project to the live flow, which is what lets you run tests there later.
2. Grammar › Generate. Diteko reads the flow and writes a grammar of what a caller can do. You can edit it as BNF or as JSON; see grammars.
3. Evolve. Pick a run size (Quick, Standard or Thorough) and what the suite should be good at, and start the run. Quick takes under a minute.
4. Suite. Choose how many tests to keep and how to order them. Each test reads as a call: what the caller hears, what they press, how the call ends.
5. Export the suite as an Excel test script, Connect native test cases or JSON, or go on to run it on Connect.

From Python

from diteko import Diteko

# DITEKO_URL and DITEKO_API_KEY come from the environment
dk = Diteko()
# A Connect export; or dk.projects.from_cxblueprint(flow)
project = dk.projects.from_json("claims.json")
project.grammar.generate()
run = project.evolve(preset="standard").wait()
suite = run.suite(top=30, selection="coverage")
suite.export_xlsx("claims-tests.xlsx")
suite.publish_to_connect(dry_run=True)

The Python SDK page covers the rest of the API.