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

# Execute agent-efficiency evaluator

`POST /v2/evaluators/agent-efficiency/execute`

Evaluate agent efficiency - detect redundant calls, unnecessary follow-ups

**Request Body:**
- `input.trajectory_prompts` (string, required): JSON array of prompts in the agent trajectory
- `input.trajectory_completions` (string, required): JSON array of completions in the agent trajectory

## Request body

- RequestAgentEfficiencyRequest
  - `input` RequestAgentEfficiencyInput, required
    - `trajectory_completions` string, required
    - `trajectory_prompts` string, required

## Response `200`

OK

- ResponseAgentEfficiencyResponse
  - `step_efficiency_reason` string
  - `step_efficiency_score` number
  - `task_completion_reason` string
  - `task_completion_score` number

## Other responses

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

## Changes

> 11 revisions in range; 1 could not be searched.

- **2026-04-12** `bd3e46b75d87` — 1 info
  - endpoint added
- **2026-01-01** `aef6c851927f` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/traceloop/apis/traceloop-api/changes/v2/evaluators/agent-efficiency/execute/post.md)

---

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