Workflow Rules

When working in an entry point in Workflow Mode, your flows will be validated against the rules in this guide. This will make it easier to test navigation without modifying or migrating existing flows. 

Entry points are navigation boundaries

  • An entry point establishes the navigation scope of the Agentic API. The Agentic API cannot support navigation outside the entry point.
  • Agentic API can navigate all flows within an entry point.

Shapes rules

  • Shapes allowed in a flow
    • Basic shapes: Action, Decision, Backstory, Critical, End
    • Action flow links (i.e. Action shapes that are linked to a flow)
  • All flows must start with an Action shape
    • Start flows with Action Shape, Decision Shape or Backstory Shape
  • All flows must end with an End Shape 
    • End flows with Action Shape
  • Shapes with text hyperlinked to a URL or to a flow are allowed. However, during navigation via the Agentic API, the URL or flow name is displayed as plain text and not navigated or executed.
    • URL hyperlinked to text is allowed, but URL will be displayed as plain text

      Flow URL hyperlinked to text is allowed, but flow name will be displayed as plain text
    • Flow link to new and existing flows is allowed. Flow will be navigated

Shape-Connector rules 

Shape

# of in-connectors

# of out-connectors

Notes about connectors
Start Shapes (Action, Decision or Backstory) None Only 1 Connectors must not have text labels
Step Action 1 or more Only 1 Connectors must not have text labels
Backstory 1 or more Only 1 Connectors must not have text labels
Decision 1 or more More than 2 Out-connectors must have text labels
Critical 1 or more Only 1 Connectors must not have text labels
End Point 1 or more None Connectors must not have text labels

Connector rules

  • A connector must connect two shapes
  • Ensure all connectors are firmly connected to shapes via the connector sockets

Important Shape and Flow exceptions

  • Shapes existing in isolation and not connected in a flow will be ignored
  • Empty flows are considered valid flows