div score

Synopsis

div score <trace> <name> <value> [flags]
div score <trace> --delete <score>

Sets this key’s score of <name> on a trace. Scoring the same name on the same trace and span again replaces the value and keeps the score’s id. Needs the traces:write scope. Keys from div login have it.

<value> is a number (0.9, 4), true or false, or any other text, which is a category (good, needs-work).

Flags

Flag	Description
--span <span>	Score this span of the trace instead of the whole trace. <span> is a span id, 16 hex characters.
--comment <text>	A note kept with the score, up to 2,000 characters.
--categorical	Read the value as a category even if it looks like a number or a boolean.
--delete	Delete the score named by the second argument, whoever gave it.
--json	Print the score as JSON.
--token <key>	API key to use.
--api-url <url>	API URL to use.

Output

The score’s id on stdout, and what was set on stderr:

9b2c6f1e-4c55-4e0a-8a7e-2f0d1c3b5a61
helpfulness = 0.9 on trace 4bf92f3577b34da6a3ce929d0e0e4736 (new)

Exit codes

Code	Meaning
0	Success.
1	The API rejected the request, such as a trace that does not exist, or trace_scores_cap for a trace with 200 scores.
2	Invalid arguments, such as a missing value.

Examples

div score 4bf92f3577b34da6a3ce929d0e0e4736 helpfulness 0.9
div score 4bf92f3577b34da6a3ce929d0e0e4736 correct false --span 00f067aa0ba902b7
div score 4bf92f3577b34da6a3ce929d0e0e4736 stars 4 --categorical
div score 4bf92f3577b34da6a3ce929d0e0e4736 --delete 9b2c6f1e-4c55-4e0a-8a7e-2f0d1c3b5a61