Optimization

Change sets

The Change sets page lists every change set on your AI Agent, and the detail view shows the entities each one changes. Use it to review what an edit_agent_behavior session staged, is rolling out, promoted, or reverted, before deciding what happens next in the MCP assistant.

The dashboard view is read-only. Create, edit, roll out, promote, revert, and delete are done through the edit_agent_behavior MCP tool.

Overview

A change set is a bundle of edits to your AI Agent that stays off the live Agent until it is promoted. Each change set is created and managed through the edit_agent_behavior MCP tool. The dashboard Change sets page adds a place to see what has been staged and what has shipped, without leaving Ada.

Two views are available:

  • The list view at Config > AI AGENT > Change sets shows every change set on the Agent, with filters and search.
  • The detail view opens when you click a change set. It shows each entity the change set touches and what changed on it.

Limitations

The Change sets page has the following constraints:

  • Read-only: The dashboard does not create, edit, promote, revert, delete, or start or stop a rollout. Manage change sets through the edit_agent_behavior MCP tool.
  • Change sets only: The page shows change sets created through edit_agent_behavior. Direct edits made in the dashboard (for example, from the Knowledge or Playbooks pages) do not appear here.
  • 90-day retention: A promoted change set stays revertible for 90 days after it is promoted, then is automatically deleted. A testing change set is automatically deleted 90 days after it is created.

Use cases

The Change sets page helps AI Managers keep track of in-flight and shipped edits.

  • Review a pending change set: See what an MCP assistant staged before you ask it to promote or roll out the change set.
  • Audit what shipped: Read the entities and field-level changes on a promoted change set to confirm what went live.
  • Track a rollout: See which change sets are sampling live traffic and the share they cover.
  • Investigate a regression: Filter promoted change sets by date to find the change that landed around when a behavior shift started.

Capabilities & configuration

The list view provides the following controls:

  • Search: Find a change set by name or ID.
  • Status filter: Narrow the list to one status (Testing, Promoting, Promoted, or Reverted).
  • Date range: Restrict the list to change sets last edited within a window.
  • Sort: Sort the list by Status or Rollout.
  • Pagination: Move through pages of results.

The detail view provides:

  • Entities changed: One row per entity, with the entity’s icon and name on the left and a summary of what changed on the right (for example, 2 edits, article added, article deleted).
  • Field-level diff: For an edited entity, each changed field is shown side by side, with only the differing words highlighted in each line. Below 960px width, the two columns collapse into a single column.
  • Last updated: The timestamp of the most recent change to the change set.

Quick start

Find and review a change set in a few steps. See Implementation & usage for more detail.

1

Go to Config > AI AGENT > Change sets.

2

Use the search field or the Status filter to narrow the list.

3

Click a change set to open its detail view and see the entities it changes.

Implementation & usage

Use the list and detail views to see what is staged, what is live, and what shipped.

List view

The list view is the landing page at Config > AI AGENT > Change sets. Each row represents one change set on the Agent.

ColumnDescription
NameThe label given to the change set when it was created through edit_agent_behavior.
IDThe change set’s unique identifier. Copy it to pass into an MCP call, for example when promoting or rolling out.
Last editedThe most recent time the change set was modified, promoted, or reverted.
Edited byThe MCP client or user that made the most recent change.
StatusThe current lifecycle state (see Statuses). Sortable.
RolloutThe rollout state for the change set, blank when no rollout is active. Sortable.

To filter the list:

  1. On the Ada dashboard, go to Config > AI AGENT > Change sets.
  2. Use any combination of the toolbar controls:
    • Enter a name or ID in the Search field.
    • Select a status from the Status filter.
    • Set a Date range to restrict the list to change sets last edited within the window.
  3. Click a column header to sort by Status or Rollout.
  4. Move through pages using the pagination controls at the bottom of the list.

Statuses

Change sets move through the following statuses, all set through edit_agent_behavior:

  • Testing: Staged and not live. Can be tested with simulations, rolled out to a sample of new conversations, or promoted.
  • Promoting: Promotion is in progress. This is a short-lived state that resolves to Promoted when the promotion completes.
  • Promoted: Live on the AI Agent. A promoted change set stays revertible for 90 days.
  • Reverted: The change set has been reversed by a revert change set that promoted successfully.

Detail view

Click a change set in the list to open its detail view. The page is titled Change set details and shows the last-updated timestamp, followed by an Entities changed section.

Each row in Entities changed represents one entity the change set touches:

  • The left side shows the entity’s icon and name.
  • The right side summarizes what the change set does to that entity. For example, a knowledge article with two field changes reads 2 edits, a newly created article reads article added, and a deleted article reads article deleted.

Expand a row to see the field-level diff. Each changed field is shown with the previous value on the left and the new value on the right. Only the differing words on a modified line are highlighted, so a one-word edit stays readable rather than tinting the entire value. Below 960px width, the two columns collapse into a single unified column.

Have any questions? Contact your Ada team, or email us at .