> ## Documentation Index > Fetch the complete documentation index at: https://docs.decimal.ai/llms.txt > Use this file to discover all available pages before exploring further. # Get full eval breakdown with provenance > Get the full eval breakdown for a trace, grouped by source. Shows every score with its provenance (source label, icon, badge color), grouped into SourceGroups for the frontend to render section-by-section. Includes decision reasons explaining how the final verdict was determined. ## OpenAPI ````yaml /openapi.json get /api/v1/traces/{trace_id}/eval-breakdown openapi: 3.1.0 info: title: DecimalAI Platform description: Agent Dataset Lifecycle Platform — Backend API version: 0.1.0 servers: [] security: - BearerAuth: [] tags: - name: traces description: >- Ingest, search, and inspect agent execution traces. A trace is the atomic unit of the platform — every other feature (evaluation, compatibility scoring, dataset building) operates on traces. Each trace is auto-tagged with the manifest hash of the agent that produced it. - name: eval-scores description: >- Push, fetch, and aggregate per-trace evaluation scores. Scores carry source provenance (built-in, DeepEval, LangSmith, custom) and feed the unified decision engine, which produces a keep / repair / replay / drop verdict per trace. - name: skills description: >- Manage reusable instruction blocks (SKILL.md files) that modify agent behavior. Skills are first-class manifest components — changes to a skill appear in your regression-check impact reports. Use these endpoints to create, version, fork, and sync skills with your local SKILL.md files. - name: manifests description: >- Register and inspect manifest versions. A manifest is a snapshot of your agent's structural identity (tools, prompts, models, skills) at a point in time. The SDK registers manifests automatically; these endpoints expose the underlying records. - name: datasets description: >- Build versioned SFT/DPO training datasets from manifest-classified, eval-scored traces. Datasets are reproducible — each version locks the manifest and filter set used to build it. Export as JSONL, Parquet, or push to HuggingFace Hub. - name: replay description: >- Re-execute historical traces against a new manifest version. Replay is the deferred-future capability for behavioral verification of agent changes. The SDK creates a replay batch, your worker executes each task, then submits results back here for eval scoring. - name: registry description: >- Browse and install community skills from the public skills registry. Each registry skill carries a SkillScore — an evidence-tiered quality composite computed from real-world evals, benchmarks, and ratings across organizations. Installing creates a fork in your org — edits don't affect the public version. - name: agents description: >- List and inspect agents, plus their multi-agent topology (orchestrator → sub-agent edges discovered from traces). Agents are identified by a stable agent_name string set in your SDK init() call. - name: import description: >- Bulk-import historical traces from another observability platform or a JSONL backup. Useful for migrating from LangSmith / Braintrust / Langfuse. Duplicate trace IDs are silently skipped — re-running an import is safe. paths: /api/v1/traces/{trace_id}/eval-breakdown: get: tags: - eval-scores summary: Get full eval breakdown with provenance description: >- Get the full eval breakdown for a trace, grouped by source. Shows every score with its provenance (source label, icon, badge color), grouped into SourceGroups for the frontend to render section-by-section. Includes decision reasons explaining how the final verdict was determined. operationId: get_eval_breakdown_api_v1_traces__trace_id__eval_breakdown_get parameters: - name: trace_id in: path required: true schema: type: string title: Trace Id - name: Authorization in: header required: false schema: type: string title: Authorization - name: decimal_session in: cookie required: false schema: anyOf: - type: string - type: 'null' title: Decimal Session responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/EvalBreakdownResponse' '400': description: Malformed trace_id (not a UUID). '404': description: Trace not found. '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' x-codeSamples: - lang: Python label: Python SDK source: |- import decimalai # get_eval_breakdown is a top-level SDK function. breakdown = decimalai.get_eval_breakdown( api_key="dai_sk_...", trace_id="trc_abc123", ) for group in breakdown["source_groups"]: print(group["source_label"], group["source_avg"]) components: schemas: EvalBreakdownResponse: properties: trace_id: type: string title: Trace Id eval_verdict: anyOf: - type: string - type: 'null' title: Eval Verdict quality_avg: type: number title: Quality Avg compat_avg: type: number title: Compat Avg quality_scores: items: $ref: '#/components/schemas/ScoreResponse' type: array title: Quality Scores compat_scores: items: $ref: '#/components/schemas/ScoreResponse' type: array title: Compat Scores source_groups: items: $ref: '#/components/schemas/SourceGroup' type: array title: Source Groups decision_reasons: items: type: string type: array title: Decision Reasons type: object required: - trace_id - quality_avg - compat_avg - quality_scores - compat_scores - source_groups - decision_reasons title: EvalBreakdownResponse description: Full eval breakdown with provenance, for trace detail page. HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError ScoreResponse: properties: id: type: string title: Id name: type: string title: Name score: type: number title: Score passed: type: boolean title: Passed reason: anyOf: - type: string - type: 'null' title: Reason source: type: string title: Source source_label: type: string title: Source Label default: '' icon: type: string title: Icon default: '' badge_color: type: string title: Badge Color default: '' category: type: string title: Category change_type: anyOf: - type: string - type: 'null' title: Change Type field_changes: anyOf: - additionalProperties: true type: object - type: 'null' title: Field Changes type: object required: - id - name - score - passed - source - category title: ScoreResponse description: A single stored score in the response, with provenance. SourceGroup: properties: source: type: string title: Source source_label: type: string title: Source Label icon: type: string title: Icon badge_color: type: string title: Badge Color category: type: string title: Category scores: items: $ref: '#/components/schemas/ScoreResponse' type: array title: Scores source_avg: type: number title: Source Avg type: object required: - source - source_label - icon - badge_color - category - scores - source_avg title: SourceGroup description: Scores grouped by source for display. ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array title: Location msg: type: string title: Message type: type: string title: Error Type input: title: Input ctx: type: object title: Context type: object required: - loc - msg - type title: ValidationError securitySchemes: BearerAuth: type: http scheme: bearer description: Enter your API key (e.g. dai_sk_test_key_001) ````