---
title: "POST /v1/{+parent}/evaluationSets:import"
method: POST
path: "/v1/{+parent}/evaluationSets:import"
tags: ["projects"]
---

# POST /v1/{+parent}/evaluationSets:import

`POST /v1/{+parent}/evaluationSets:import`

Imports an Evaluation Set.

## Path parameters

- `parent` string, required

## Request body

- GoogleCloudAiplatformV1ImportEvaluationSetRequest — Request message for EvaluationManagementService.ImportEvaluationSet.
  - `inlineSource` GoogleCloudAiplatformV1ImportEvaluationSetRequestInlineSource — Wrapper for inline data.
    - `importSchemaConfig` GoogleCloudAiplatformV1ImportEvaluationSetRequestImportSchemaConfig — Configuration for the input data format.
      - `dataFormatVersion` string — Optional. Version of the data format.
      - `dataFormat` 'DATA_FORMAT_UNSPECIFIED' | 'OTEL_PROTO' | 'OTEL_JSON' | 'JSONL' — Required. The format of the input data.
    - `content` string, byte — Required. The content of the inline data.
  - `cloudTraceSource` GoogleCloudAiplatformV1ImportEvaluationSetRequestCloudTraceSource — Source for loading traces directly from Cloud Trace.
    - `traceIds` string[] — Optional. Trace IDs to import.
    - `projectId` string — Required. Project ID for the Cloud Trace.
    - `sessionIds` string[] — Optional. Session IDs to import traces for. If both trace_ids and session_ids are specified, the union of the two will be imported.
  - `evaluationSet` GoogleCloudAiplatformV1EvaluationSet — EvaluationSet is a collection of related EvaluationItems that are evaluated together.
    - `agentConfigs` object — Optional. Static configurations for each agent associated with the items in this set. Key: `agent_id` (matches the `author` field in `events`). Value: The static configuration of the agent.
    - `metadata` unknown
    - `name` string — Identifier. The resource name of the EvaluationSet. Format: `projects/{project}/locations/{location}/evaluationSets/{evaluation_set}`
    - `displayName` string — Required. The display name of the EvaluationSet.
    - `evaluationItems` string[] — Required. The EvaluationItems that are part of this dataset.
    - `createTime` string, google-datetime — Output only. Timestamp when this item was created.
    - `updateTime` string, google-datetime — Output only. Timestamp when this item was last updated.
  - `gcsSource` GoogleCloudAiplatformV1ImportEvaluationSetRequestGcsSource — Source for loading data from Cloud Storage.
    - `gcsUri` string — Required. The Cloud Storage location of the input data.
    - `importSchemaConfig` GoogleCloudAiplatformV1ImportEvaluationSetRequestImportSchemaConfig — Configuration for the input data format.
      - `dataFormatVersion` string — Optional. Version of the data format.
      - `dataFormat` 'DATA_FORMAT_UNSPECIFIED' | 'OTEL_PROTO' | 'OTEL_JSON' | 'JSONL' — Required. The format of the input data.
  - `agentEngineSource` GoogleCloudAiplatformV1ImportEvaluationSetRequestAgentEngineSource — Source for loading Agent Engine sessions.
    - `projectId` string — Required. Project ID for the Agent Engine sessions.
    - `location` string — Required. Location for the Agent Engine sessions.
    - `sessionIds` string[] — Required. Session IDs for the Agent Engine sessions to retrieve.
    - `reasoningEngineId` string — Required. Reasoning Engine ID for the Agent Engine sessions.
  - `bigquerySource` GoogleCloudAiplatformV1BigQueryRequestSet — The request set for the evaluation run.
    - `candidateResponseColumns` object — Optional. Map of candidate name to candidate response column name. The column will be in evaluation_item.CandidateResponse format.
    - `samplingConfig` GoogleCloudAiplatformV1BigQueryRequestSetSamplingConfig — The sampling config.
      - `samplingCount` integer — Optional. The total number of logged data to import. If available data is less than the sampling count, all data will be imported. Default is 100.
      - `samplingMethod` 'SAMPLING_METHOD_UNSPECIFIED' | 'RANDOM' — Optional. The sampling method to use.
      - `samplingDuration` string, google-duration — Optional. How long to wait before sampling data from the BigQuery table. If not specified, defaults to 0.
    - `promptColumn` string — Optional. The name of the column that contains the requests to evaluate. This will be in evaluation_item.EvalPrompt format.
    - `rubricsColumn` string — Optional. The name of the column that contains the rubrics. This is in evaluation_rubric.RubricGroup format.
    - `uri` string — Required. The URI of a BigQuery table. e.g. bq://projectId.bqDatasetId.bqTableId
  - `gcsDestination` GoogleCloudAiplatformV1GcsDestination — The Google Cloud Storage location where the output is to be written to.
    - `outputUriPrefix` string — Required. Google Cloud Storage URI to output directory. If the uri doesn't end with '/', a '/' will be automatically appended. The directory is created if it doesn't exist.

## Response `200`

Successful response

---

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