--- sourceDocument: Brazil Enable AI sourceDocumentLink: https://www.servicenow.com/docs/r/intelligent-experiences Release : - brazil ft:locale : - en-US ft:publication_title : - Brazil Enable AI ft:clusterId : - platai bundleId : - platai workflow : - Platform --- # Version control # Version control for AI agents and agentic workflows {#ariaid-title1} Release version: Brazil Updated September 10, 2026 ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 2 minutes to read Summarize ![AI sparkle icon](https://servicenow.com/docs/portal-asset/ai-sparkle-icon) Summarized using AI This content was generated using new OpenAI-powered functionality. Results are provided on an as is basis and are not guaranteed to be accurate or complete. ## Summary of Version control for AI agents and agentic workflows Version control in ServiceNow enables you to manage and track changes made to theList of stepsfield for AI agents and agentic workflows. This capability is critical because the List of steps provides the contextual instructions for the large language model (LLM) to perform tasks effectively. Using version control, you can create multiple versions of these instructions, experiment with different approaches, and revert to prior versions as needed, enhancing your ability to refine and optimize AI behavior. Show full answer Show less ## Creating and Managing Versions Within the guided setup for an AI agent or agentic workflow, you can create new versions by selecting **View versions \> New version** . When doing so, you name the version to clearly document the changes made, and optionally set it as the active version immediately. You can also leverage ServiceNow Otto to automatically refine the List of steps for an existing active version through the **Refine version** option, streamlining improvement efforts. Switching between versions is straightforward: you select the desired version in the **View versions** modal and toggle the **Set as active** option. This allows you to test different instructions and evaluate their impact on AI agent or workflow performance. For agentic workflows, evaluation runs can be executed to measure effectiveness of specific versions. ## Testing and Evaluation The AI Agent Studio Testing page includes a **Version selector** dropdown that lists all versions---both active and inactive---with clear marking of the currently active version. From this page, you can easily switch versions to test them and initiate evaluation runs for precise performance assessment. ## Tracking Changes with Version Logs ServiceNow provides detailed tracking of AI agent and agentic workflow executions by version through the AI Agent Studio Activity page. From the guided setup, you can access version-specific logs via **View version logs**, which open a filtered Activity tab showing executions for the chosen version. Applying clear and descriptive version names helps you quickly identify and analyze changes and their outcomes in the logs. Version control enables you to track changes made to instructions sent to the LLM for AI agents and agentic workflows. ## Version control overview When creating an AI agent or agentic workflow, the List of steps field is important because it provides the context necessary for the large language model (LLM) to accomplish tasks. You can use version control to create multiple versions of the List of steps field in the guided setup. Tracking your changes with version control helps enable you to experiment and test new instructions. You can create versions, edit and refine versions, and revert to previous versions as needed. Figure 1. Version control modal ## Creating versions You can create a version by selecting View versionsNew version in the guided setup of an AI agent or agentic workflow. Doing so brings up the Create a new version modal where you can name the version and make changes. Naming your version enables you to identify what changes were made to make it easier to track. You can choose to make the new version active immediately by selecting the Set as active toggle. For more information about writing effective descriptions and instructions, see [General guidelines for creating AI agents and agentic workflows](https://www.servicenow.com/docs/6~S4lfOX4tdkrC93vMC37Q "By following some general guidelines for creating AI agents and agentic workflows, you can create clear and effective instructions that help maximize their efficiency and effectiveness."). When creating a new version, you also have the option to use ServiceNow Otto to refine your current List of steps. You must already have an active version for this option to be available. Selecting View versionsRefine version brings up the modal where ServiceNow Otto generates and displays a new List of steps for you to review. You can change any of the generated text, or you can use it as it was generated. Select Create to use the new, refined version. Figure 2. Create a version modal ## Changing between versions When you have multiple versions of the same List of steps field, you can switch which one is active at any time. Choosing to make a new version active enables you to test it and evaluate its effectiveness. If you're updating an agentic workflow, you can [execute an agentic evaluation run](https://www.servicenow.com/docs/LFnqFJCapULD8~5IbYOcJg "Evaluate agentic AI assets against datasets to monitor performance and compare benchmarks.") to measure performance. You can decide which version is active by selecting View versions in the guided setup. Toggle the Set as active field and save your changes to make the new version active. ## Testing different versions You can test different versions of an agentic workflow or AI agent from the AI Agent Studio Testing page. The Version selector dropdown displays both active and inactive versions with the currently active version marked as (Active). You can also start evaluation runs for specific versions by selecting Set up evaluation run. Figure 3. Version selector in the AI Agent Studio Testing page ## Version logs The AI Agent Studio Activity page enables you to track AI agent and agentic workflow executions by version. When in the guided setup, you can select View version logs in the View all versions modal. Choosing to view the version logs opens the Activity tab in a new window with the list filtered for the version you selected. When viewing the Activity tab at any time, you can choose to filter by version. The more specific your version names, the easier it is to identify those changes in the list. Figure 4. Example execution logs *[\>]: and then