Generates an insights report from the provided evaluation configuration.

A feature flag opt-in required when using preview operations or modifying persisted preview resources.

Unique, client-generated identifier for ensuring request idempotency. Use the same ID for retries to prevent duplicate evaluations.

Timestamp indicating when this request was first initiated. Used in conjunction with repeatability-request-id for idempotency control.

The API version to use for this operation.

Complete evaluation configuration including data source, evaluators, and result settings

The unique identifier for the insights report.

Metadata about the insights.

The timestamp when the insights were created.

The timestamp when the insights were completed.

Enum describing allowed operation states.

User friendly display name for the insight.

The request of the insights report.

Insights on set of Evaluation Results

The type of insights request.

Evaluation Id for the insights.

List of evaluation run IDs for the insights.

Configuration of the model used in the insight generation.

The model deployment to be evaluated. Accepts either the deployment name alone or with the connection name as '{connectionName}/<modelDeploymentName>'.

Insights on set of Agent Evaluation Results

The type of request.

Identifier for the agent.

Configuration of the model used in the insight generation.

The model deployment to be evaluated. Accepts either the deployment name alone or with the connection name as '{connectionName}/<modelDeploymentName>'.

Evaluation Comparison Request

The type of request.

Identifier for the evaluation.

The baseline run ID for comparison.

List of treatment run IDs for comparison.

The result of the insights.

Insights from the evaluation comparison.

The type of insights result.

Comparison results for each treatment run against the baseline.

The statistical method used for comparison.

Insights from the evaluation run cluster analysis.

The type of insights result.

Insights from the cluster analysis.

Summary of the error cluster analysis.

Total number of samples analyzed.

Total number of unique subcluster labels.

Total number of unique clusters.

Method used for clustering.

Token usage for cluster analysis

input token usage

output token usage

total token usage

List of clusters identified in the insights.

Optional mapping of IDs to 2D coordinates used by the UX for visualization. The map keys are string identifiers (for example, a cluster id or a sample id) and the values are the coordinates and visual size for rendering on a 2D chart. This property is omitted unless the client requests coordinates (for example, by passing includeCoordinates=true as a query parameter). Example: { "cluster-1": { "x": 12, "y": 34, "size": 8 }, "sample-123": { "x": 18, "y": 22, "size": 4 } } Coordinates are intended only for client-side visualization and do not modify the canonical insights results.

Coordinates for the analysis chart.

X-axis coordinate.

Y-axis coordinate.

Size of the chart element.

Insights from the agent cluster analysis.

The type of insights result.

Insights from the cluster analysis.

Summary of the error cluster analysis.

Total number of samples analyzed.

Total number of unique subcluster labels.

Total number of unique clusters.

Method used for clustering.

Token usage for cluster analysis

input token usage

output token usage

total token usage

List of clusters identified in the insights.

Optional mapping of IDs to 2D coordinates used by the UX for visualization. The map keys are string identifiers (for example, a cluster id or a sample id) and the values are the coordinates and visual size for rendering on a 2D chart. This property is omitted unless the client requests coordinates (for example, by passing includeCoordinates=true as a query parameter). Example: { "cluster-1": { "x": 12, "y": 34, "size": 8 }, "sample-123": { "x": 18, "y": 22, "size": 4 } } Coordinates are intended only for client-side visualization and do not modify the canonical insights results.

Coordinates for the analysis chart.

X-axis coordinate.

Y-axis coordinate.

Size of the chart element.

The unique identifier for the insights report.

Metadata about the insights.

The timestamp when the insights were created.

The timestamp when the insights were completed.

Enum describing allowed operation states.

User friendly display name for the insight.

The request of the insights report.

Insights on set of Evaluation Results

The type of insights request.

Evaluation Id for the insights.

List of evaluation run IDs for the insights.

Configuration of the model used in the insight generation.

The model deployment to be evaluated. Accepts either the deployment name alone or with the connection name as '{connectionName}/<modelDeploymentName>'.

Insights on set of Agent Evaluation Results

The type of request.

Identifier for the agent.

Configuration of the model used in the insight generation.

The model deployment to be evaluated. Accepts either the deployment name alone or with the connection name as '{connectionName}/<modelDeploymentName>'.

Evaluation Comparison Request

The type of request.

Identifier for the evaluation.

The baseline run ID for comparison.

List of treatment run IDs for comparison.

The result of the insights.

Insights from the evaluation comparison.

The type of insights result.

Comparison results for each treatment run against the baseline.

The statistical method used for comparison.

Insights from the evaluation run cluster analysis.

The type of insights result.

Insights from the cluster analysis.

Summary of the error cluster analysis.

Total number of samples analyzed.

Total number of unique subcluster labels.

Total number of unique clusters.

Method used for clustering.

Token usage for cluster analysis

input token usage

output token usage

total token usage

List of clusters identified in the insights.

Optional mapping of IDs to 2D coordinates used by the UX for visualization. The map keys are string identifiers (for example, a cluster id or a sample id) and the values are the coordinates and visual size for rendering on a 2D chart. This property is omitted unless the client requests coordinates (for example, by passing includeCoordinates=true as a query parameter). Example: { "cluster-1": { "x": 12, "y": 34, "size": 8 }, "sample-123": { "x": 18, "y": 22, "size": 4 } } Coordinates are intended only for client-side visualization and do not modify the canonical insights results.

Coordinates for the analysis chart.

X-axis coordinate.

Y-axis coordinate.

Size of the chart element.

Insights from the agent cluster analysis.

The type of insights result.

Insights from the cluster analysis.

Summary of the error cluster analysis.

Total number of samples analyzed.

Total number of unique subcluster labels.

Total number of unique clusters.

Method used for clustering.

Token usage for cluster analysis

input token usage

output token usage

total token usage

List of clusters identified in the insights.

Optional mapping of IDs to 2D coordinates used by the UX for visualization. The map keys are string identifiers (for example, a cluster id or a sample id) and the values are the coordinates and visual size for rendering on a 2D chart. This property is omitted unless the client requests coordinates (for example, by passing includeCoordinates=true as a query parameter). Example: { "cluster-1": { "x": 12, "y": 34, "size": 8 }, "sample-123": { "x": 18, "y": 22, "size": 4 } } Coordinates are intended only for client-side visualization and do not modify the canonical insights results.

Coordinates for the analysis chart.

X-axis coordinate.

Y-axis coordinate.

Size of the chart element.

The public explanation for this block.

The public continuation instruction.

The public explanation for this block.

The public continuation instruction.