Class: Telnyx::Models::AIRetrieveConversationHistoriesResponse::Data

Inherits:
Internal::Type::BaseModel show all
Defined in:
lib/telnyx/models/ai_retrieve_conversation_histories_response.rb,
sig/telnyx/models/ai_retrieve_conversation_histories_response.rbs

Defined Under Namespace

Modules: Region

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, 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

#initialize(id:, chunk_index:, chunk_total:, ingested_at:, organization_id:, record_created_at:, record_id:, region:, score:, text:, user_id:, metadata: nil) ⇒ Object

Some parameter documentations has been truncated, see Telnyx::Models::AIRetrieveConversationHistoriesResponse::Data for more details.

A single search result representing one chunk of a conversation history record. Records are split into chunks of up to 480 tokens with 64-token overlap at ingestion time.

Parameters:

  • id (String) —

    Unique chunk identifier.

  • chunk_index (Integer) —

    Zero-based index of this chunk within the parent record.

  • chunk_total (Integer) —

    Total number of chunks the parent record was split into.

  • ingested_at (Time) —

    When the record was chunked, embedded, and indexed (ISO 8601).

  • organization_id (String) —

    Identifier of the organization that owns this record.

  • record_created_at (Time) —

    When the original record was created (ISO 8601).

  • record_id (String) —

    Identifier of the parent record. Multiple chunks from the same record share this

  • region (Symbol, Telnyx::Models::AIRetrieveConversationHistoriesResponse::Data::Region) —

    The region where this record is stored.

  • score (Float) —

    Cosine similarity score between the query vector and this chunk's vector. Higher

  • text (String) —

    The text content of this chunk (up to 480 tokens).

  • user_id (String) —

    Identifier of the user who owns this record.

  • metadata (Hash{Symbol=>Object}) (defaults to: nil) —

    Arbitrary metadata attached to the record at ingestion time. Filterable via filt



31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
 
# File 'lib/telnyx/models/ai_retrieve_conversation_histories_response.rb', line 31

class Data < Telnyx::Internal::Type::BaseModel
  # @!attribute id
  #   Unique chunk identifier.
  #
  #   @return [String]
  required :id, String

  # @!attribute chunk_index
  #   Zero-based index of this chunk within the parent record.
  #
  #   @return [Integer]
  required :chunk_index, Integer

  # @!attribute chunk_total
  #   Total number of chunks the parent record was split into.
  #
  #   @return [Integer]
  required :chunk_total, Integer

  # @!attribute ingested_at
  #   When the record was chunked, embedded, and indexed (ISO 8601).
  #
  #   @return [Time]
  required :ingested_at, Time

  # @!attribute organization_id
  #   Identifier of the organization that owns this record.
  #
  #   @return [String]
  required :organization_id, String

  # @!attribute record_created_at
  #   When the original record was created (ISO 8601).
  #
  #   @return [Time]
  required :record_created_at, Time

  # @!attribute record_id
  #   Identifier of the parent record. Multiple chunks from the same record share this
  #   ID.
  #
  #   @return [String]
  required :record_id, String

  # @!attribute region
  #   The region where this record is stored.
  #
  #   @return [Symbol, Telnyx::Models::AIRetrieveConversationHistoriesResponse::Data::Region]
  required :region, enum: -> { Telnyx::Models::AIRetrieveConversationHistoriesResponse::Data::Region }

  # @!attribute score
  #   Cosine similarity score between the query vector and this chunk's vector. Higher
  #   values indicate greater semantic relevance.
  #
  #   @return [Float]
  required :score, Float

  # @!attribute text
  #   The text content of this chunk (up to 480 tokens).
  #
  #   @return [String]
  required :text, String

  # @!attribute user_id
  #   Identifier of the user who owns this record.
  #
  #   @return [String]
  required :user_id, String

  # @!attribute metadata
  #   Arbitrary metadata attached to the record at ingestion time. Filterable via
  #   filter[field]=value query parameters.
  #
  #   @return [Hash{Symbol=>Object}, nil]
  optional :metadata, Telnyx::Internal::Type::HashOf[Telnyx::Internal::Type::Unknown]

  # @!method initialize(id:, chunk_index:, chunk_total:, ingested_at:, organization_id:, record_created_at:, record_id:, region:, score:, text:, user_id:, metadata: nil)
  #   Some parameter documentations has been truncated, see
  #   {Telnyx::Models::AIRetrieveConversationHistoriesResponse::Data} for more
  #   details.
  #
  #   A single search result representing one chunk of a conversation history record.
  #   Records are split into chunks of up to 480 tokens with 64-token overlap at
  #   ingestion time.
  #
  #   @param id [String] Unique chunk identifier.
  #
  #   @param chunk_index [Integer] Zero-based index of this chunk within the parent record.
  #
  #   @param chunk_total [Integer] Total number of chunks the parent record was split into.
  #
  #   @param ingested_at [Time] When the record was chunked, embedded, and indexed (ISO 8601).
  #
  #   @param organization_id [String] Identifier of the organization that owns this record.
  #
  #   @param record_created_at [Time] When the original record was created (ISO 8601).
  #
  #   @param record_id [String] Identifier of the parent record. Multiple chunks from the same record share this
  #
  #   @param region [Symbol, Telnyx::Models::AIRetrieveConversationHistoriesResponse::Data::Region] The region where this record is stored.
  #
  #   @param score [Float] Cosine similarity score between the query vector and this chunk's vector. Higher
  #
  #   @param text [String] The text content of this chunk (up to 480 tokens).
  #
  #   @param user_id [String] Identifier of the user who owns this record.
  #
  #   @param metadata [Hash{Symbol=>Object}] Arbitrary metadata attached to the record at ingestion time. Filterable via filt

  # The region where this record is stored.
  #
  # @see Telnyx::Models::AIRetrieveConversationHistoriesResponse::Data#region
  module Region
    extend Telnyx::Internal::Type::Enum

    USA = :USA
    DEU = :DEU
    AUS = :AUS
    UAE = :UAE

    # @!method self.values
    #   @return [Array<Symbol>]
  end
end

Instance Attribute Details

#chunk_index ⇒ Integer

Zero-based index of this chunk within the parent record.

Parameters:

  • value (Integer)

Returns:

  • (Integer) 


42
 
# File 'lib/telnyx/models/ai_retrieve_conversation_histories_response.rb', line 42

required :chunk_index, Integer

#chunk_total ⇒ Integer

Total number of chunks the parent record was split into.

Parameters:

  • value (Integer)

Returns:

  • (Integer) 


48
 
# File 'lib/telnyx/models/ai_retrieve_conversation_histories_response.rb', line 48

required :chunk_total, Integer

#id ⇒ String

Unique chunk identifier.

Parameters:

  • value (String)

Returns:

  • (String) 


36
 
# File 'lib/telnyx/models/ai_retrieve_conversation_histories_response.rb', line 36

required :id, String

#ingested_at ⇒ Time

When the record was chunked, embedded, and indexed (ISO 8601).

Parameters:

  • value (Time)

Returns:

  • (Time) 


54
 
# File 'lib/telnyx/models/ai_retrieve_conversation_histories_response.rb', line 54

required :ingested_at, Time

#metadata ⇒ Hash{Symbol=>Object}?

Arbitrary metadata attached to the record at ingestion time. Filterable via filter=value query parameters.

Parameters:

  • (::Hash[Symbol, top])

Returns:

  • (Hash{Symbol=>Object}, nil) 


105
 
# File 'lib/telnyx/models/ai_retrieve_conversation_histories_response.rb', line 105

optional :metadata, Telnyx::Internal::Type::HashOf[Telnyx::Internal::Type::Unknown]

#organization_id ⇒ String

Identifier of the organization that owns this record.

Parameters:

  • value (String)

Returns:

  • (String) 


60
 
# File 'lib/telnyx/models/ai_retrieve_conversation_histories_response.rb', line 60

required :organization_id, String

#record_created_at ⇒ Time

When the original record was created (ISO 8601).

Parameters:

  • value (Time)

Returns:

  • (Time) 


66
 
# File 'lib/telnyx/models/ai_retrieve_conversation_histories_response.rb', line 66

required :record_created_at, Time

#record_id ⇒ String

Identifier of the parent record. Multiple chunks from the same record share this ID.

Parameters:

  • value (String)

Returns:

  • (String) 


73
 
# File 'lib/telnyx/models/ai_retrieve_conversation_histories_response.rb', line 73

required :record_id, String

#region ⇒ Symbol, Telnyx::Models::AIRetrieveConversationHistoriesResponse::Data::Region

The region where this record is stored.

Parameters:

  • value (Telnyx::Models::AIRetrieveConversationHistoriesResponse::Data::region)

Returns:



79
 
# File 'lib/telnyx/models/ai_retrieve_conversation_histories_response.rb', line 79

required :region, enum: -> { Telnyx::Models::AIRetrieveConversationHistoriesResponse::Data::Region }

#score ⇒ Float

Cosine similarity score between the query vector and this chunk's vector. Higher values indicate greater semantic relevance.

Parameters:

  • value (Float)

Returns:

  • (Float) 


86
 
# File 'lib/telnyx/models/ai_retrieve_conversation_histories_response.rb', line 86

required :score, Float

#text ⇒ String

The text content of this chunk (up to 480 tokens).

Parameters:

  • value (String)

Returns:

  • (String) 


92
 
# File 'lib/telnyx/models/ai_retrieve_conversation_histories_response.rb', line 92

required :text, String

#user_id ⇒ String

Identifier of the user who owns this record.

Parameters:

  • value (String)

Returns:

  • (String) 


98
 
# File 'lib/telnyx/models/ai_retrieve_conversation_histories_response.rb', line 98

required :user_id, String

Instance Method Details

#to_hash ⇒ {

Returns:

  • ({) 


82
 
# File 'sig/telnyx/models/ai_retrieve_conversation_histories_response.rbs', line 82

def to_hash: -> {