Add Evaluators | Humanloop Docs

curl -X POST https://api.humanloop.com/v5/evaluations/id/evaluators \
     -H "X-API-KEY: <apiKey>" \
     -H "Content-Type: application/json" \
     -d '{
  "evaluators": [
    {
      "version_id": "version_id"
    }
  ]
}'

{
  "id": "id",
  "runs_count": 1,
  "evaluators": [
    {
      "version": {
        "path": "path",
        "id": "id",
        "spec": {
          "arguments_type": "target_free",
          "return_type": "boolean",
          "evaluator_type": "llm"
        },
        "name": "name",
        "version_id": "version_id",
        "created_at": "2024-01-15T09:30:00Z",
        "updated_at": "2024-01-15T09:30:00Z",
        "last_used_at": "2024-01-15T09:30:00Z",
        "version_logs_count": 1,
        "total_logs_count": 1,
        "inputs": [
          {
            "name": "name"
          }
        ]
      },
      "orchestrated": true,
      "added_at": "2024-01-15T09:30:00Z"
    }
  ],
  "created_at": "2024-01-15T09:30:00Z",
  "updated_at": "2024-01-15T09:30:00Z",
  "name": "name",
  "file_id": "file_id",
  "created_by": {
    "id": "id",
    "email_address": "email_address",
    "full_name": "full_name"
  },
  "url": "url"
}

Add Evaluators to an Evaluation. The Evaluators will be run on the Logs generated for the Evaluation.

Authentication

X-API-KEYstring

API Key authentication via header

Path parameters

idstringRequired

Unique identifier for Evaluation.

Request

This endpoint expects an object.

evaluatorslist of objectsRequired

The Evaluators to add to this Evaluation.

Response

Successful Response

idstring

Unique identifier for the Evaluation. Starts with evr.

runs_countinteger

The total number of Runs in the Evaluation.

evaluatorslist of objects

The Evaluator Versions used to evaluate.

created_atdatetime

updated_atdatetime

namestringOptional

Name of the Evaluation to help identify it. Must be unique among Evaluations associated with File.

file_idstringOptional

Unique identifier for the File associated with the Evaluation.

created_byanyOptional

urlstringOptional

URL to view the Evaluation on the Humanloop.

Errors

422

Add Evaluators Evaluations ID Evaluators Post Request Unprocessable Entity Error