Class: Google::Apis::AiplatformV1::GoogleCloudAiplatformV1Candidate

Inherits:
Object
  • Object
show all
Includes:
Core::Hashable, Core::JsonObjectSupport
Defined in:
lib/google/apis/aiplatform_v1/classes.rb,
lib/google/apis/aiplatform_v1/representations.rb,
lib/google/apis/aiplatform_v1/representations.rb

Overview

A response candidate generated from the model.

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(**args) ⇒ GoogleCloudAiplatformV1Candidate

Returns a new instance of GoogleCloudAiplatformV1Candidate.



3673
3674
3675
 
# File 'lib/google/apis/aiplatform_v1/classes.rb', line 3673

def initialize(**args)
   update!(**args)
end

Instance Attribute Details

#avg_logprobs ⇒ Float

Output only. The average log probability of the tokens in this candidate. This is a length-normalized score that can be used to compare the quality of candidates of different lengths. A higher average log probability suggests a more confident and coherent response. Corresponds to the JSON property avgLogprobs

Returns:

  • (Float) 


3611
3612
3613
 
# File 'lib/google/apis/aiplatform_v1/classes.rb', line 3611

def avg_logprobs
  @avg_logprobs
end

#citation_metadata ⇒ Google::Apis::AiplatformV1::GoogleCloudAiplatformV1CitationMetadata

A collection of citations that apply to a piece of generated content. Corresponds to the JSON property citationMetadata

Returns:



3616
3617
3618
 
# File 'lib/google/apis/aiplatform_v1/classes.rb', line 3616

def citation_metadata
  @citation_metadata
end

#content ⇒ Google::Apis::AiplatformV1::GoogleCloudAiplatformV1Content

The structured data content of a message. A Content message contains a role field, which indicates the producer of the content, and a parts field, which contains the multi-part data of the message. Corresponds to the JSON property content

Returns:



3623
3624
3625
 
# File 'lib/google/apis/aiplatform_v1/classes.rb', line 3623

def content
  @content
end

#finish_message ⇒ String

Output only. Describes the reason the model stopped generating tokens in more detail. This field is returned only when finish_reason is set. Corresponds to the JSON property finishMessage

Returns:

  • (String) 


3629
3630
3631
 
# File 'lib/google/apis/aiplatform_v1/classes.rb', line 3629

def finish_message
  @finish_message
end

#finish_reason ⇒ String

Output only. The reason why the model stopped generating tokens. If empty, the model has not stopped generating. Corresponds to the JSON property finishReason

Returns:

  • (String) 


3635
3636
3637
 
# File 'lib/google/apis/aiplatform_v1/classes.rb', line 3635

def finish_reason
  @finish_reason
end

#grounding_metadata ⇒ Google::Apis::AiplatformV1::GoogleCloudAiplatformV1GroundingMetadata

Information about the sources that support the content of a response. When grounding is enabled, the model returns citations for claims in the response. This object contains the retrieved sources. Corresponds to the JSON property groundingMetadata

Returns:



3642
3643
3644
 
# File 'lib/google/apis/aiplatform_v1/classes.rb', line 3642

def grounding_metadata
  @grounding_metadata
end

#index ⇒ Fixnum

Output only. The 0-based index of this candidate in the list of generated responses. This is useful for distinguishing between multiple candidates when candidate_count > 1. Corresponds to the JSON property index

Returns:

  • (Fixnum) 


3649
3650
3651
 
# File 'lib/google/apis/aiplatform_v1/classes.rb', line 3649

def index
  @index
end

#logprobs_result ⇒ Google::Apis::AiplatformV1::GoogleCloudAiplatformV1LogprobsResult

The log probabilities of the tokens generated by the model. This is useful for understanding the model's confidence in its predictions and for debugging. For example, you can use log probabilities to identify when the model is making a less confident prediction or to explore alternative responses that the model considered. A low log probability can also indicate that the model is " hallucinating" or generating factually incorrect information. Corresponds to the JSON property logprobsResult

Returns:



3659
3660
3661
 
# File 'lib/google/apis/aiplatform_v1/classes.rb', line 3659

def logprobs_result
  @logprobs_result
end

#safety_ratings ⇒ Array<Google::Apis::AiplatformV1::GoogleCloudAiplatformV1SafetyRating>

Output only. A list of ratings for the safety of a response candidate. There is at most one rating per category. Corresponds to the JSON property safetyRatings

Returns:



3665
3666
3667
 
# File 'lib/google/apis/aiplatform_v1/classes.rb', line 3665

def safety_ratings
  @safety_ratings
end

#url_context_metadata ⇒ Google::Apis::AiplatformV1::GoogleCloudAiplatformV1UrlContextMetadata

Metadata returned when the model uses the url_context tool to get information from a user-provided URL. Corresponds to the JSON property urlContextMetadata

Returns:



3671
3672
3673
 
# File 'lib/google/apis/aiplatform_v1/classes.rb', line 3671

def url_context_metadata
  @url_context_metadata
end

Instance Method Details

#update!(**args) ⇒ Object

Update properties of this object



3678
3679
3680
3681
3682
3683
3684
3685
3686
3687
3688
3689
 
# File 'lib/google/apis/aiplatform_v1/classes.rb', line 3678

def update!(**args)
  @avg_logprobs = args[:avg_logprobs] if args.key?(:avg_logprobs)
  @citation_metadata = args[:citation_metadata] if args.key?(:citation_metadata)
  @content = args[:content] if args.key?(:content)
  @finish_message = args[:finish_message] if args.key?(:finish_message)
  @finish_reason = args[:finish_reason] if args.key?(:finish_reason)
  @grounding_metadata = args[:grounding_metadata] if args.key?(:grounding_metadata)
  @index = args[:index] if args.key?(:index)
  @logprobs_result = args[:logprobs_result] if args.key?(:logprobs_result)
  @safety_ratings = args[:safety_ratings] if args.key?(:safety_ratings)
  @url_context_metadata = args[:url_context_metadata] if args.key?(:url_context_metadata)
end