Product documentation

Test & simulator

Validate intents and full conversations before publish.

Convoship gives you two complementary test surfaces: utterance testing for intent matching, and the session simulator for multi-turn flows.

Utterance test tab

Type a phrase and see matched intent, confidence score, and extracted parameters. Use this while tuning training phrases and entity bindings.

Floating simulator

  • Available on every Assistant page via the chat icon (bottom-right).
  • Shows user and bot bubbles; debug trace lists nodes executed per turn.
  • Node names from the inspector appear in the trace (not raw IDs).
  • Sessions restart automatically after completion when you send a new message.

Reading the trace

Each bot turn may include trace pills for intent match, entity capture, tool calls, and Python scripts. Open JSON in History for the full turn payload including debug metadata.

Workflow simulator

On the workflow Flow tab, the WorkflowSimulator exercises draft graphs. Supports flow-agent hops, instruction_agent LLM loops, knowledge retrieval, router/decision branching, workspace tool nodes, and nested workflow nodes. Requires Editor role (runtime.simulate capability).

Workflow chains are tested with a Run button from the chain editor. Inbound webhooks use ingress URLs documented on the Workflows overview page (HMAC-signed). History tab lists paginated sessions; Deploy tab shows live readiness blockers before release.