diff --git a/hugo/content/en/api/v2/agent-observability/examples.json b/hugo/content/en/api/v2/agent-observability/examples.json index b02c95ba41ca..0f9ff4365e1d 100644 --- a/hugo/content/en/api/v2/agent-observability/examples.json +++ b/hugo/content/en/api/v2/agent-observability/examples.json @@ -96,7 +96,7 @@ } ] }, - "html": "
\n
\n
\n
\n

data [required]

\n
\n

[object]

\n

List of custom evaluator configuration data objects.

\n
\n
\n
\n
\n
\n

attributes [required]

\n
\n

object

\n

Attributes of a custom Agent Observability evaluator configuration.

\n
\n
\n
\n
\n
\n

category

\n
\n

string

\n

Category of the evaluator.

\n
\n \n
\n
\n
\n
\n
\n

created_at [required]

\n
\n

date-time

\n

Timestamp when the evaluator configuration was created.

\n
\n \n
\n
\n
\n
\n
\n

created_by

\n
\n

object

\n

A Datadog user associated with a custom evaluator configuration.

\n
\n
\n
\n
\n
\n

email

\n
\n

string

\n

Email address of the user.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n

eval_name [required]

\n
\n

string

\n

Name of the custom evaluator.

\n
\n \n
\n
\n
\n
\n
\n

last_updated_by

\n
\n

object

\n

A Datadog user associated with a custom evaluator configuration.

\n
\n
\n
\n
\n
\n

email

\n
\n

string

\n

Email address of the user.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n

llm_judge_config

\n
\n

object

\n

LLM judge configuration for a custom evaluator.

\n
\n
\n
\n
\n
\n

assessment_criteria

\n
\n

object

\n

Criteria used to assess the pass/fail result of a custom evaluator.

\n
\n
\n
\n
\n
\n

max_threshold

\n
\n

double

\n

Maximum numeric threshold for a passing result.

\n
\n \n
\n
\n
\n
\n
\n

min_threshold

\n
\n

double

\n

Minimum numeric threshold for a passing result.

\n
\n \n
\n
\n
\n
\n
\n

pass_values

\n
\n

[string]

\n

Specific output values considered as a passing result.

\n
\n \n
\n
\n
\n
\n
\n

pass_when

\n
\n

boolean

\n

When true, a boolean output of true is treated as passing.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n

context_query

\n
\n

string

\n

Query used to extract additional context for the evaluation.

\n
\n \n
\n
\n
\n
\n
\n

inference_params [required]

\n
\n

object

\n

LLM inference parameters for a custom evaluator.

\n
\n
\n
\n
\n
\n

frequency_penalty

\n
\n

double

\n

Frequency penalty to reduce repetition.

\n
\n \n
\n
\n
\n
\n
\n

max_tokens

\n
\n

int64

\n

Maximum number of tokens to generate.

\n
\n \n
\n
\n
\n
\n
\n

presence_penalty

\n
\n

double

\n

Presence penalty to reduce repetition.

\n
\n \n
\n
\n
\n
\n
\n

temperature

\n
\n

double

\n

Sampling temperature for the LLM.

\n
\n \n
\n
\n
\n
\n
\n

top_k

\n
\n

int64

\n

Top-k sampling parameter.

\n
\n \n
\n
\n
\n
\n
\n

top_p

\n
\n

double

\n

Top-p (nucleus) sampling parameter.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n

last_used_library_prompt_template_name

\n
\n

string

\n

Name of the last library prompt template used.

\n
\n \n
\n
\n
\n
\n
\n

modified_library_prompt_template

\n
\n

boolean

\n

Whether the library prompt template was modified.

\n
\n \n
\n
\n
\n
\n
\n

output_schema

\n
\n

object

\n

JSON schema describing the expected output format of the LLM judge.

\n
\n \n
\n
\n
\n
\n
\n

parsing_type

\n
\n

enum

\n

Output parsing type for a custom LLM judge evaluator. \nAllowed enum values: structured_output,json,keyword_search

\n
\n \n
\n
\n
\n
\n
\n

prompt_template

\n
\n

[object]

\n

List of messages forming the LLM judge prompt template.

\n
\n
\n
\n
\n
\n

content

\n
\n

string

\n

Text content of the message.

\n
\n \n
\n
\n
\n
\n
\n

contents

\n
\n

[object]

\n

Multi-part content blocks for the message.

\n
\n
\n
\n
\n
\n

type [required]

\n
\n

string

\n

Content block type.

\n
\n \n
\n
\n
\n
\n
\n

value [required]

\n
\n

object

\n

Value of a prompt message content block.

\n
\n
\n
\n
\n
\n

text

\n
\n

string

\n

Text content of the message block.

\n
\n \n
\n
\n
\n
\n
\n

tool_call

\n
\n

object

\n

A tool call within a prompt message.

\n
\n
\n
\n
\n
\n

arguments

\n
\n

string

\n

JSON-encoded arguments for the tool call.

\n
\n \n
\n
\n
\n
\n
\n

id

\n
\n

string

\n

Unique identifier of the tool call.

\n
\n \n
\n
\n
\n
\n
\n

name

\n
\n

string

\n

Name of the tool being called.

\n
\n \n
\n
\n
\n
\n
\n

type

\n
\n

string

\n

Type of the tool call.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n

tool_call_result

\n
\n

object

\n

A tool call result within a prompt message.

\n
\n
\n
\n
\n
\n

name

\n
\n

string

\n

Name of the tool that produced this result.

\n
\n \n
\n
\n
\n
\n
\n

result

\n
\n

string

\n

The result returned by the tool.

\n
\n \n
\n
\n
\n
\n
\n

tool_id

\n
\n

string

\n

Identifier of the tool call this result corresponds to.

\n
\n \n
\n
\n
\n
\n
\n

type

\n
\n

string

\n

Type of the tool result.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n

role [required]

\n
\n

string

\n

Role of the message author.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n

target_query

\n
\n

string

\n

Query used to extract the target value to evaluate.

\n
\n \n
\n
\n
\n
\n
\n

user_specified_json_post_processing_function

\n
\n

string

\n

User-provided function applied to post-process the JSON output of the LLM judge.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n

llm_provider

\n
\n

object

\n

LLM provider configuration for a custom evaluator.

\n
\n
\n
\n
\n
\n

bedrock

\n
\n

object

\n

AWS Bedrock-specific options for LLM provider configuration.

\n
\n
\n
\n
\n
\n

inference_profile

\n
\n

string

\n

Bedrock inference profile identifier, such as an application inference profile ARN.

\n
\n \n
\n
\n
\n
\n
\n

region

\n
\n

string

\n

AWS region for Bedrock.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n

integration_account_id

\n
\n

string

\n

Integration account identifier.

\n
\n \n
\n
\n
\n
\n
\n

integration_provider

\n
\n

enum

\n

Name of the LLM integration provider. \nAllowed enum values: openai,amazon-bedrock,anthropic,azure-openai,vertex-ai,llm-proxy

\n
\n \n
\n
\n
\n
\n
\n

model_name

\n
\n

string

\n

Name of the LLM model.

\n
\n \n
\n
\n
\n
\n
\n

vertex_ai

\n
\n

object

\n

Google Vertex AI-specific options for LLM provider configuration.

\n
\n
\n
\n
\n
\n

location

\n
\n

string

\n

Google Cloud region.

\n
\n \n
\n
\n
\n
\n
\n

project

\n
\n

string

\n

Google Cloud project ID.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n
\n
\n

target

\n
\n

object

\n

Target application configuration for a custom evaluator.

\n
\n
\n
\n
\n
\n

application_name [required]

\n
\n

string

\n

Name of the ML application this evaluator targets.

\n
\n \n
\n
\n
\n
\n
\n

enabled [required]

\n
\n

boolean

\n

Whether the evaluator is active for the target application.

\n
\n \n
\n
\n
\n
\n
\n

eval_scope

\n
\n

enum

\n

Scope at which to evaluate spans. \nAllowed enum values: span,trace,session

\n
\n \n
\n
\n
\n
\n
\n

experiment_project_ids

\n
\n

[string]

\n

Experiment project IDs this evaluator is scoped to.

\n
\n \n
\n
\n
\n
\n
\n

filter

\n
\n

string

\n

Filter expression to select which spans to evaluate.

\n
\n \n
\n
\n
\n
\n
\n

root_spans_only

\n
\n

boolean

\n

When true, only root spans are evaluated.

\n
\n \n
\n
\n
\n
\n
\n

sampling_percentage

\n
\n

double

\n

Percentage of traces to evaluate. Must be greater than 0 and at most 100.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n

updated_at [required]

\n
\n

date-time

\n

Timestamp when the evaluator configuration was last updated.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n

id [required]

\n
\n

string

\n

Unique name identifier of the evaluator configuration.

\n
\n \n
\n
\n
\n
\n
\n

type [required]

\n
\n

enum

\n

Type of the custom Agent Observability evaluator configuration resource. \nAllowed enum values: evaluator_config

\n
\n \n
\n
\n
\n
" + "html": "
\n
\n
\n
\n

data [required]

\n
\n

[object]

\n

List of custom evaluator configuration data objects.

\n
\n
\n
\n
\n
\n

attributes [required]

\n
\n

object

\n

Attributes of a custom Agent Observability evaluator configuration.

\n
\n
\n
\n
\n
\n

category

\n
\n

string

\n

Category of the evaluator.

\n
\n \n
\n
\n
\n
\n
\n

created_at [required]

\n
\n

date-time

\n

Timestamp when the evaluator configuration was created.

\n
\n \n
\n
\n
\n
\n
\n

created_by

\n
\n

object

\n

A Datadog user associated with a custom evaluator configuration.

\n
\n
\n
\n
\n
\n

email

\n
\n

string

\n

Email address of the user.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n

eval_name [required]

\n
\n

string

\n

Name of the custom evaluator.

\n
\n \n
\n
\n
\n
\n
\n

last_updated_by

\n
\n

object

\n

A Datadog user associated with a custom evaluator configuration.

\n
\n
\n
\n
\n
\n

email

\n
\n

string

\n

Email address of the user.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n

llm_judge_config

\n
\n

object

\n

LLM judge configuration for a custom evaluator.

\n
\n
\n
\n
\n
\n

assessment_criteria

\n
\n

object

\n

Criteria used to assess the pass/fail result of a custom evaluator.

\n
\n
\n
\n
\n
\n

max_threshold

\n
\n

double

\n

Maximum numeric threshold for a passing result.

\n
\n \n
\n
\n
\n
\n
\n

min_threshold

\n
\n

double

\n

Minimum numeric threshold for a passing result.

\n
\n \n
\n
\n
\n
\n
\n

pass_values

\n
\n

[string]

\n

Specific output values considered as a passing result.

\n
\n \n
\n
\n
\n
\n
\n

pass_when

\n
\n

boolean

\n

When true, a boolean output of true is treated as passing.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n

context_query

\n
\n

string

\n

Query used to extract additional context for the evaluation.

\n
\n \n
\n
\n
\n
\n
\n

inference_params [required]

\n
\n

object

\n

LLM inference parameters for a custom evaluator.

\n
\n
\n
\n
\n
\n

frequency_penalty

\n
\n

double

\n

Frequency penalty to reduce repetition.

\n
\n \n
\n
\n
\n
\n
\n

max_tokens

\n
\n

int64

\n

Maximum number of tokens to generate.

\n
\n \n
\n
\n
\n
\n
\n

presence_penalty

\n
\n

double

\n

Presence penalty to reduce repetition.

\n
\n \n
\n
\n
\n
\n
\n

temperature

\n
\n

double

\n

Sampling temperature for the LLM.

\n
\n \n
\n
\n
\n
\n
\n

top_k

\n
\n

int64

\n

Top-k sampling parameter.

\n
\n \n
\n
\n
\n
\n
\n

top_p

\n
\n

double

\n

Top-p (nucleus) sampling parameter.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n

last_used_library_prompt_template_name

\n
\n

string

\n

Name of the last library prompt template used.

\n
\n \n
\n
\n
\n
\n
\n

modified_library_prompt_template

\n
\n

boolean

\n

Whether the library prompt template was modified.

\n
\n \n
\n
\n
\n
\n
\n

output_schema

\n
\n

object

\n

JSON schema describing the expected output format of the LLM judge. Omit for a deterministic evaluator.

\n
\n \n
\n
\n
\n
\n
\n

parsing_type

\n
\n

enum

\n

Output parsing type for a custom LLM judge evaluator. \nAllowed enum values: structured_output,json,keyword_search,typed_questions

\n
\n \n
\n
\n
\n
\n
\n

prompt_template

\n
\n

[object]

\n

List of messages forming the LLM judge prompt template. Omit for a deterministic evaluator.

\n
\n
\n
\n
\n
\n

content

\n
\n

string

\n

Text content of the message.

\n
\n \n
\n
\n
\n
\n
\n

contents

\n
\n

[object]

\n

Multi-part content blocks for the message.

\n
\n
\n
\n
\n
\n

type [required]

\n
\n

string

\n

Content block type.

\n
\n \n
\n
\n
\n
\n
\n

value [required]

\n
\n

object

\n

Value of a prompt message content block.

\n
\n
\n
\n
\n
\n

text

\n
\n

string

\n

Text content of the message block.

\n
\n \n
\n
\n
\n
\n
\n

tool_call

\n
\n

object

\n

A tool call within a prompt message.

\n
\n
\n
\n
\n
\n

arguments

\n
\n

string

\n

JSON-encoded arguments for the tool call.

\n
\n \n
\n
\n
\n
\n
\n

id

\n
\n

string

\n

Unique identifier of the tool call.

\n
\n \n
\n
\n
\n
\n
\n

name

\n
\n

string

\n

Name of the tool being called.

\n
\n \n
\n
\n
\n
\n
\n

type

\n
\n

string

\n

Type of the tool call.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n

tool_call_result

\n
\n

object

\n

A tool call result within a prompt message.

\n
\n
\n
\n
\n
\n

name

\n
\n

string

\n

Name of the tool that produced this result.

\n
\n \n
\n
\n
\n
\n
\n

result

\n
\n

string

\n

The result returned by the tool.

\n
\n \n
\n
\n
\n
\n
\n

tool_id

\n
\n

string

\n

Identifier of the tool call this result corresponds to.

\n
\n \n
\n
\n
\n
\n
\n

type

\n
\n

string

\n

Type of the tool result.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n

role [required]

\n
\n

string

\n

Role of the message author.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n

target_query

\n
\n

string

\n

Query used to extract the target value to evaluate.

\n
\n \n
\n
\n
\n
\n
\n

user_specified_json_post_processing_function

\n
\n

string

\n

User-provided JavaScript function applied to post-process the JSON output of the LLM judge. For a deterministic evaluator it is the evaluator itself: it receives the evaluated span (span scope), {spans} (trace scope), or {session_id, traces} (session scope), and its return value sets the result. A boolean, number, string or object becomes a boolean, score, categorical or JSON metric; null skips the evaluation; and {value, assessment, reasoning, metadata} also sets pass or fail, reasoning, and metadata.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n

llm_provider

\n
\n

object

\n

LLM provider configuration for a custom evaluator.

\n
\n
\n
\n
\n
\n

bedrock

\n
\n

object

\n

AWS Bedrock-specific options for LLM provider configuration.

\n
\n
\n
\n
\n
\n

inference_profile

\n
\n

string

\n

Bedrock inference profile identifier, such as an application inference profile ARN.

\n
\n \n
\n
\n
\n
\n
\n

region

\n
\n

string

\n

AWS region for Bedrock.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n

integration_account_id

\n
\n

string

\n

Integration account identifier.

\n
\n \n
\n
\n
\n
\n
\n

integration_provider

\n
\n

enum

\n

Name of the LLM integration provider. Use deterministic for a code evaluator, which runs llm_judge_config.user_specified_json_post_processing_function instead of calling an LLM. insights_sponsored is returned for evaluators that Datadog manages and cannot be set. \nAllowed enum values: openai,amazon_bedrock,anthropic,azure_openai,vertex_ai,llmproxy,deterministic,typesafe,datadog,datadog_ai_gateway

Show 1 more,insights_sponsored

\n
\n \n
\n
\n
\n
\n
\n

model_name

\n
\n

string

\n

Name of the LLM model. Use javascript for a deterministic evaluator.

\n
\n \n
\n
\n
\n
\n
\n

vertex_ai

\n
\n

object

\n

Google Vertex AI-specific options for LLM provider configuration.

\n
\n
\n
\n
\n
\n

location

\n
\n

string

\n

Google Cloud region.

\n
\n \n
\n
\n
\n
\n
\n

project

\n
\n

string

\n

Google Cloud project ID.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n
\n
\n

target

\n
\n

object

\n

Target application configuration for a custom evaluator.

\n
\n
\n
\n
\n
\n

application_name [required]

\n
\n

string

\n

Name of the ML application this evaluator targets.

\n
\n \n
\n
\n
\n
\n
\n

enabled [required]

\n
\n

boolean

\n

Whether the evaluator is active for the target application.

\n
\n \n
\n
\n
\n
\n
\n

eval_scope

\n
\n

enum

\n

Scope at which to evaluate spans. trace_fan_out requires llm_judge_config.target_query. \nAllowed enum values: span,trace,trace_fan_out,session

\n
\n \n
\n
\n
\n
\n
\n

experiment_project_ids

\n
\n

[string]

\n

Experiment project IDs this evaluator is scoped to.

\n
\n \n
\n
\n
\n
\n
\n

filter

\n
\n

string

\n

Filter expression to select which spans to evaluate.

\n
\n \n
\n
\n
\n
\n
\n

root_spans_only

\n
\n

boolean

\n

When true, only root spans are evaluated.

\n
\n \n
\n
\n
\n
\n
\n

sampling_percentage

\n
\n

double

\n

Percentage of traces to evaluate. Must be greater than 0 and at most 100.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n

updated_at [required]

\n
\n

date-time

\n

Timestamp when the evaluator configuration was last updated.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n

id [required]

\n
\n

string

\n

Unique name identifier of the evaluator configuration.

\n
\n \n
\n
\n
\n
\n
\n

type [required]

\n
\n

enum

\n

Type of the custom Agent Observability evaluator configuration resource. \nAllowed enum values: evaluator_config

\n
\n \n
\n
\n
\n
" }, "401": { "json": { @@ -333,7 +333,7 @@ "type": "evaluator_config" } }, - "html": "
\n
\n
\n
\n

data [required]

\n
\n

object

\n

Data object for a custom Agent Observability evaluator configuration.

\n
\n
\n
\n
\n
\n

attributes [required]

\n
\n

object

\n

Attributes of a custom Agent Observability evaluator configuration.

\n
\n
\n
\n
\n
\n

category

\n
\n

string

\n

Category of the evaluator.

\n
\n \n
\n
\n
\n
\n
\n

created_at [required]

\n
\n

date-time

\n

Timestamp when the evaluator configuration was created.

\n
\n \n
\n
\n
\n
\n
\n

created_by

\n
\n

object

\n

A Datadog user associated with a custom evaluator configuration.

\n
\n
\n
\n
\n
\n

email

\n
\n

string

\n

Email address of the user.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n

eval_name [required]

\n
\n

string

\n

Name of the custom evaluator.

\n
\n \n
\n
\n
\n
\n
\n

last_updated_by

\n
\n

object

\n

A Datadog user associated with a custom evaluator configuration.

\n
\n
\n
\n
\n
\n

email

\n
\n

string

\n

Email address of the user.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n

llm_judge_config

\n
\n

object

\n

LLM judge configuration for a custom evaluator.

\n
\n
\n
\n
\n
\n

assessment_criteria

\n
\n

object

\n

Criteria used to assess the pass/fail result of a custom evaluator.

\n
\n
\n
\n
\n
\n

max_threshold

\n
\n

double

\n

Maximum numeric threshold for a passing result.

\n
\n \n
\n
\n
\n
\n
\n

min_threshold

\n
\n

double

\n

Minimum numeric threshold for a passing result.

\n
\n \n
\n
\n
\n
\n
\n

pass_values

\n
\n

[string]

\n

Specific output values considered as a passing result.

\n
\n \n
\n
\n
\n
\n
\n

pass_when

\n
\n

boolean

\n

When true, a boolean output of true is treated as passing.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n

context_query

\n
\n

string

\n

Query used to extract additional context for the evaluation.

\n
\n \n
\n
\n
\n
\n
\n

inference_params [required]

\n
\n

object

\n

LLM inference parameters for a custom evaluator.

\n
\n
\n
\n
\n
\n

frequency_penalty

\n
\n

double

\n

Frequency penalty to reduce repetition.

\n
\n \n
\n
\n
\n
\n
\n

max_tokens

\n
\n

int64

\n

Maximum number of tokens to generate.

\n
\n \n
\n
\n
\n
\n
\n

presence_penalty

\n
\n

double

\n

Presence penalty to reduce repetition.

\n
\n \n
\n
\n
\n
\n
\n

temperature

\n
\n

double

\n

Sampling temperature for the LLM.

\n
\n \n
\n
\n
\n
\n
\n

top_k

\n
\n

int64

\n

Top-k sampling parameter.

\n
\n \n
\n
\n
\n
\n
\n

top_p

\n
\n

double

\n

Top-p (nucleus) sampling parameter.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n

last_used_library_prompt_template_name

\n
\n

string

\n

Name of the last library prompt template used.

\n
\n \n
\n
\n
\n
\n
\n

modified_library_prompt_template

\n
\n

boolean

\n

Whether the library prompt template was modified.

\n
\n \n
\n
\n
\n
\n
\n

output_schema

\n
\n

object

\n

JSON schema describing the expected output format of the LLM judge.

\n
\n \n
\n
\n
\n
\n
\n

parsing_type

\n
\n

enum

\n

Output parsing type for a custom LLM judge evaluator. \nAllowed enum values: structured_output,json,keyword_search

\n
\n \n
\n
\n
\n
\n
\n

prompt_template

\n
\n

[object]

\n

List of messages forming the LLM judge prompt template.

\n
\n
\n
\n
\n
\n

content

\n
\n

string

\n

Text content of the message.

\n
\n \n
\n
\n
\n
\n
\n

contents

\n
\n

[object]

\n

Multi-part content blocks for the message.

\n
\n
\n
\n
\n
\n

type [required]

\n
\n

string

\n

Content block type.

\n
\n \n
\n
\n
\n
\n
\n

value [required]

\n
\n

object

\n

Value of a prompt message content block.

\n
\n
\n
\n
\n
\n

text

\n
\n

string

\n

Text content of the message block.

\n
\n \n
\n
\n
\n
\n
\n

tool_call

\n
\n

object

\n

A tool call within a prompt message.

\n
\n
\n
\n
\n
\n

arguments

\n
\n

string

\n

JSON-encoded arguments for the tool call.

\n
\n \n
\n
\n
\n
\n
\n

id

\n
\n

string

\n

Unique identifier of the tool call.

\n
\n \n
\n
\n
\n
\n
\n

name

\n
\n

string

\n

Name of the tool being called.

\n
\n \n
\n
\n
\n
\n
\n

type

\n
\n

string

\n

Type of the tool call.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n

tool_call_result

\n
\n

object

\n

A tool call result within a prompt message.

\n
\n
\n
\n
\n
\n

name

\n
\n

string

\n

Name of the tool that produced this result.

\n
\n \n
\n
\n
\n
\n
\n

result

\n
\n

string

\n

The result returned by the tool.

\n
\n \n
\n
\n
\n
\n
\n

tool_id

\n
\n

string

\n

Identifier of the tool call this result corresponds to.

\n
\n \n
\n
\n
\n
\n
\n

type

\n
\n

string

\n

Type of the tool result.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n

role [required]

\n
\n

string

\n

Role of the message author.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n

target_query

\n
\n

string

\n

Query used to extract the target value to evaluate.

\n
\n \n
\n
\n
\n
\n
\n

user_specified_json_post_processing_function

\n
\n

string

\n

User-provided function applied to post-process the JSON output of the LLM judge.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n

llm_provider

\n
\n

object

\n

LLM provider configuration for a custom evaluator.

\n
\n
\n
\n
\n
\n

bedrock

\n
\n

object

\n

AWS Bedrock-specific options for LLM provider configuration.

\n
\n
\n
\n
\n
\n

inference_profile

\n
\n

string

\n

Bedrock inference profile identifier, such as an application inference profile ARN.

\n
\n \n
\n
\n
\n
\n
\n

region

\n
\n

string

\n

AWS region for Bedrock.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n

integration_account_id

\n
\n

string

\n

Integration account identifier.

\n
\n \n
\n
\n
\n
\n
\n

integration_provider

\n
\n

enum

\n

Name of the LLM integration provider. \nAllowed enum values: openai,amazon-bedrock,anthropic,azure-openai,vertex-ai,llm-proxy

\n
\n \n
\n
\n
\n
\n
\n

model_name

\n
\n

string

\n

Name of the LLM model.

\n
\n \n
\n
\n
\n
\n
\n

vertex_ai

\n
\n

object

\n

Google Vertex AI-specific options for LLM provider configuration.

\n
\n
\n
\n
\n
\n

location

\n
\n

string

\n

Google Cloud region.

\n
\n \n
\n
\n
\n
\n
\n

project

\n
\n

string

\n

Google Cloud project ID.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n
\n
\n

target

\n
\n

object

\n

Target application configuration for a custom evaluator.

\n
\n
\n
\n
\n
\n

application_name [required]

\n
\n

string

\n

Name of the ML application this evaluator targets.

\n
\n \n
\n
\n
\n
\n
\n

enabled [required]

\n
\n

boolean

\n

Whether the evaluator is active for the target application.

\n
\n \n
\n
\n
\n
\n
\n

eval_scope

\n
\n

enum

\n

Scope at which to evaluate spans. \nAllowed enum values: span,trace,session

\n
\n \n
\n
\n
\n
\n
\n

experiment_project_ids

\n
\n

[string]

\n

Experiment project IDs this evaluator is scoped to.

\n
\n \n
\n
\n
\n
\n
\n

filter

\n
\n

string

\n

Filter expression to select which spans to evaluate.

\n
\n \n
\n
\n
\n
\n
\n

root_spans_only

\n
\n

boolean

\n

When true, only root spans are evaluated.

\n
\n \n
\n
\n
\n
\n
\n

sampling_percentage

\n
\n

double

\n

Percentage of traces to evaluate. Must be greater than 0 and at most 100.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n

updated_at [required]

\n
\n

date-time

\n

Timestamp when the evaluator configuration was last updated.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n

id [required]

\n
\n

string

\n

Unique name identifier of the evaluator configuration.

\n
\n \n
\n
\n
\n
\n
\n

type [required]

\n
\n

enum

\n

Type of the custom Agent Observability evaluator configuration resource. \nAllowed enum values: evaluator_config

\n
\n \n
\n
\n
\n
" + "html": "
\n
\n
\n
\n

data [required]

\n
\n

object

\n

Data object for a custom Agent Observability evaluator configuration.

\n
\n
\n
\n
\n
\n

attributes [required]

\n
\n

object

\n

Attributes of a custom Agent Observability evaluator configuration.

\n
\n
\n
\n
\n
\n

category

\n
\n

string

\n

Category of the evaluator.

\n
\n \n
\n
\n
\n
\n
\n

created_at [required]

\n
\n

date-time

\n

Timestamp when the evaluator configuration was created.

\n
\n \n
\n
\n
\n
\n
\n

created_by

\n
\n

object

\n

A Datadog user associated with a custom evaluator configuration.

\n
\n
\n
\n
\n
\n

email

\n
\n

string

\n

Email address of the user.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n

eval_name [required]

\n
\n

string

\n

Name of the custom evaluator.

\n
\n \n
\n
\n
\n
\n
\n

last_updated_by

\n
\n

object

\n

A Datadog user associated with a custom evaluator configuration.

\n
\n
\n
\n
\n
\n

email

\n
\n

string

\n

Email address of the user.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n

llm_judge_config

\n
\n

object

\n

LLM judge configuration for a custom evaluator.

\n
\n
\n
\n
\n
\n

assessment_criteria

\n
\n

object

\n

Criteria used to assess the pass/fail result of a custom evaluator.

\n
\n
\n
\n
\n
\n

max_threshold

\n
\n

double

\n

Maximum numeric threshold for a passing result.

\n
\n \n
\n
\n
\n
\n
\n

min_threshold

\n
\n

double

\n

Minimum numeric threshold for a passing result.

\n
\n \n
\n
\n
\n
\n
\n

pass_values

\n
\n

[string]

\n

Specific output values considered as a passing result.

\n
\n \n
\n
\n
\n
\n
\n

pass_when

\n
\n

boolean

\n

When true, a boolean output of true is treated as passing.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n

context_query

\n
\n

string

\n

Query used to extract additional context for the evaluation.

\n
\n \n
\n
\n
\n
\n
\n

inference_params [required]

\n
\n

object

\n

LLM inference parameters for a custom evaluator.

\n
\n
\n
\n
\n
\n

frequency_penalty

\n
\n

double

\n

Frequency penalty to reduce repetition.

\n
\n \n
\n
\n
\n
\n
\n

max_tokens

\n
\n

int64

\n

Maximum number of tokens to generate.

\n
\n \n
\n
\n
\n
\n
\n

presence_penalty

\n
\n

double

\n

Presence penalty to reduce repetition.

\n
\n \n
\n
\n
\n
\n
\n

temperature

\n
\n

double

\n

Sampling temperature for the LLM.

\n
\n \n
\n
\n
\n
\n
\n

top_k

\n
\n

int64

\n

Top-k sampling parameter.

\n
\n \n
\n
\n
\n
\n
\n

top_p

\n
\n

double

\n

Top-p (nucleus) sampling parameter.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n

last_used_library_prompt_template_name

\n
\n

string

\n

Name of the last library prompt template used.

\n
\n \n
\n
\n
\n
\n
\n

modified_library_prompt_template

\n
\n

boolean

\n

Whether the library prompt template was modified.

\n
\n \n
\n
\n
\n
\n
\n

output_schema

\n
\n

object

\n

JSON schema describing the expected output format of the LLM judge. Omit for a deterministic evaluator.

\n
\n \n
\n
\n
\n
\n
\n

parsing_type

\n
\n

enum

\n

Output parsing type for a custom LLM judge evaluator. \nAllowed enum values: structured_output,json,keyword_search,typed_questions

\n
\n \n
\n
\n
\n
\n
\n

prompt_template

\n
\n

[object]

\n

List of messages forming the LLM judge prompt template. Omit for a deterministic evaluator.

\n
\n
\n
\n
\n
\n

content

\n
\n

string

\n

Text content of the message.

\n
\n \n
\n
\n
\n
\n
\n

contents

\n
\n

[object]

\n

Multi-part content blocks for the message.

\n
\n
\n
\n
\n
\n

type [required]

\n
\n

string

\n

Content block type.

\n
\n \n
\n
\n
\n
\n
\n

value [required]

\n
\n

object

\n

Value of a prompt message content block.

\n
\n
\n
\n
\n
\n

text

\n
\n

string

\n

Text content of the message block.

\n
\n \n
\n
\n
\n
\n
\n

tool_call

\n
\n

object

\n

A tool call within a prompt message.

\n
\n
\n
\n
\n
\n

arguments

\n
\n

string

\n

JSON-encoded arguments for the tool call.

\n
\n \n
\n
\n
\n
\n
\n

id

\n
\n

string

\n

Unique identifier of the tool call.

\n
\n \n
\n
\n
\n
\n
\n

name

\n
\n

string

\n

Name of the tool being called.

\n
\n \n
\n
\n
\n
\n
\n

type

\n
\n

string

\n

Type of the tool call.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n

tool_call_result

\n
\n

object

\n

A tool call result within a prompt message.

\n
\n
\n
\n
\n
\n

name

\n
\n

string

\n

Name of the tool that produced this result.

\n
\n \n
\n
\n
\n
\n
\n

result

\n
\n

string

\n

The result returned by the tool.

\n
\n \n
\n
\n
\n
\n
\n

tool_id

\n
\n

string

\n

Identifier of the tool call this result corresponds to.

\n
\n \n
\n
\n
\n
\n
\n

type

\n
\n

string

\n

Type of the tool result.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n

role [required]

\n
\n

string

\n

Role of the message author.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n

target_query

\n
\n

string

\n

Query used to extract the target value to evaluate.

\n
\n \n
\n
\n
\n
\n
\n

user_specified_json_post_processing_function

\n
\n

string

\n

User-provided JavaScript function applied to post-process the JSON output of the LLM judge. For a deterministic evaluator it is the evaluator itself: it receives the evaluated span (span scope), {spans} (trace scope), or {session_id, traces} (session scope), and its return value sets the result. A boolean, number, string or object becomes a boolean, score, categorical or JSON metric; null skips the evaluation; and {value, assessment, reasoning, metadata} also sets pass or fail, reasoning, and metadata.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n

llm_provider

\n
\n

object

\n

LLM provider configuration for a custom evaluator.

\n
\n
\n
\n
\n
\n

bedrock

\n
\n

object

\n

AWS Bedrock-specific options for LLM provider configuration.

\n
\n
\n
\n
\n
\n

inference_profile

\n
\n

string

\n

Bedrock inference profile identifier, such as an application inference profile ARN.

\n
\n \n
\n
\n
\n
\n
\n

region

\n
\n

string

\n

AWS region for Bedrock.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n

integration_account_id

\n
\n

string

\n

Integration account identifier.

\n
\n \n
\n
\n
\n
\n
\n

integration_provider

\n
\n

enum

\n

Name of the LLM integration provider. Use deterministic for a code evaluator, which runs llm_judge_config.user_specified_json_post_processing_function instead of calling an LLM. insights_sponsored is returned for evaluators that Datadog manages and cannot be set. \nAllowed enum values: openai,amazon_bedrock,anthropic,azure_openai,vertex_ai,llmproxy,deterministic,typesafe,datadog,datadog_ai_gateway

Show 1 more,insights_sponsored

\n
\n \n
\n
\n
\n
\n
\n

model_name

\n
\n

string

\n

Name of the LLM model. Use javascript for a deterministic evaluator.

\n
\n \n
\n
\n
\n
\n
\n

vertex_ai

\n
\n

object

\n

Google Vertex AI-specific options for LLM provider configuration.

\n
\n
\n
\n
\n
\n

location

\n
\n

string

\n

Google Cloud region.

\n
\n \n
\n
\n
\n
\n
\n

project

\n
\n

string

\n

Google Cloud project ID.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n
\n
\n

target

\n
\n

object

\n

Target application configuration for a custom evaluator.

\n
\n
\n
\n
\n
\n

application_name [required]

\n
\n

string

\n

Name of the ML application this evaluator targets.

\n
\n \n
\n
\n
\n
\n
\n

enabled [required]

\n
\n

boolean

\n

Whether the evaluator is active for the target application.

\n
\n \n
\n
\n
\n
\n
\n

eval_scope

\n
\n

enum

\n

Scope at which to evaluate spans. trace_fan_out requires llm_judge_config.target_query. \nAllowed enum values: span,trace,trace_fan_out,session

\n
\n \n
\n
\n
\n
\n
\n

experiment_project_ids

\n
\n

[string]

\n

Experiment project IDs this evaluator is scoped to.

\n
\n \n
\n
\n
\n
\n
\n

filter

\n
\n

string

\n

Filter expression to select which spans to evaluate.

\n
\n \n
\n
\n
\n
\n
\n

root_spans_only

\n
\n

boolean

\n

When true, only root spans are evaluated.

\n
\n \n
\n
\n
\n
\n
\n

sampling_percentage

\n
\n

double

\n

Percentage of traces to evaluate. Must be greater than 0 and at most 100.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n

updated_at [required]

\n
\n

date-time

\n

Timestamp when the evaluator configuration was last updated.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n

id [required]

\n
\n

string

\n

Unique name identifier of the evaluator configuration.

\n
\n \n
\n
\n
\n
\n
\n

type [required]

\n
\n

enum

\n

Type of the custom Agent Observability evaluator configuration resource. \nAllowed enum values: evaluator_config

\n
\n \n
\n
\n
\n
" }, "400": { "json": { @@ -633,7 +633,7 @@ "type": "evaluator_config" } }, - "html": "
\n
\n
\n
\n

data [required]

\n
\n

object

\n

Data object for creating or updating a custom Agent Observability evaluator configuration.

\n
\n
\n
\n
\n
\n

attributes [required]

\n
\n

object

\n

Attributes for creating or updating a custom Agent Observability evaluator configuration.

\n
\n
\n
\n
\n
\n

category

\n
\n

string

\n

Category of the evaluator.

\n
\n \n
\n
\n
\n
\n
\n

eval_name

\n
\n

string

\n

Name of the custom evaluator. If provided, must match the eval_name path parameter.

\n
\n \n
\n
\n
\n
\n
\n

llm_judge_config

\n
\n

object

\n

LLM judge configuration for a custom evaluator.

\n
\n
\n
\n
\n
\n

assessment_criteria

\n
\n

object

\n

Criteria used to assess the pass/fail result of a custom evaluator.

\n
\n
\n
\n
\n
\n

max_threshold

\n
\n

double

\n

Maximum numeric threshold for a passing result.

\n
\n \n
\n
\n
\n
\n
\n

min_threshold

\n
\n

double

\n

Minimum numeric threshold for a passing result.

\n
\n \n
\n
\n
\n
\n
\n

pass_values

\n
\n

[string]

\n

Specific output values considered as a passing result.

\n
\n \n
\n
\n
\n
\n
\n

pass_when

\n
\n

boolean

\n

When true, a boolean output of true is treated as passing.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n

context_query

\n
\n

string

\n

Query used to extract additional context for the evaluation.

\n
\n \n
\n
\n
\n
\n
\n

inference_params [required]

\n
\n

object

\n

LLM inference parameters for a custom evaluator.

\n
\n
\n
\n
\n
\n

frequency_penalty

\n
\n

double

\n

Frequency penalty to reduce repetition.

\n
\n \n
\n
\n
\n
\n
\n

max_tokens

\n
\n

int64

\n

Maximum number of tokens to generate.

\n
\n \n
\n
\n
\n
\n
\n

presence_penalty

\n
\n

double

\n

Presence penalty to reduce repetition.

\n
\n \n
\n
\n
\n
\n
\n

temperature

\n
\n

double

\n

Sampling temperature for the LLM.

\n
\n \n
\n
\n
\n
\n
\n

top_k

\n
\n

int64

\n

Top-k sampling parameter.

\n
\n \n
\n
\n
\n
\n
\n

top_p

\n
\n

double

\n

Top-p (nucleus) sampling parameter.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n

last_used_library_prompt_template_name

\n
\n

string

\n

Name of the last library prompt template used.

\n
\n \n
\n
\n
\n
\n
\n

modified_library_prompt_template

\n
\n

boolean

\n

Whether the library prompt template was modified.

\n
\n \n
\n
\n
\n
\n
\n

output_schema

\n
\n

object

\n

JSON schema describing the expected output format of the LLM judge.

\n
\n \n
\n
\n
\n
\n
\n

parsing_type

\n
\n

enum

\n

Output parsing type for a custom LLM judge evaluator. \nAllowed enum values: structured_output,json,keyword_search

\n
\n \n
\n
\n
\n
\n
\n

prompt_template

\n
\n

[object]

\n

List of messages forming the LLM judge prompt template.

\n
\n
\n
\n
\n
\n

content

\n
\n

string

\n

Text content of the message.

\n
\n \n
\n
\n
\n
\n
\n

contents

\n
\n

[object]

\n

Multi-part content blocks for the message.

\n
\n
\n
\n
\n
\n

type [required]

\n
\n

string

\n

Content block type.

\n
\n \n
\n
\n
\n
\n
\n

value [required]

\n
\n

object

\n

Value of a prompt message content block.

\n
\n
\n
\n
\n
\n

text

\n
\n

string

\n

Text content of the message block.

\n
\n \n
\n
\n
\n
\n
\n

tool_call

\n
\n

object

\n

A tool call within a prompt message.

\n
\n
\n
\n
\n
\n

arguments

\n
\n

string

\n

JSON-encoded arguments for the tool call.

\n
\n \n
\n
\n
\n
\n
\n

id

\n
\n

string

\n

Unique identifier of the tool call.

\n
\n \n
\n
\n
\n
\n
\n

name

\n
\n

string

\n

Name of the tool being called.

\n
\n \n
\n
\n
\n
\n
\n

type

\n
\n

string

\n

Type of the tool call.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n

tool_call_result

\n
\n

object

\n

A tool call result within a prompt message.

\n
\n
\n
\n
\n
\n

name

\n
\n

string

\n

Name of the tool that produced this result.

\n
\n \n
\n
\n
\n
\n
\n

result

\n
\n

string

\n

The result returned by the tool.

\n
\n \n
\n
\n
\n
\n
\n

tool_id

\n
\n

string

\n

Identifier of the tool call this result corresponds to.

\n
\n \n
\n
\n
\n
\n
\n

type

\n
\n

string

\n

Type of the tool result.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n

role [required]

\n
\n

string

\n

Role of the message author.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n

target_query

\n
\n

string

\n

Query used to extract the target value to evaluate.

\n
\n \n
\n
\n
\n
\n
\n

user_specified_json_post_processing_function

\n
\n

string

\n

User-provided function applied to post-process the JSON output of the LLM judge.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n

llm_provider

\n
\n

object

\n

LLM provider configuration for a custom evaluator.

\n
\n
\n
\n
\n
\n

bedrock

\n
\n

object

\n

AWS Bedrock-specific options for LLM provider configuration.

\n
\n
\n
\n
\n
\n

inference_profile

\n
\n

string

\n

Bedrock inference profile identifier, such as an application inference profile ARN.

\n
\n \n
\n
\n
\n
\n
\n

region

\n
\n

string

\n

AWS region for Bedrock.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n

integration_account_id

\n
\n

string

\n

Integration account identifier.

\n
\n \n
\n
\n
\n
\n
\n

integration_provider

\n
\n

enum

\n

Name of the LLM integration provider. \nAllowed enum values: openai,amazon-bedrock,anthropic,azure-openai,vertex-ai,llm-proxy

\n
\n \n
\n
\n
\n
\n
\n

model_name

\n
\n

string

\n

Name of the LLM model.

\n
\n \n
\n
\n
\n
\n
\n

vertex_ai

\n
\n

object

\n

Google Vertex AI-specific options for LLM provider configuration.

\n
\n
\n
\n
\n
\n

location

\n
\n

string

\n

Google Cloud region.

\n
\n \n
\n
\n
\n
\n
\n

project

\n
\n

string

\n

Google Cloud project ID.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n
\n
\n

target [required]

\n
\n

object

\n

Target application configuration for a custom evaluator.

\n
\n
\n
\n
\n
\n

application_name [required]

\n
\n

string

\n

Name of the ML application this evaluator targets.

\n
\n \n
\n
\n
\n
\n
\n

enabled [required]

\n
\n

boolean

\n

Whether the evaluator is active for the target application.

\n
\n \n
\n
\n
\n
\n
\n

eval_scope

\n
\n

enum

\n

Scope at which to evaluate spans. \nAllowed enum values: span,trace,session

\n
\n \n
\n
\n
\n
\n
\n

experiment_project_ids

\n
\n

[string]

\n

Experiment project IDs this evaluator is scoped to.

\n
\n \n
\n
\n
\n
\n
\n

filter

\n
\n

string

\n

Filter expression to select which spans to evaluate.

\n
\n \n
\n
\n
\n
\n
\n

root_spans_only

\n
\n

boolean

\n

When true, only root spans are evaluated.

\n
\n \n
\n
\n
\n
\n
\n

sampling_percentage

\n
\n

double

\n

Percentage of traces to evaluate. Must be greater than 0 and at most 100.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n
\n
\n

id

\n
\n

string

\n

Name of the evaluator. If provided, must match the eval_name path parameter.

\n
\n \n
\n
\n
\n
\n
\n

type [required]

\n
\n

enum

\n

Type of the custom Agent Observability evaluator configuration resource. \nAllowed enum values: evaluator_config

\n
\n \n
\n
\n
\n
" + "html": "
\n
\n
\n
\n

data [required]

\n
\n

object

\n

Data object for creating or updating a custom Agent Observability evaluator configuration.

\n
\n
\n
\n
\n
\n

attributes [required]

\n
\n

object

\n

Attributes for creating or updating a custom Agent Observability evaluator configuration.

\n
\n
\n
\n
\n
\n

category

\n
\n

string

\n

Category of the evaluator.

\n
\n \n
\n
\n
\n
\n
\n

eval_name

\n
\n

string

\n

Name of the custom evaluator. If provided, must match the eval_name path parameter.

\n
\n \n
\n
\n
\n
\n
\n

llm_judge_config

\n
\n

object

\n

LLM judge configuration for a custom evaluator.

\n
\n
\n
\n
\n
\n

assessment_criteria

\n
\n

object

\n

Criteria used to assess the pass/fail result of a custom evaluator.

\n
\n
\n
\n
\n
\n

max_threshold

\n
\n

double

\n

Maximum numeric threshold for a passing result.

\n
\n \n
\n
\n
\n
\n
\n

min_threshold

\n
\n

double

\n

Minimum numeric threshold for a passing result.

\n
\n \n
\n
\n
\n
\n
\n

pass_values

\n
\n

[string]

\n

Specific output values considered as a passing result.

\n
\n \n
\n
\n
\n
\n
\n

pass_when

\n
\n

boolean

\n

When true, a boolean output of true is treated as passing.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n

context_query

\n
\n

string

\n

Query used to extract additional context for the evaluation.

\n
\n \n
\n
\n
\n
\n
\n

inference_params [required]

\n
\n

object

\n

LLM inference parameters for a custom evaluator.

\n
\n
\n
\n
\n
\n

frequency_penalty

\n
\n

double

\n

Frequency penalty to reduce repetition.

\n
\n \n
\n
\n
\n
\n
\n

max_tokens

\n
\n

int64

\n

Maximum number of tokens to generate.

\n
\n \n
\n
\n
\n
\n
\n

presence_penalty

\n
\n

double

\n

Presence penalty to reduce repetition.

\n
\n \n
\n
\n
\n
\n
\n

temperature

\n
\n

double

\n

Sampling temperature for the LLM.

\n
\n \n
\n
\n
\n
\n
\n

top_k

\n
\n

int64

\n

Top-k sampling parameter.

\n
\n \n
\n
\n
\n
\n
\n

top_p

\n
\n

double

\n

Top-p (nucleus) sampling parameter.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n

last_used_library_prompt_template_name

\n
\n

string

\n

Name of the last library prompt template used.

\n
\n \n
\n
\n
\n
\n
\n

modified_library_prompt_template

\n
\n

boolean

\n

Whether the library prompt template was modified.

\n
\n \n
\n
\n
\n
\n
\n

output_schema

\n
\n

object

\n

JSON schema describing the expected output format of the LLM judge. Omit for a deterministic evaluator.

\n
\n \n
\n
\n
\n
\n
\n

parsing_type

\n
\n

enum

\n

Output parsing type for a custom LLM judge evaluator. \nAllowed enum values: structured_output,json,keyword_search,typed_questions

\n
\n \n
\n
\n
\n
\n
\n

prompt_template

\n
\n

[object]

\n

List of messages forming the LLM judge prompt template. Omit for a deterministic evaluator.

\n
\n
\n
\n
\n
\n

content

\n
\n

string

\n

Text content of the message.

\n
\n \n
\n
\n
\n
\n
\n

contents

\n
\n

[object]

\n

Multi-part content blocks for the message.

\n
\n
\n
\n
\n
\n

type [required]

\n
\n

string

\n

Content block type.

\n
\n \n
\n
\n
\n
\n
\n

value [required]

\n
\n

object

\n

Value of a prompt message content block.

\n
\n
\n
\n
\n
\n

text

\n
\n

string

\n

Text content of the message block.

\n
\n \n
\n
\n
\n
\n
\n

tool_call

\n
\n

object

\n

A tool call within a prompt message.

\n
\n
\n
\n
\n
\n

arguments

\n
\n

string

\n

JSON-encoded arguments for the tool call.

\n
\n \n
\n
\n
\n
\n
\n

id

\n
\n

string

\n

Unique identifier of the tool call.

\n
\n \n
\n
\n
\n
\n
\n

name

\n
\n

string

\n

Name of the tool being called.

\n
\n \n
\n
\n
\n
\n
\n

type

\n
\n

string

\n

Type of the tool call.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n

tool_call_result

\n
\n

object

\n

A tool call result within a prompt message.

\n
\n
\n
\n
\n
\n

name

\n
\n

string

\n

Name of the tool that produced this result.

\n
\n \n
\n
\n
\n
\n
\n

result

\n
\n

string

\n

The result returned by the tool.

\n
\n \n
\n
\n
\n
\n
\n

tool_id

\n
\n

string

\n

Identifier of the tool call this result corresponds to.

\n
\n \n
\n
\n
\n
\n
\n

type

\n
\n

string

\n

Type of the tool result.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n

role [required]

\n
\n

string

\n

Role of the message author.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n

target_query

\n
\n

string

\n

Query used to extract the target value to evaluate.

\n
\n \n
\n
\n
\n
\n
\n

user_specified_json_post_processing_function

\n
\n

string

\n

User-provided JavaScript function applied to post-process the JSON output of the LLM judge. For a deterministic evaluator it is the evaluator itself: it receives the evaluated span (span scope), {spans} (trace scope), or {session_id, traces} (session scope), and its return value sets the result. A boolean, number, string or object becomes a boolean, score, categorical or JSON metric; null skips the evaluation; and {value, assessment, reasoning, metadata} also sets pass or fail, reasoning, and metadata.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n

llm_provider

\n
\n

object

\n

LLM provider configuration for a custom evaluator.

\n
\n
\n
\n
\n
\n

bedrock

\n
\n

object

\n

AWS Bedrock-specific options for LLM provider configuration.

\n
\n
\n
\n
\n
\n

inference_profile

\n
\n

string

\n

Bedrock inference profile identifier, such as an application inference profile ARN.

\n
\n \n
\n
\n
\n
\n
\n

region

\n
\n

string

\n

AWS region for Bedrock.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n

integration_account_id

\n
\n

string

\n

Integration account identifier.

\n
\n \n
\n
\n
\n
\n
\n

integration_provider

\n
\n

enum

\n

Name of the LLM integration provider. Use deterministic for a code evaluator, which runs llm_judge_config.user_specified_json_post_processing_function instead of calling an LLM. insights_sponsored is returned for evaluators that Datadog manages and cannot be set. \nAllowed enum values: openai,amazon_bedrock,anthropic,azure_openai,vertex_ai,llmproxy,deterministic,typesafe,datadog,datadog_ai_gateway

Show 1 more,insights_sponsored

\n
\n \n
\n
\n
\n
\n
\n

model_name

\n
\n

string

\n

Name of the LLM model. Use javascript for a deterministic evaluator.

\n
\n \n
\n
\n
\n
\n
\n

vertex_ai

\n
\n

object

\n

Google Vertex AI-specific options for LLM provider configuration.

\n
\n
\n
\n
\n
\n

location

\n
\n

string

\n

Google Cloud region.

\n
\n \n
\n
\n
\n
\n
\n

project

\n
\n

string

\n

Google Cloud project ID.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n
\n
\n

target [required]

\n
\n

object

\n

Target application configuration for a custom evaluator.

\n
\n
\n
\n
\n
\n

application_name [required]

\n
\n

string

\n

Name of the ML application this evaluator targets.

\n
\n \n
\n
\n
\n
\n
\n

enabled [required]

\n
\n

boolean

\n

Whether the evaluator is active for the target application.

\n
\n \n
\n
\n
\n
\n
\n

eval_scope

\n
\n

enum

\n

Scope at which to evaluate spans. trace_fan_out requires llm_judge_config.target_query. \nAllowed enum values: span,trace,trace_fan_out,session

\n
\n \n
\n
\n
\n
\n
\n

experiment_project_ids

\n
\n

[string]

\n

Experiment project IDs this evaluator is scoped to.

\n
\n \n
\n
\n
\n
\n
\n

filter

\n
\n

string

\n

Filter expression to select which spans to evaluate.

\n
\n \n
\n
\n
\n
\n
\n

root_spans_only

\n
\n

boolean

\n

When true, only root spans are evaluated.

\n
\n \n
\n
\n
\n
\n
\n

sampling_percentage

\n
\n

double

\n

Percentage of traces to evaluate. Must be greater than 0 and at most 100.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n
\n
\n

id

\n
\n

string

\n

Name of the evaluator. If provided, must match the eval_name path parameter.

\n
\n \n
\n
\n
\n
\n
\n

type [required]

\n
\n

enum

\n

Type of the custom Agent Observability evaluator configuration resource. \nAllowed enum values: evaluator_config

\n
\n \n
\n
\n
\n
" } }, "GetLLMObsAnnotatedInteractionsByTraceIDs": { diff --git a/hugo/data/api/v2/full_spec.yaml b/hugo/data/api/v2/full_spec.yaml index 7a7bd2b981a7..3e54da559eac 100644 --- a/hugo/data/api/v2/full_spec.yaml +++ b/hugo/data/api/v2/full_spec.yaml @@ -71611,16 +71611,18 @@ components: - attributes type: object LLMObsCustomEvalConfigEvalScope: - description: Scope at which to evaluate spans. + description: Scope at which to evaluate spans. `trace_fan_out` requires `llm_judge_config.target_query`. enum: - span - trace + - trace_fan_out - session example: "span" type: string x-enum-varnames: - SPAN - TRACE + - TRACE_FAN_OUT - SESSION LLMObsCustomEvalConfigInferenceParams: description: LLM inference parameters for a custom evaluator. @@ -71657,14 +71659,20 @@ components: type: number type: object LLMObsCustomEvalConfigIntegrationProvider: - description: Name of the LLM integration provider. + description: >- + Name of the LLM integration provider. Use `deterministic` for a code evaluator, which runs `llm_judge_config.user_specified_json_post_processing_function` instead of calling an LLM. `insights_sponsored` is returned for evaluators that Datadog manages and cannot be set. enum: - openai - - amazon-bedrock + - amazon_bedrock - anthropic - - azure-openai - - vertex-ai - - llm-proxy + - azure_openai + - vertex_ai + - llmproxy + - deterministic + - typesafe + - datadog + - datadog_ai_gateway + - insights_sponsored example: "openai" type: string x-enum-varnames: @@ -71674,6 +71682,11 @@ components: - AZURE_OPENAI - VERTEX_AI - LLM_PROXY + - DETERMINISTIC + - TYPESAFE + - DATADOG + - DATADOG_AI_GATEWAY + - INSIGHTS_SPONSORED LLMObsCustomEvalConfigLLMJudgeConfig: description: LLM judge configuration for a custom evaluator. properties: @@ -71698,13 +71711,13 @@ components: type: boolean output_schema: additionalProperties: {} - description: JSON schema describing the expected output format of the LLM judge. + description: JSON schema describing the expected output format of the LLM judge. Omit for a `deterministic` evaluator. nullable: true type: object parsing_type: $ref: "#/components/schemas/LLMObsCustomEvalConfigParsingType" prompt_template: - description: List of messages forming the LLM judge prompt template. + description: List of messages forming the LLM judge prompt template. Omit for a `deterministic` evaluator. items: $ref: "#/components/schemas/LLMObsCustomEvalConfigPromptMessage" type: array @@ -71714,7 +71727,8 @@ components: nullable: true type: string user_specified_json_post_processing_function: - description: User-provided function applied to post-process the JSON output of the LLM judge. + description: >- + User-provided JavaScript function applied to post-process the JSON output of the LLM judge. For a `deterministic` evaluator it is the evaluator itself: it receives the evaluated span (span scope), `{spans}` (trace scope), or `{session_id, traces}` (session scope), and its return value sets the result. A boolean, number, string or object becomes a boolean, score, categorical or JSON metric; `null` skips the evaluation; and `{value, assessment, reasoning, metadata}` also sets pass or fail, reasoning, and metadata. nullable: true type: string required: @@ -71732,7 +71746,7 @@ components: integration_provider: $ref: "#/components/schemas/LLMObsCustomEvalConfigIntegrationProvider" model_name: - description: Name of the LLM model. + description: Name of the LLM model. Use `javascript` for a `deterministic` evaluator. example: "gpt-4o" type: string vertex_ai: @@ -71755,12 +71769,14 @@ components: - structured_output - json - keyword_search + - typed_questions example: "structured_output" type: string x-enum-varnames: - STRUCTURED_OUTPUT - JSON - KEYWORD_SEARCH + - TYPED_QUESTIONS LLMObsCustomEvalConfigPromptContent: description: A content block within a prompt message. properties: diff --git a/hugo/data/changelog/agent-observability.yml b/hugo/data/changelog/agent-observability.yml index e5324f27022a..1e467367673a 100644 --- a/hugo/data/changelog/agent-observability.yml +++ b/hugo/data/changelog/agent-observability.yml @@ -14,3 +14,12 @@ entries: - GetLLMObsAnnotatedInteractions - GetLLMObsAnnotatedInteractionsByTraceIDs title: Remove discriminator and anyOf usage + - change_type: modified + date: '2026-10-30' + link: https://github.com/DataDog/documentation/pull/41240 + operations: + - GetLLMObsCustomEvalConfig + - ListLLMObsCustomEvalConfigs + - UpdateLLMObsCustomEvalConfig + title: Fix LLM Obs custom evaluator provider names and add deterministic + provider