Get Golden

GEThttps://api.confident-ai.com/v1/datasets/{alias}/goldens/{goldenId}

Retrieves a single golden by its goldenId from the dataset identified by alias.

GET/v1/datasets/{alias}/goldens/{goldenId}

curl -X GET "https://api.confident-ai.com/v1/datasets/{alias}/goldens/{goldenId}" \
  -H "CONFIDENT_API_KEY: <PROJECT-API-KEY>"

200

{
  "success": true,
  "data": {
    "id": "GOLDEN-ID",
    "input": "How's the weather like in NYC?",
    "expectedOutput": "No idea"
  },
  "deprecated": false
}

Headers

CONFIDENT_API_KEYstringRequired
The API key of your Confident AI project.

Path parameters

aliasstringRequired
The alias of the dataset containing the golden.
goldenIdstringRequired
The unique id of the golden, returned when the dataset is pulled.

Response

successboolean
This is true if the golden was successfully retrieved.
dataobject | object
The retrieved golden.
Show 2 variantsHide 2 variants
- Goldenobject
  Show 13 propertiesHide 13 properties
  - idstring
    Server-assigned identifier, returned when the dataset is pulled. Use it to update or delete this golden. Not accepted when pushing.
  - inputstring
    This is the input to your LLM application.
  - actualOutputstring
    This is the actual output of your LLM application.
  - expectedOutputstring
    This is the expected output of your LLM application, which is the ideal actual output.
  - retrievalContextlist of strings
    This is the retrieval context of your LLM application.
  - contextlist of strings
    This is the ideal retrieval context of your LLM application.
  - toolsCalledlist of objects
    This is the tools called by your LLM application.
    Show 5 propertiesHide 5 properties
    namestring
    This is the name of the tool.
    descriptionstring
    This is the description of the tool.
    inputParametersobject
    This is the input parameters that are passed to the tool.
    outputstring
    This is the output of the tool.
    reasoningstring
    This is the reasoning your LLM provided for the tool call.
  - expectedToolslist of objects
    This is the expected tools to be called by the LLM application.
    Show 5 propertiesHide 5 properties
    namestring
    This is the name of the tool.
    descriptionstring
    This is the description of the tool.
    inputParametersobject
    This is the input parameters that are passed to the tool.
    outputstring
    This is the output of the tool.
    reasoningstring
    This is the reasoning your LLM provided for the tool call.
  - additionalMetadataobject
    This is any additional metadata you wish to associate with the golden.
  - commentsstring
    This is any comments you wish to associate with the golden.
  - sourceFilestring
    This is the source file from which the golden was retrieved.
  - finalizedboolean
    This determines whether the golden has been finalized.
  - customColumnKeyValuesobject
    Key-value pairs representing custom table column data for this golden. Keys correspond to the custom column keys defined in the dataset.
- OR
- ConversationalGoldenobject
  Show 11 propertiesHide 11 properties
  - idstring
    Server-assigned identifier, returned when the dataset is pulled. Use it to update or delete this golden. Not accepted when pushing.
  - scenariostring
    This is a description of the conversation context.
  - userDescriptionstring
    This is the description of the user in the conversation.
  - expectedOutcomestring
    This describes the expected outcome, or ideal conversation flow, of the conversation.
  - turnslist of objects
    This is the list of turns in the conversation.
    Show 5 propertiesHide 5 properties
    roleenum
    The role of the turn, either user or assistant.
    Show 2 enum valuesHide 2 enum values
    user
    assistant
    contentstring
    The message content of the turn.
    userIdstring
    The user ID associated with the turn.
    retrievalContextlist of strings
    The contexts retrieved to generate the LLM response for this turn.
    toolsCalledlist of objects
    The tools called to generate the LLM response for this turn.
    Show 5 propertiesHide 5 properties
    namestring
    This is the name of the tool.
    descriptionstring
    This is the description of the tool.
    inputParametersobject
    This is the input parameters that are passed to the tool.
    outputstring
    This is the output of the tool.
    reasoningstring
    This is the reasoning your LLM provided for the tool call.
  - contextlist of strings
    This is the context of the conversation.
  - additionalMetadataobject
    This is any additional metadata you wish to associate with the golden.
  - commentsstring
    This is any comments you wish to associate with the golden.
  - sourceFilestring
    This is the source file from which the golden was retrieved.
  - finalizedboolean
    This determines whether the golden has been finalized.
  - customColumnKeyValuesobject
    Key-value pairs representing custom table column data for this golden. Keys correspond to the custom column keys defined in the dataset.
deprecatedboolean
This is true if this datasets endpoint is deprecated.

Built byConfident AI