Class: Braintrust::Models::ProjectLogsEvent

Inherits:
BaseModel
  • Object
show all
Defined in:
lib/braintrust/models/project_logs_event.rb

Defined Under Namespace

Classes: Context, LogID, Metrics, SpanAttributes

Instance Attribute Summary collapse

Method Summary

Methods inherited from BaseModel

#[], #initialize, #inspect, #to_h, #to_s

Constructor Details

This class inherits a constructor from Braintrust::BaseModel

Instance Attribute Details

#_xact_id ⇒ String

The transaction id of an event is unique to the network operation that processed the event insertion. Transaction ids are monotonically increasing over time and can be used to retrieve a versioned snapshot of the project logs (see the version parameter)

Returns:

  • (String) 


14
 
# File 'lib/braintrust/models/project_logs_event.rb', line 14

required :_xact_id, String

#context ⇒ Braintrust::Models::ProjectLogsEvent::Context

Context is additional information about the code that produced the project logs event. It is essentially the textual counterpart to metrics. Use the caller_* attributes to track the location in code which produced the project logs event

Returns:



50
 
# File 'lib/braintrust/models/project_logs_event.rb', line 50

optional :context, -> { Braintrust::Models::ProjectLogsEvent::Context }

#created ⇒ DateTime

The timestamp the project logs event was created

Returns:

  • (DateTime) 


19
 
# File 'lib/braintrust/models/project_logs_event.rb', line 19

required :created, DateTime

#error ⇒ Object

The error that occurred, if any.

Returns:

  • (Object) 


55
 
# File 'lib/braintrust/models/project_logs_event.rb', line 55

optional :error, Braintrust::Unknown

#expected ⇒ Object

The ground truth value (an arbitrary, JSON serializable object) that you'd compare to output to determine if your output value is correct or not. Braintrust currently does not compare output to expected for you, since there are so many different ways to do that correctly. Instead, these values are just used to help you navigate while digging into analyses. However, we may later use these values to re-score outputs or fine-tune your models.

Returns:

  • (Object) 


60
 
# File 'lib/braintrust/models/project_logs_event.rb', line 60

optional :expected, Braintrust::Unknown

#id ⇒ String

A unique identifier for the project logs event. If you don't provide one, BrainTrust will generate one for you

Returns:

  • (String) 


9
 
# File 'lib/braintrust/models/project_logs_event.rb', line 9

required :id, String

#input ⇒ Object

The arguments that uniquely define a user input (an arbitrary, JSON serializable object).

Returns:

  • (Object) 


65
 
# File 'lib/braintrust/models/project_logs_event.rb', line 65

optional :input, Braintrust::Unknown

#log_id ⇒ Symbol

A literal 'g' which identifies the log as a project log One of the constants defined in LogID

Returns:

  • (Symbol) 


25
 
# File 'lib/braintrust/models/project_logs_event.rb', line 25

required :log_id, enum: -> { Braintrust::Models::ProjectLogsEvent::LogID }

#metadata ⇒ Hash

A dictionary with additional data about the test example, model outputs, or just about anything else that's relevant, that you can use to help find and analyze examples later. For example, you could log the prompt, example's id, or anything else that would be useful to slice/dice later. The values in metadata can be any JSON-serializable type, but its keys must be strings

Returns:

  • (Hash) 


70
 
# File 'lib/braintrust/models/project_logs_event.rb', line 70

optional :metadata, Hash

#metrics ⇒ Braintrust::Models::ProjectLogsEvent::Metrics

Metrics are numerical measurements tracking the execution of the code that produced the project logs event. Use "start" and "end" to track the time span over which the project logs event was produced

Returns:



75
 
# File 'lib/braintrust/models/project_logs_event.rb', line 75

optional :metrics, -> { Braintrust::Models::ProjectLogsEvent::Metrics }

#org_id ⇒ String

Unique id for the organization that the project belongs under

Returns:

  • (String) 


30
 
# File 'lib/braintrust/models/project_logs_event.rb', line 30

required :org_id, String

#output ⇒ Object

The output of your application, including post-processing (an arbitrary, JSON serializable object), that allows you to determine whether the result is correct or not. For example, in an app that generates SQL queries, the output should be the result of the SQL query generated by the model, not the query itself, because there may be multiple valid queries that answer a single question.

Returns:

  • (Object) 


80
 
# File 'lib/braintrust/models/project_logs_event.rb', line 80

optional :output, Braintrust::Unknown

#project_id ⇒ String

Unique identifier for the project

Returns:

  • (String) 


35
 
# File 'lib/braintrust/models/project_logs_event.rb', line 35

required :project_id, String

#root_span_id ⇒ String

The span_id of the root of the trace this project logs event belongs to

Returns:

  • (String) 


40
 
# File 'lib/braintrust/models/project_logs_event.rb', line 40

required :root_span_id, String

#scores ⇒ Hash

A dictionary of numeric values (between 0 and 1) to log. The scores should give you a variety of signals that help you determine how accurate the outputs are compared to what you expect and diagnose failures. For example, a summarization app might have one score that tells you how accurate the summary is, and another that measures the word similarity between the generated and grouth truth summary. The word similarity score could help you determine whether the summarization was covering similar concepts or not. You can use these scores to help you sort, filter, and compare logs.

Returns:

  • (Hash) 


85
 
# File 'lib/braintrust/models/project_logs_event.rb', line 85

optional :scores, Hash

#span_attributes ⇒ Braintrust::Models::ProjectLogsEvent::SpanAttributes

Human-identifying attributes of the span, such as name, type, etc.

Returns:



90
 
# File 'lib/braintrust/models/project_logs_event.rb', line 90

optional :span_attributes, -> { Braintrust::Models::ProjectLogsEvent::SpanAttributes }

#span_id ⇒ String

A unique identifier used to link different project logs events together as part of a full trace. See the tracing guide for full details on tracing

Returns:

  • (String) 


45
 
# File 'lib/braintrust/models/project_logs_event.rb', line 45

required :span_id, String

#span_parents ⇒ Array<String>

An array of the parent span_ids of this project logs event. This should be empty for the root span of a trace, and should most often contain just one parent element for subspans

Returns:

  • (Array<String>) 


95
 
# File 'lib/braintrust/models/project_logs_event.rb', line 95

optional :span_parents, Braintrust::ArrayOf.new(String)

#tags ⇒ Array<String>

A list of tags to log

Returns:

  • (Array<String>) 


100
 
# File 'lib/braintrust/models/project_logs_event.rb', line 100

optional :tags, Braintrust::ArrayOf.new(String)