Mocks
Open in CMSThe Tool Mocks screen is where you build reusable mock sets: scripted answers for your agent's tools, so conversation simulations run against predictable responses instead of calling real tools. Found in the agent sidebar under Simulation → Mocks; this menu item appears only when the Mocks feature is enabled. You attach mock sets to a conversation in the Tool Mocks card of the Scenarios form.
Mock Set List
| New Mock Set | Opens the editor for a new library mock set. |
| Show Filters / Hide Filters | Opens or closes the filter panel. |
| Name | Filter: shows only mock sets whose name contains the text you type. |
| Tool | Filter: shows only mock sets that mock the selected tool. |
| Apply / Reset | Applies the filters, or clears them. |
| Sort By | Orders the list by Updated Date (default, newest first) or Name, Ascending or Descending. |
| Grid View / List View | Shows mock sets as cards or as a table (columns Name, Tools · cases, Used in, Updated). |
| Mock set card or row | Shows the name, description, how many tools and cases it has, the tool names, and how many conversations use it. Click it to open the editor. |
| ⋮ menu | Edit, Duplicate (creates a copy), Delete. |
| Delete | Asks for confirmation. If the set is still attached to conversations, This mock set is in use lists where, and the confirm button removes it from those conversations and then deletes it. |
| Load More | Shown when more mock sets are available. |
| Empty state | No Mock Sets Yet until you create the first one. |
Mock Set Editor: Header
The editor opens as New Mock Set, or with the set's name when editing. It always edits a Library set (shared, reusable by any conversation).
| Used in n conversations | Edit mode only. Opens a list of the conversations (and steps) that use this set. |
| Save | Saves the mock set. If someone else changed it in the meantime, you are asked to reload it. |
| Duplicate | Edit mode only. Creates a copy of the set. |
| Name | Required. For example "Doctor scheduling, happy path". |
| Description | Optional. What this mock set is for. |
Mock Set Editor: Tools in This Set
| Tools in this set | The tools this set mocks. Select one to edit its cases on the right. |
| Add tool | Opens a searchable list of the tools of the published agent (the version simulations run against). Pick a tool to add it. |
| Tool not found in the published agent | Shown on a tool that no longer exists in the published agent. Use Re-bind to… to point its cases at another tool. |
| Remove (trash icon) | Removes the tool and its cases from the set. |
Mock Set Editor: Cases
Each case is one scripted answer, used when the tool is called with matching arguments. Cases are checked in order.
| Add case | Adds a new case for the selected tool. |
| Case label | Optional name for the case (shown as "Untitled case" when empty). Drag to reorder; duplicate or delete with the icons. |
| When all of these match | The conditions on the tool's arguments. Add condition adds one. The case only answers when every condition holds. |
| Advanced: Match raw arguments | Optional extra match on the raw arguments JSON, checked in addition to the conditions. |
| Response | What the tool returns for this case. Edited with a form that fits the tool, or with View as JSON. HTTP-style tools also have a status code. Fetch a sample and Use a real response fill it from a real call where that is safe. |
Mock Set Editor: Otherwise (every other call)
What happens to a call that matches no case. Choose under Advanced.
| Respond with a default | The call gets the default response you edit here. |
| Keep looking | The call moves on to the next mock set, then to the tool's default simulation policy. In the tool list, such tools are marked "Keeps looking". |
Mock Set Editor: Try a Call
| Try a call | Enter test arguments (as fields, or Paste arguments JSON) and click Test to see which case would answer, or why each case was skipped. |