Create an annotation queue. The name and project_id fields are required.
An optional annotation_schema can be provided to define the labels for the queue.
Fields such as created_by, owned_by, created_at, modified_by,
and modified_at are inferred by the backend.
Data object for creating an LLM Observability annotation queue.
attributes [required]
object
Attributes for creating an LLM Observability annotation queue.
annotation_schema
object
Schema defining the labels for an annotation queue.
label_schemas [required]
[object]
List of label schema definitions.
description
string
Description of the label.
has_assessment
boolean
Whether this label includes an assessment field.
has_reasoning
boolean
Whether this label includes a reasoning field.
id
string
Unique identifier of the label schema. Assigned by the server if not provided.
is_assessment
boolean
Whether the boolean label represents an assessment. Requires has_assessment to be true.
is_integer
boolean
Whether score values must be integers. Applicable to score-type labels.
is_required
boolean
Whether this label is required for an annotation.
max
double
Maximum value for score-type labels.
min
double
Minimum value for score-type labels.
name [required]
string
Name of the label. Must match the pattern ^[a-zA-Z0-9_-]+$ and be unique within the queue.
type [required]
enum
Type of a label in an annotation queue label schema.
Allowed enum values: score,categorical,boolean,text
values
[string]
Allowed values for categorical-type labels. Must contain at least one non-empty, unique value.
description
string
Description of the annotation queue.
name [required]
string
Name of the annotation queue.
project_id [required]
string
Identifier of the project this queue belongs to.
type [required]
enum
Resource type of an LLM Observability annotation queue.
Allowed enum values: queues
{"data":{"attributes":{"annotation_schema":{"label_schemas":[{"description":"Rating of the response quality.","has_assessment":false,"has_reasoning":false,"id":"abc-123","is_assessment":false,"is_integer":false,"is_required":true,"max":5,"min":0,"name":"quality","type":"score","values":["good","bad","neutral"]}]},"description":"Queue for annotating customer support traces","name":"My annotation queue","project_id":"00000000-0000-0000-0000-000000000002"},"type":"queues"}}
Response containing a single LLM Observability annotation queue.
Expand All
フィールド
種類
説明
data [required]
object
Data object for an LLM Observability annotation queue.
attributes [required]
object
Attributes of an LLM Observability annotation queue.
annotation_schema
object
Schema defining the labels for an annotation queue.
label_schemas [required]
[object]
List of label schema definitions.
description
string
Description of the label.
has_assessment
boolean
Whether this label includes an assessment field.
has_reasoning
boolean
Whether this label includes a reasoning field.
id
string
Unique identifier of the label schema. Assigned by the server if not provided.
is_assessment
boolean
Whether the boolean label represents an assessment. Requires has_assessment to be true.
is_integer
boolean
Whether score values must be integers. Applicable to score-type labels.
is_required
boolean
Whether this label is required for an annotation.
max
double
Maximum value for score-type labels.
min
double
Minimum value for score-type labels.
name [required]
string
Name of the label. Must match the pattern ^[a-zA-Z0-9_-]+$ and be unique within the queue.
type [required]
enum
Type of a label in an annotation queue label schema.
Allowed enum values: score,categorical,boolean,text
values
[string]
Allowed values for categorical-type labels. Must contain at least one non-empty, unique value.
created_at [required]
date-time
Timestamp when the queue was created.
created_by [required]
string
Identifier of the user who created the queue.
description [required]
string
Description of the annotation queue.
modified_at [required]
date-time
Timestamp when the queue was last modified.
modified_by [required]
string
Identifier of the user who last modified the queue.
name [required]
string
Name of the annotation queue.
owned_by [required]
string
Identifier of the user who owns the queue.
project_id [required]
string
Identifier of the project this queue belongs to.
id [required]
string
Unique identifier of the annotation queue.
type [required]
enum
Resource type of an LLM Observability annotation queue.
Allowed enum values: queues
{"data":{"attributes":{"annotation_schema":{"label_schemas":[{"description":"Rating of the response quality.","has_assessment":false,"has_reasoning":false,"id":"abc-123","is_assessment":false,"is_integer":false,"is_required":true,"max":5,"min":0,"name":"quality","type":"score","values":["good","bad","neutral"]}]},"created_at":"2024-01-15T10:30:00Z","created_by":"00000000-0000-0000-0000-000000000002","description":"Queue for annotating customer support traces","modified_at":"2024-01-15T10:30:00Z","modified_by":"00000000-0000-0000-0000-000000000002","name":"My annotation queue","owned_by":"00000000-0000-0000-0000-000000000002","project_id":"00000000-0000-0000-0000-000000000002"},"id":"00000000-0000-0000-0000-000000000001","type":"queues"}}
"""
Create an LLM Observability annotation queue returns "Created" response
"""fromdatadog_api_clientimportApiClient,Configurationfromdatadog_api_client.v2.api.llm_observability_apiimportLLMObservabilityApifromdatadog_api_client.v2.model.llm_obs_annotation_queue_data_attributes_requestimport(LLMObsAnnotationQueueDataAttributesRequest,)fromdatadog_api_client.v2.model.llm_obs_annotation_queue_data_requestimportLLMObsAnnotationQueueDataRequestfromdatadog_api_client.v2.model.llm_obs_annotation_queue_requestimportLLMObsAnnotationQueueRequestfromdatadog_api_client.v2.model.llm_obs_annotation_queue_typeimportLLMObsAnnotationQueueTypefromdatadog_api_client.v2.model.llm_obs_annotation_schemaimportLLMObsAnnotationSchemafromdatadog_api_client.v2.model.llm_obs_label_schemaimportLLMObsLabelSchemafromdatadog_api_client.v2.model.llm_obs_label_schema_typeimportLLMObsLabelSchemaTypebody=LLMObsAnnotationQueueRequest(data=LLMObsAnnotationQueueDataRequest(attributes=LLMObsAnnotationQueueDataAttributesRequest(annotation_schema=LLMObsAnnotationSchema(label_schemas=[LLMObsLabelSchema(description="Rating of the response quality.",has_assessment=False,has_reasoning=False,id="abc-123",is_assessment=False,is_integer=False,is_required=True,max=5.0,min=0.0,name="quality",type=LLMObsLabelSchemaType.SCORE,values=["good","bad","neutral",],),],),description="Queue for annotating customer support traces",name="My annotation queue",project_id="00000000-0000-0000-0000-000000000002",),type=LLMObsAnnotationQueueType.QUEUES,),)configuration=Configuration()configuration.unstable_operations["create_llm_obs_annotation_queue"]=TruewithApiClient(configuration)asapi_client:api_instance=LLMObservabilityApi(api_client)response=api_instance.create_llm_obs_annotation_queue(body=body)print(response)
# Create an LLM Observability annotation queue returns "Created" responserequire"datadog_api_client"DatadogAPIClient.configuredo|config|config.unstable_operations["v2.create_llm_obs_annotation_queue".to_sym]=trueendapi_instance=DatadogAPIClient::V2::LLMObservabilityAPI.newbody=DatadogAPIClient::V2::LLMObsAnnotationQueueRequest.new({data:DatadogAPIClient::V2::LLMObsAnnotationQueueDataRequest.new({attributes:DatadogAPIClient::V2::LLMObsAnnotationQueueDataAttributesRequest.new({annotation_schema:DatadogAPIClient::V2::LLMObsAnnotationSchema.new({label_schemas:[DatadogAPIClient::V2::LLMObsLabelSchema.new({description:"Rating of the response quality.",has_assessment:false,has_reasoning:false,id:"abc-123",is_assessment:false,is_integer:false,is_required:true,max:5.0,min:0.0,name:"quality",type:DatadogAPIClient::V2::LLMObsLabelSchemaType::SCORE,values:["good","bad","neutral",],}),],}),description:"Queue for annotating customer support traces",name:"My annotation queue",project_id:"00000000-0000-0000-0000-000000000002",}),type:DatadogAPIClient::V2::LLMObsAnnotationQueueType::QUEUES,}),})papi_instance.create_llm_obs_annotation_queue(body)
// Create an LLM Observability annotation queue returns "Created" responsepackagemainimport("context""encoding/json""fmt""os""github.com/DataDog/datadog-api-client-go/v2/api/datadog""github.com/DataDog/datadog-api-client-go/v2/api/datadogV2")funcmain(){body:=datadogV2.LLMObsAnnotationQueueRequest{Data:datadogV2.LLMObsAnnotationQueueDataRequest{Attributes:datadogV2.LLMObsAnnotationQueueDataAttributesRequest{AnnotationSchema:&datadogV2.LLMObsAnnotationSchema{LabelSchemas:[]datadogV2.LLMObsLabelSchema{{Description:datadog.PtrString("Rating of the response quality."),HasAssessment:datadog.PtrBool(false),HasReasoning:datadog.PtrBool(false),Id:datadog.PtrString("abc-123"),IsAssessment:datadog.PtrBool(false),IsInteger:datadog.PtrBool(false),IsRequired:datadog.PtrBool(true),Max:datadog.PtrFloat64(5.0),Min:datadog.PtrFloat64(0.0),Name:"quality",Type:datadogV2.LLMOBSLABELSCHEMATYPE_SCORE,Values:[]string{"good","bad","neutral",},},},},Description:datadog.PtrString("Queue for annotating customer support traces"),Name:"My annotation queue",ProjectId:"00000000-0000-0000-0000-000000000002",},Type:datadogV2.LLMOBSANNOTATIONQUEUETYPE_QUEUES,},}ctx:=datadog.NewDefaultContext(context.Background())configuration:=datadog.NewConfiguration()configuration.SetUnstableOperationEnabled("v2.CreateLLMObsAnnotationQueue",true)apiClient:=datadog.NewAPIClient(configuration)api:=datadogV2.NewLLMObservabilityApi(apiClient)resp,r,err:=api.CreateLLMObsAnnotationQueue(ctx,body)iferr!=nil{fmt.Fprintf(os.Stderr,"Error when calling `LLMObservabilityApi.CreateLLMObsAnnotationQueue`: %v\n",err)fmt.Fprintf(os.Stderr,"Full HTTP response: %v\n",r)}responseContent,_:=json.MarshalIndent(resp,""," ")fmt.Fprintf(os.Stdout,"Response from `LLMObservabilityApi.CreateLLMObsAnnotationQueue`:\n%s\n",responseContent)}
// Create an LLM Observability annotation queue returns "Created" responseimportcom.datadog.api.client.ApiClient;importcom.datadog.api.client.ApiException;importcom.datadog.api.client.v2.api.LlmObservabilityApi;importcom.datadog.api.client.v2.model.LLMObsAnnotationQueueDataAttributesRequest;importcom.datadog.api.client.v2.model.LLMObsAnnotationQueueDataRequest;importcom.datadog.api.client.v2.model.LLMObsAnnotationQueueRequest;importcom.datadog.api.client.v2.model.LLMObsAnnotationQueueResponse;importcom.datadog.api.client.v2.model.LLMObsAnnotationQueueType;importcom.datadog.api.client.v2.model.LLMObsAnnotationSchema;importcom.datadog.api.client.v2.model.LLMObsLabelSchema;importcom.datadog.api.client.v2.model.LLMObsLabelSchemaType;importjava.util.Arrays;importjava.util.Collections;publicclassExample{publicstaticvoidmain(String[]args){ApiClientdefaultClient=ApiClient.getDefaultApiClient();defaultClient.setUnstableOperationEnabled("v2.createLLMObsAnnotationQueue",true);LlmObservabilityApiapiInstance=newLlmObservabilityApi(defaultClient);LLMObsAnnotationQueueRequestbody=newLLMObsAnnotationQueueRequest().data(newLLMObsAnnotationQueueDataRequest().attributes(newLLMObsAnnotationQueueDataAttributesRequest().annotationSchema(newLLMObsAnnotationSchema().labelSchemas(Collections.singletonList(newLLMObsLabelSchema().description("Rating of the response quality.").hasAssessment(false).hasReasoning(false).id("abc-123").isAssessment(false).isInteger(false).isRequired(true).max(5.0).name("quality").type(LLMObsLabelSchemaType.SCORE).values(Arrays.asList("good","bad","neutral"))))).description("Queue for annotating customer support traces").name("My annotation queue").projectId("00000000-0000-0000-0000-000000000002")).type(LLMObsAnnotationQueueType.QUEUES));try{LLMObsAnnotationQueueResponseresult=apiInstance.createLLMObsAnnotationQueue(body);System.out.println(result);}catch(ApiExceptione){System.err.println("Exception when calling LlmObservabilityApi#createLLMObsAnnotationQueue");System.err.println("Status code: "+e.getCode());System.err.println("Reason: "+e.getResponseBody());System.err.println("Response headers: "+e.getResponseHeaders());e.printStackTrace();}}}
// Create an LLM Observability annotation queue returns "Created" response
usedatadog_api_client::datadog;usedatadog_api_client::datadogV2::api_llm_observability::LLMObservabilityAPI;usedatadog_api_client::datadogV2::model::LLMObsAnnotationQueueDataAttributesRequest;usedatadog_api_client::datadogV2::model::LLMObsAnnotationQueueDataRequest;usedatadog_api_client::datadogV2::model::LLMObsAnnotationQueueRequest;usedatadog_api_client::datadogV2::model::LLMObsAnnotationQueueType;usedatadog_api_client::datadogV2::model::LLMObsAnnotationSchema;usedatadog_api_client::datadogV2::model::LLMObsLabelSchema;usedatadog_api_client::datadogV2::model::LLMObsLabelSchemaType;#[tokio::main]asyncfnmain(){letbody=LLMObsAnnotationQueueRequest::new(LLMObsAnnotationQueueDataRequest::new(LLMObsAnnotationQueueDataAttributesRequest::new("My annotation queue".to_string(),"00000000-0000-0000-0000-000000000002".to_string(),).annotation_schema(LLMObsAnnotationSchema::new(vec![LLMObsLabelSchema::new("quality".to_string(),LLMObsLabelSchemaType::SCORE,).description("Rating of the response quality.".to_string()).has_assessment(false).has_reasoning(false).id("abc-123".to_string()).is_assessment(false).is_integer(false).is_required(true).max(5.0asf64).min(0.0asf64).values(vec!["good".to_string(),"bad".to_string(),"neutral".to_string(),])])).description("Queue for annotating customer support traces".to_string()),LLMObsAnnotationQueueType::QUEUES,));letmutconfiguration=datadog::Configuration::new();configuration.set_unstable_operation_enabled("v2.CreateLLMObsAnnotationQueue",true);letapi=LLMObservabilityAPI::with_config(configuration);letresp=api.create_llm_obs_annotation_queue(body).await;ifletOk(value)=resp{println!("{:#?}",value);}else{println!("{:#?}",resp.unwrap_err());}}
DD_SITE="datadoghq.comus3.datadoghq.comus5.datadoghq.comdatadoghq.euap1.datadoghq.comap2.datadoghq.comuk1.datadoghq.comddog-gov.comus2.ddog-gov.com"DD_API_KEY="<DD_API_KEY>"DD_APP_KEY="<DD_APP_KEY>"cargo run
/**
* Create an LLM Observability annotation queue returns "Created" response
*/import{client,v2}from"@datadog/datadog-api-client";constconfiguration=client.createConfiguration();configuration.unstableOperations["v2.createLLMObsAnnotationQueue"]=true;constapiInstance=newv2.LLMObservabilityApi(configuration);constparams: v2.LLMObservabilityApiCreateLLMObsAnnotationQueueRequest={body:{data:{attributes:{annotationSchema:{labelSchemas:[{description:"Rating of the response quality.",hasAssessment: false,hasReasoning: false,id:"abc-123",isAssessment: false,isInteger: false,isRequired: true,max: 5.0,min: 0.0,name:"quality",type:"score",values:["good","bad","neutral"],},],},description:"Queue for annotating customer support traces",name:"My annotation queue",projectId:"00000000-0000-0000-0000-000000000002",},type:"queues",},},};apiInstance.createLLMObsAnnotationQueue(params).then((data: v2.LLMObsAnnotationQueueResponse)=>{console.log("API called successfully. Returned data: "+JSON.stringify(data));}).catch((error: any)=>console.error(error));