---
title: "Execute agent-tool-trajectory evaluator"
method: POST
path: "/v2/evaluators/agent-tool-trajectory/execute"
tags: ["evaluators"]
---

# Execute agent-tool-trajectory evaluator

`POST /v2/evaluators/agent-tool-trajectory/execute`

Compare actual tool calls against expected reference tool calls

**Request Body:**
- `input.executed_tool_calls` (string, required): JSON array of actual tool calls made by the agent
- `input.expected_tool_calls` (string, required): JSON array of expected/reference tool calls
- `config.threshold` (float, optional): Score threshold for pass/fail determination (default: 0.5)
- `config.mismatch_sensitive` (bool, optional): Whether tool calls must match exactly (default: false)
- `config.order_sensitive` (bool, optional): Whether order of tool calls matters (default: false)
- `config.input_params_sensitive` (bool, optional): Whether to compare input parameters (default: true)

## Request body

- RequestAgentToolTrajectoryRequest
  - `config` RequestAgentToolTrajectoryConfigRequest
    - `input_params_sensitive` boolean
    - `mismatch_sensitive` boolean
    - `order_sensitive` boolean
    - `threshold` number
  - `input` RequestAgentToolTrajectoryInput, required
    - `executed_tool_calls` string, required
    - `expected_tool_calls` string, required

## Response `200`

OK

- ResponseAgentToolTrajectoryResponse
  - `reason` string
  - `score` number
  - `success` boolean

## Other responses

- `400` — Bad Request
- `500` — Internal Server Error

---

[API](https://skmtc.net/traceloop/apis/traceloop-api.md) · [All operations](https://skmtc.net/traceloop/apis/traceloop-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/traceloop/traceloop-api/versions/9c12a04a5947/schema)
