Class: Anthropic::Models::Beta::BetaMessage

Inherits:
Internal::Type::BaseModel show all
Defined in:
lib/anthropic/models/beta/beta_message.rb

Overview

See Also:

Instance Attribute Summary collapse

Instance Method Summary collapse

Methods inherited from Internal::Type::BaseModel

==, #==, #[], coerce, #deconstruct_keys, #deep_to_h, dump, fields, hash, #hash, inherited, #initialize, inspect, #inspect, known_fields, optional, recursively_to_h, required, #to_h, #to_json, #to_s, to_sorbet_type, #to_yaml

Methods included from Internal::Type::Converter

#coerce, coerce, #dump, dump, #inspect, inspect, meta_info, new_coerce_state, type_info

Methods included from Internal::Util::SorbetRuntimeSupport

#const_missing, #define_sorbet_constant!, #sorbet_constant_defined?, #to_sorbet_type, to_sorbet_type

Constructor Details

This class inherits a constructor from Anthropic::Internal::Type::BaseModel

Instance Attribute Details

#container ⇒ Anthropic::Models::Beta::BetaContainer?

Information about the container used in the request (for the code execution tool)

Returns:



23
 
# File 'lib/anthropic/models/beta/beta_message.rb', line 23

required :container, -> { Anthropic::Beta::BetaContainer }, nil?: true

#content ⇒ Array<Anthropic::Models::Beta::BetaTextBlock, Anthropic::Models::Beta::BetaThinkingBlock, Anthropic::Models::Beta::BetaRedactedThinkingBlock, Anthropic::Models::Beta::BetaToolUseBlock, Anthropic::Models::Beta::BetaServerToolUseBlock, Anthropic::Models::Beta::BetaWebSearchToolResultBlock, Anthropic::Models::Beta::BetaWebFetchToolResultBlock, Anthropic::Models::Beta::BetaAdvisorToolResultBlock, Anthropic::Models::Beta::BetaCodeExecutionToolResultBlock, Anthropic::Models::Beta::BetaBashCodeExecutionToolResultBlock, Anthropic::Models::Beta::BetaTextEditorCodeExecutionToolResultBlock, Anthropic::Models::Beta::BetaToolSearchToolResultBlock, Anthropic::Models::Beta::BetaMCPToolUseBlock, Anthropic::Models::Beta::BetaMCPToolResultBlock, Anthropic::Models::Beta::BetaContainerUploadBlock, Anthropic::Models::Beta::BetaCompactionBlock>

Content generated by the model.

This is an array of content blocks, each of which has a ‘type` that determines its shape.

Example:

“‘json

{ “type”: “text”, “text”: “Hi, I’m Claude.” }

“‘

If the request input ‘messages` ended with an `assistant` turn, then the response `content` will continue directly from that last turn. You can use this to constrain the model’s output.

For example, if the input ‘messages` were:

“‘json [

{
  "role": "user",
  "content": "What's the Greek name for Sun? (A) Sol (B) Helios (C) Sun"
},
{ "role": "assistant", "content": "The best answer is (" }

] “‘

Then the response ‘content` might be:

“‘json

{ “type”: “text”, “text”: “B)” }

“‘

Returns:



60
 
# File 'lib/anthropic/models/beta/beta_message.rb', line 60

required :content, -> { Anthropic::Internal::Type::ArrayOf[union: Anthropic::Beta::BetaContentBlock] }

#context_management ⇒ Anthropic::Models::Beta::BetaContextManagementResponse?

Context management response.

Information about context management strategies applied during the request.

Returns:



80
 
# File 'lib/anthropic/models/beta/beta_message.rb', line 80

required :context_management, -> { Anthropic::Beta::BetaContextManagementResponse }, nil?: true

#id ⇒ String

Unique object identifier.

The format and length of IDs may change over time.

Returns:

  • (String) 


16
 
# File 'lib/anthropic/models/beta/beta_message.rb', line 16

required :id, String

#model ⇒ Symbol, ...

The model that will complete your prompt.nnSee [models](docs.anthropic.com/en/docs/models-overview) for additional details and options.

Returns:



88
 
# File 'lib/anthropic/models/beta/beta_message.rb', line 88

required :model, union: -> { Anthropic::Model }

#role ⇒ Symbol, :assistant

Conversational role of the generated message.

This will always be ‘“assistant”`.

Returns:

  • (Symbol, :assistant) 


96
 
# File 'lib/anthropic/models/beta/beta_message.rb', line 96

required :role, const: :assistant

#stop_details ⇒ Anthropic::Models::Beta::BetaRefusalStopDetails?

Structured information about a refusal.

Returns:



102
 
# File 'lib/anthropic/models/beta/beta_message.rb', line 102

required :stop_details, -> { Anthropic::Beta::BetaRefusalStopDetails }, nil?: true

#stop_reason ⇒ Symbol, ...

The reason that we stopped.

This may be one the following values:

  • ‘“end_turn”`: the model reached a natural stopping point

  • ‘“max_tokens”`: we exceeded the requested `max_tokens` or the model’s maximum

  • ‘“stop_sequence”`: one of your provided custom `stop_sequences` was generated

  • ‘“tool_use”`: the model invoked one or more tools

  • ‘“pause_turn”`: we paused a long-running turn. You may provide the response back as-is in a subsequent request to let the model continue.

  • ‘“refusal”`: when streaming classifiers intervene to handle potential policy violations

In non-streaming mode this value is always non-null. In streaming mode, it is null in the ‘message_start` event and non-null otherwise.

Returns:



122
 
# File 'lib/anthropic/models/beta/beta_message.rb', line 122

required :stop_reason, enum: -> { Anthropic::Beta::BetaStopReason }, nil?: true

#stop_sequence ⇒ String?

Which custom stop sequence was generated, if any.

This value will be a non-null string if one of your custom stop sequences was generated.

Returns:

  • (String, nil) 


131
 
# File 'lib/anthropic/models/beta/beta_message.rb', line 131

required :stop_sequence, String, nil?: true

#type ⇒ Symbol, :message

Object type.

For Messages, this is always ‘“message”`.

Returns:

  • (Symbol, :message) 


139
 
# File 'lib/anthropic/models/beta/beta_message.rb', line 139

required :type, const: :message

#usage ⇒ Anthropic::Models::Beta::BetaUsage

Billing and rate-limit usage.

Anthropic’s API bills and rate-limits by token counts, as tokens represent the underlying cost to our systems.

Under the hood, the API transforms requests into a format suitable for the model. The model’s output then goes through a parsing stage before becoming an API response. As a result, the token counts in ‘usage` will not match one-to-one with the exact visible content of an API request or response.

For example, ‘output_tokens` will be non-zero, even for an empty string response from Claude.

Total input tokens in a request is the summation of ‘input_tokens`, `cache_creation_input_tokens`, and `cache_read_input_tokens`.

Returns:



159
 
# File 'lib/anthropic/models/beta/beta_message.rb', line 159

required :usage, -> { Anthropic::Beta::BetaUsage }

Instance Method Details

#parsed_output ⇒ Object?

parsed value of response when a JSON output schema object has been specified via :output_format

Returns:

  • (Object, nil) 


65
66
67
68
69
70
71
72
 
# File 'lib/anthropic/models/beta/beta_message.rb', line 65

def parsed_output
  case content
  in [*, {parsed:}]
    parsed
  else
    nil
  end
end