Skip to main content

​
Overview

Mock tools allow you to simulate external tool calls during agent testing by providing predefined input-output mappings. This ensures consistent, predictable responses during testing scenarios, making it easier to evaluate your agent’s performance and behavior. Mock tools are particularly useful when:
  • Testing agents that rely on external APIs or databases
  • Creating reproducible test scenarios
  • Avoiding dependencies on live third-party services
  • Testing edge cases with specific response data
  • Ensuring consistent test results across multiple runs

​
How to Attach Mock Tool Data to Your Agent

​
Step 1: Create Mock Tool

Learn how to attach mock tool data to your agent. Provide Agent tool details with mock tool data:
  1. Navigate to Agent Settings
    • Go to the Cekura Dashboard
    • Select the agent for which you want to add mock tools
  2. Add Mock Tool Data
    • On the bottom of the right-hand side, click on Mock Tools
    • Click ”+ Add Tool” button to add mock tool data
    • For each tool you need to add:
      • Tool Name: Must be the same as mentioned in the agent description
      • Tool Description: Describe what the tool does
      • Input/Output Mock Data: Provide sample data to define the format for keys and values (this also serves as initial test data)
Mock Tools section in Agent Settings showing the interface for adding mock tool data
The tool name must exactly match what’s mentioned in your agent description. Any mismatch will result in the mock tool not being triggered during testing.

​
Example Mock Tool Configurations

[
  {
    "input": {"user_id": 1},
    "output": {
      "name": "John Doe",
      "age": 30,
      "email": "[email protected]",
      "status": "active"
    }
  },
  {
    "input": {"user_id": 2},
    "output": {
      "name": "Jane Smith",
      "age": 25,
      "email": "[email protected]",
      "status": "premium"
    }
  }
]

​
Step 2: Create New Evaluators

After setting up your mock tools, create evaluators to test your agent:
  1. Navigate to Evaluators Section
    • Go to the Evaluators tab in your Cekura dashboard
    • Click on “Create New Workflow Evaluator”

​
Step 3: Run the Evaluators

Execute your evaluators to test the agent with mock tools:
  1. Configure Mock Tool Endpoints
    • First, configure your agent with our mock tool endpoints instead of the actual tool URL on VAPI, Retell, or wherever you have your agent
    • Replace your production tool URLs with Cekura’s mock tool endpoints
    • Check the Mock Tool API documentation for more details on endpoint configuration
  2. Start Test Execution
    • Select the evaluators you created
    • Click “Run Evaluator” to start testing
    • Choose the number of test iterations if needed

​
API Reference

For programmatic access to mock tools: