Skip to main content

Workflow Checklist and Testing

This article has a checklist of the most common weak points in the process of writing a workflow. Make sure you have covered them all for the agent to work properly. It also has some tips on the workflow testing.

Checklist Before You're Done​

  • Verify that each state includes all required fields (process_name, name, kind, description)
  • Ensure descriptions clearly explain agent actions without conflicting instructions
  • Check that transitions logically connect your states
  • Confirm that the tool is listed in available_tools for the state where it is executed
  • Include at least one init_state: true in your workflow.
  • Mark all ending states with final_state: true

Testing Tips​

  • Unit test states: Test each state individually. Check whether the agent repeats greetings, retries the same message, or gets stuck after unclear human replies.

  • Integration test the workflow: Test complete workflow paths, including transitions between states. When similar test scenarios produce different results, review the workflow for vague instructions or inconsistent examples.

  • Test edge cases: Test unexpected customer responses, including unclear replies and long, multi-part questions. Verify that the agent still gives complete and well-structured answers.

  • Load test the agent: Test with multiple concurrent conversations.

tip

To see detailed agent interaction logs, including prompt responses and state transitions:

  1. In the left sidebar, select Sessions
  2. At the bottom of the chat area, select Logs > Trace Logs

Was this article helpful?