Skip to main content

Versioning

Conversation-mode Tools use the same versioning model as every other Application on SimplAI. A single Tool can have many versions; only Published versions are callable from the UI, API, embeds, agents, and other integrations.

For the full shared mechanics — Save, Publish, Create Version, Configuration Diff, Restore — see Versioning.

Conversation-mode-specific notes​

  • Mode is captured in the version. Conversation mode on/off is part of the Tool's configuration and is saved on every version. Switching modes requires a new Draft and a Publish.
  • The mode toggle is read-only on Published versions. To change a published Tool from task-mode to conversation-mode (or vice versa), create a new draft, flip the toggle, accept the destructive switch warning (see Switching mode), and Publish the new version.
  • Resource ID continuity. Tools migrated from the standalone AI Chains primitive retain their original resource identifier. Existing API/SDK callers, Agent bindings, and integrations continue to work without code changes across the migration. See Migration from AI Chains.

Things to remember​

  • A Tool must have at least one Published version to enable the Deployment tab (API, embed, A2A integrations).
  • Only Published Tools appear in pickers where Tools can be referenced by Agents or other workflows.
  • Old versions can be re-published to roll back.

See Versioning for the full mechanics.