Upload Agent Evaluation Dataset (CSV/Excel)

POST

/api/v2/agents/{agent_id}/evaluation-datasets/upload

Upload a CSV or Excel file to create a new evaluation dataset and link it to the agent.

Supported file types: .csv, .xlsx, .xls

Required columns:

query — the question or prompt to evaluate

response — the expected (ground truth) answer

Optional columns:

data_points — supporting context or reference documents for the answer

Rows with a missing query or response are automatically skipped.
A parse_report in the response details how many rows were imported and which were skipped.

Staging behaviour:

Pass agent_version=staging as a query parameter to link the new
dataset to the staging version of the agent.

Current Version:

2.0.0

Request

Path Params

Header Params

Body Params multipart/form-dataRequired

Responses

🟢201

application/json

Dataset created successfully from uploaded file

Bodyapplication/json

🟠400

🟠404

🔴500

Request Example

Shell

JavaScript

Java

Swift

curl --location --globoff 'https:///api/v2/agents//evaluation-datasets/upload' \
--header 'Ocp-Apim-Subscription-Key: ' \
--header 'Authorization: Bearer ' \
--form 'file=@""' \
--form 'name=""' \
--form 'description=""' \
--form 'tags=""' \
--form 'metadata=""'

Response Example

201 - Example 1

{
    "message": "string",
    "success": true,
    "data": {
        "bridge_id": 0,
        "agent_id": 0,
        "id": 0,
        "public_id": "eb3ce6c7-ce7e-4638-a072-e5054706f601",
        "name": "string",
        "description": "string",
        "created_on": "2019-08-24T14:15:22.123Z",
        "created_by": "string",
        "query_count": 0,
        "parse_report": {
            "total_rows": 0,
            "valid_rows": 0,
            "skipped_rows": 0,
            "skipped": [
                {
                    "row": 0,
                    "reason": "string"
                }
            ],
            "columns_detected": {
                "question": "string",
                "answer": "string",
                "data_points": "string",
                "query_type": "string",
                "external_chatlog_id": "string"
            }
        }
    }
}

Delete Agent Evaluation Dataset

List Agent Evaluation Runs