Insights
Generate insights
Generates an insights report from the provided evaluation configuration.
Parâmetros do cabeçalho
Foundry-Features
enum
A feature flag opt-in required when using preview operations or modifying persisted preview resources.
Repeatability-Request-ID
string
Unique, client-generated identifier for ensuring request idempotency. Use the same ID for retries to prevent duplicate evaluations.
Repeatability-First-Sent
string
Timestamp indicating when this request was first initiated. Used in conjunction with repeatability-request-id for idempotency control.
Parâmetros de consultas
api-version
string
obrigatório
The API version to use for this operation.
Corpo do Pedido
Complete evaluation configuration including data source, evaluators, and result settings
id
string
obrigatório
The unique identifier for the insights report.
metadata
InsightsMetadata
obrigatório
Metadata about the insights.
createdAt
string
obrigatório
The timestamp when the insights were created.
completedAt
string
The timestamp when the insights were completed.
state
enum | string
obrigatório
Enum describing allowed operation states.
enum
displayName
string
obrigatório
User friendly display name for the insight.
request
EvaluationRunClusterInsight | AgentClusterInsight | EvaluationComparison
obrigatório
The request of the insights report.
EvaluationRunClusterInsight
EvaluationRunClusterInsightRequest
Insights on set of Evaluation Results
type
enum
obrigatório
The type of insights request.
evalId
string
obrigatório
Evaluation Id for the insights.
runIds
string[]
obrigatório
List of evaluation run IDs for the insights.
modelConfiguration
InsightModelConfiguration
Configuration of the model used in the insight generation.
modelDeploymentName
string
obrigatório
The model deployment to be evaluated. Accepts either the deployment name alone or with the connection name as '{connectionName}/<modelDeploymentName>'.
AgentClusterInsight
AgentClusterInsightRequest
Insights on set of Agent Evaluation Results
type
enum
obrigatório
The type of request.
agentName
string
obrigatório
Identifier for the agent.
modelConfiguration
InsightModelConfiguration
Configuration of the model used in the insight generation.
modelDeploymentName
string
obrigatório
The model deployment to be evaluated. Accepts either the deployment name alone or with the connection name as '{connectionName}/<modelDeploymentName>'.
EvaluationComparison
EvaluationComparisonInsightRequest
Evaluation Comparison Request
type
enum
obrigatório
The type of request.
evalId
string
obrigatório
Identifier for the evaluation.
baselineRunId
string
obrigatório
The baseline run ID for comparison.
treatmentRunIds
string[]
obrigatório
List of treatment run IDs for comparison.
result
EvaluationComparison | EvaluationRunClusterInsight | AgentClusterInsight
The result of the insights.
EvaluationComparison
EvaluationComparisonInsightResult
Insights from the evaluation comparison.
type
enum
obrigatório
The type of insights result.
comparisons
EvalRunResultComparison[]
obrigatório
Comparison results for each treatment run against the baseline.
method
string
obrigatório
The statistical method used for comparison.
EvaluationRunClusterInsight
EvaluationRunClusterInsightResult
Insights from the evaluation run cluster analysis.
type
enum
obrigatório
The type of insights result.
clusterInsight
ClusterInsightResult
obrigatório
Insights from the cluster analysis.
summary
InsightSummary
obrigatório
Summary of the error cluster analysis.
sampleCount
integer
obrigatório
Total number of samples analyzed.
uniqueSubclusterCount
integer
obrigatório
Total number of unique subcluster labels.
uniqueClusterCount
integer
obrigatório
Total number of unique clusters.
method
string
obrigatório
Method used for clustering.
usage
ClusterTokenUsage
obrigatório
Token usage for cluster analysis
inputTokenUsage
integer
obrigatório
input token usage
outputTokenUsage
integer
obrigatório
output token usage
totalTokenUsage
integer
obrigatório
total token usage
clusters
InsightCluster[]
obrigatório
List of clusters identified in the insights.
coordinates
object
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.
[key: string]
ChartCoordinate
Coordinates for the analysis chart.
x
integer
obrigatório
X-axis coordinate.
y
integer
obrigatório
Y-axis coordinate.
size
integer
obrigatório
Size of the chart element.
AgentClusterInsight
AgentClusterInsightResult
Insights from the agent cluster analysis.
type
enum
obrigatório
The type of insights result.
clusterInsight
ClusterInsightResult
obrigatório
Insights from the cluster analysis.
summary
InsightSummary
obrigatório
Summary of the error cluster analysis.
sampleCount
integer
obrigatório
Total number of samples analyzed.
uniqueSubclusterCount
integer
obrigatório
Total number of unique subcluster labels.
uniqueClusterCount
integer
obrigatório
Total number of unique clusters.
method
string
obrigatório
Method used for clustering.
usage
ClusterTokenUsage
obrigatório
Token usage for cluster analysis
inputTokenUsage
integer
obrigatório
input token usage
outputTokenUsage
integer
obrigatório
output token usage
totalTokenUsage
integer
obrigatório
total token usage
clusters
InsightCluster[]
obrigatório
List of clusters identified in the insights.
coordinates
object
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.
[key: string]
ChartCoordinate
Coordinates for the analysis chart.
x
integer
obrigatório
X-axis coordinate.
y
integer
obrigatório
Y-axis coordinate.
size
integer
obrigatório
Size of the chart element.
Respostas
The request has succeeded and a new resource has been created as a result.
Corpo
id
string
obrigatório
The unique identifier for the insights report.
metadata
InsightsMetadata
obrigatório
Metadata about the insights.
createdAt
string
obrigatório
The timestamp when the insights were created.
completedAt
string
The timestamp when the insights were completed.
state
enum | string
obrigatório
Enum describing allowed operation states.
enum
displayName
string
obrigatório
User friendly display name for the insight.
request
EvaluationRunClusterInsight | AgentClusterInsight | EvaluationComparison
obrigatório
The request of the insights report.
EvaluationRunClusterInsight
EvaluationRunClusterInsightRequest
Insights on set of Evaluation Results
type
enum
obrigatório
The type of insights request.
evalId
string
obrigatório
Evaluation Id for the insights.
runIds
string[]
obrigatório
List of evaluation run IDs for the insights.
modelConfiguration
InsightModelConfiguration
Configuration of the model used in the insight generation.
modelDeploymentName
string
obrigatório
The model deployment to be evaluated. Accepts either the deployment name alone or with the connection name as '{connectionName}/<modelDeploymentName>'.
AgentClusterInsight
AgentClusterInsightRequest
Insights on set of Agent Evaluation Results
type
enum
obrigatório
The type of request.
agentName
string
obrigatório
Identifier for the agent.
modelConfiguration
InsightModelConfiguration
Configuration of the model used in the insight generation.
modelDeploymentName
string
obrigatório
The model deployment to be evaluated. Accepts either the deployment name alone or with the connection name as '{connectionName}/<modelDeploymentName>'.
EvaluationComparison
EvaluationComparisonInsightRequest
Evaluation Comparison Request
type
enum
obrigatório
The type of request.
evalId
string
obrigatório
Identifier for the evaluation.
baselineRunId
string
obrigatório
The baseline run ID for comparison.
treatmentRunIds
string[]
obrigatório
List of treatment run IDs for comparison.
result
EvaluationComparison | EvaluationRunClusterInsight | AgentClusterInsight
The result of the insights.
EvaluationComparison
EvaluationComparisonInsightResult
Insights from the evaluation comparison.
type
enum
obrigatório
The type of insights result.
comparisons
EvalRunResultComparison[]
obrigatório
Comparison results for each treatment run against the baseline.
method
string
obrigatório
The statistical method used for comparison.
EvaluationRunClusterInsight
EvaluationRunClusterInsightResult
Insights from the evaluation run cluster analysis.
type
enum
obrigatório
The type of insights result.
clusterInsight
ClusterInsightResult
obrigatório
Insights from the cluster analysis.
summary
InsightSummary
obrigatório
Summary of the error cluster analysis.
sampleCount
integer
obrigatório
Total number of samples analyzed.
uniqueSubclusterCount
integer
obrigatório
Total number of unique subcluster labels.
uniqueClusterCount
integer
obrigatório
Total number of unique clusters.
method
string
obrigatório
Method used for clustering.
usage
ClusterTokenUsage
obrigatório
Token usage for cluster analysis
inputTokenUsage
integer
obrigatório
input token usage
outputTokenUsage
integer
obrigatório
output token usage
totalTokenUsage
integer
obrigatório
total token usage
clusters
InsightCluster[]
obrigatório
List of clusters identified in the insights.
coordinates
object
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.
[key: string]
ChartCoordinate
Coordinates for the analysis chart.
x
integer
obrigatório
X-axis coordinate.
y
integer
obrigatório
Y-axis coordinate.
size
integer
obrigatório
Size of the chart element.
AgentClusterInsight
AgentClusterInsightResult
Insights from the agent cluster analysis.
type
enum
obrigatório
The type of insights result.
clusterInsight
ClusterInsightResult
obrigatório
Insights from the cluster analysis.
summary
InsightSummary
obrigatório
Summary of the error cluster analysis.
sampleCount
integer
obrigatório
Total number of samples analyzed.
uniqueSubclusterCount
integer
obrigatório
Total number of unique subcluster labels.
uniqueClusterCount
integer
obrigatório
Total number of unique clusters.
method
string
obrigatório
Method used for clustering.
usage
ClusterTokenUsage
obrigatório
Token usage for cluster analysis
inputTokenUsage
integer
obrigatório
input token usage
outputTokenUsage
integer
obrigatório
output token usage
totalTokenUsage
integer
obrigatório
total token usage
clusters
InsightCluster[]
obrigatório
List of clusters identified in the insights.
coordinates
object
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.
[key: string]
ChartCoordinate
Coordinates for the analysis chart.
x
integer
obrigatório
X-axis coordinate.
y
integer
obrigatório
Y-axis coordinate.
size
integer
obrigatório
Size of the chart element.
Pedir
POST /insights HTTP/1.1Response
Status: 201
Content-Type: application/jsonStatus: 4XX
Content-Type: application/jsonStatus: 5XX
Content-Type: application/json