Class: Telnyx::Models::AI::InferenceEmbedding

Inherits:
Internal::Type::BaseModel show all
Defined in:
lib/telnyx/models/ai/inference_embedding.rb

Overview

See Also:

Defined Under Namespace

Classes: ExternalLlm, FallbackConfig, Integration, InterruptionSettings, McpServer, PostConversationSettings

Instance Attribute Summary collapse

Class Method 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:, allowed_tools: nil) ⇒ Object

Some parameter documentations has been truncated, see McpServer for more details.

Reference to an MCP server attached to an assistant. Create and manage MCP servers with the ‘/ai/mcp_servers` endpoints, then attach them to assistants by ID.

Parameters:

  • id (String) —

    ID of the MCP server to attach. This must be the ‘id` of an MCP server returned

  • allowed_tools (Array<String>) (defaults to: nil) —

    Optional per-assistant allowlist of MCP tool names. When omitted, the assistant




# File 'lib/telnyx/models/ai/inference_embedding.rb', line 235

Instance Attribute Details

#created_at ⇒ Time

Returns:

  • (Time) 


16
 
# File 'lib/telnyx/models/ai/inference_embedding.rb', line 16

required :created_at, Time

#description ⇒ String?

Returns:

  • (String, nil) 


43
 
# File 'lib/telnyx/models/ai/inference_embedding.rb', line 43

optional :description, String

#dynamic_variables ⇒ Hash{Symbol=>Object}?

Map of dynamic variables and their values

Returns:

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


49
 
# File 'lib/telnyx/models/ai/inference_embedding.rb', line 49

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

#dynamic_variables_webhook_timeout_ms ⇒ Integer?

Timeout in milliseconds for the dynamic variables webhook. Must be between 1 and 10000 ms. If the webhook does not respond within this timeout, the call proceeds with default values. See the [dynamic variables guide](developers.telnyx.com/docs/inference/ai-assistants/dynamic-variables).

Returns:

  • (Integer, nil) 


58
 
# File 'lib/telnyx/models/ai/inference_embedding.rb', line 58

optional :dynamic_variables_webhook_timeout_ms, Integer

#dynamic_variables_webhook_url ⇒ String?

If ‘dynamic_variables_webhook_url` is set, Telnyx sends a POST request to this URL at the start of the conversation to resolve dynamic variables. Gotcha: the webhook response must wrap variables under a top-level `dynamic_variables` object, e.g. `{“customer_name”: “Jane”}`. Returning a flat object will be ignored and variables will fall back to their defaults. See the [dynamic variables guide](developers.telnyx.com/docs/inference/ai-assistants/dynamic-variables) for the full request/response format and timeout behavior.

Returns:

  • (String, nil) 


71
 
# File 'lib/telnyx/models/ai/inference_embedding.rb', line 71

optional :dynamic_variables_webhook_url, String

#enabled_features ⇒ Array<Symbol, Telnyx::Models::AI::EnabledFeatures>?

Returns:



76
 
# File 'lib/telnyx/models/ai/inference_embedding.rb', line 76

optional :enabled_features, -> { Telnyx::Internal::Type::ArrayOf[enum: Telnyx::AI::EnabledFeatures] }

#external_llm ⇒ Telnyx::Models::AI::InferenceEmbedding::ExternalLlm?

Returns:



81
 
# File 'lib/telnyx/models/ai/inference_embedding.rb', line 81

optional :external_llm, -> { Telnyx::AI::InferenceEmbedding::ExternalLlm }

#fallback_config ⇒ Telnyx::Models::AI::InferenceEmbedding::FallbackConfig?

Returns:



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

optional :fallback_config, -> { Telnyx::AI::InferenceEmbedding::FallbackConfig }

#greeting ⇒ String?

Text that the assistant will use to start the conversation. This may be templated with [dynamic variables](developers.telnyx.com/docs/inference/ai-assistants/dynamic-variables). Use an empty string to have the assistant wait for the user to speak first. Use the special value ‘<assistant-speaks-first-with-model-generated-message>` to have the assistant generate the greeting based on the system instructions.

Returns:

  • (String, nil) 


97
 
# File 'lib/telnyx/models/ai/inference_embedding.rb', line 97

optional :greeting, String

#id ⇒ String

Returns:

  • (String) 


11
 
# File 'lib/telnyx/models/ai/inference_embedding.rb', line 11

required :id, String

#import_metadata ⇒ Telnyx::Models::AI::ImportMetadata?

Returns:



102
 
# File 'lib/telnyx/models/ai/inference_embedding.rb', line 102

optional :import_metadata, -> { Telnyx::AI::ImportMetadata }

#insight_settings ⇒ Telnyx::Models::AI::InsightSettings?

Returns:



107
 
# File 'lib/telnyx/models/ai/inference_embedding.rb', line 107

optional :insight_settings, -> { Telnyx::AI::InsightSettings }

#instructions ⇒ String

System instructions for the assistant. These may be templated with [dynamic variables](developers.telnyx.com/docs/inference/ai-assistants/dynamic-variables)

Returns:

  • (String) 


23
 
# File 'lib/telnyx/models/ai/inference_embedding.rb', line 23

required :instructions, String

#integrations ⇒ Array<Telnyx::Models::AI::InferenceEmbedding::Integration>?

Connected integrations attached to the assistant. The catalog of available integrations is at ‘/ai/integrations`; the user’s connected integrations are at ‘/ai/integrations/connections`. Each item references a catalog integration by `integration_id`.

Returns:



116
117
 
# File 'lib/telnyx/models/ai/inference_embedding.rb', line 116

optional :integrations,
-> { Telnyx::Internal::Type::ArrayOf[Telnyx::AI::InferenceEmbedding::Integration] }

#interruption_settings ⇒ Telnyx::Models::AI::InferenceEmbedding::InterruptionSettings?

Settings for interruptions and how the assistant decides the user has finished speaking. These timings are most relevant when using non turn-taking transcription models. For turn-taking models like ‘deepgram/flux`, end-of-turn behavior is controlled by the transcription end-of-turn settings under `transcription.settings` (`eot_threshold`, `eot_timeout_ms`, `eager_eot_threshold`).

Returns:



128
 
# File 'lib/telnyx/models/ai/inference_embedding.rb', line 128

optional :interruption_settings, -> { Telnyx::AI::InferenceEmbedding::InterruptionSettings }

#llm_api_key_ref ⇒ String?

This is only needed when using third-party inference providers selected by ‘model`. The `identifier` for an integration secret [/v2/integration_secrets](developers.telnyx.com/api-reference/integration-secrets/create-a-secret) that refers to your LLM provider’s API key. For bring-your-own endpoint authentication, use ‘external_llm.llm_api_key_ref` instead. Warning: Free plans are unlikely to work with this integration.

Returns:

  • (String, nil) 


139
 
# File 'lib/telnyx/models/ai/inference_embedding.rb', line 139

optional :llm_api_key_ref, String

#mcp_servers ⇒ Array<Telnyx::Models::AI::InferenceEmbedding::McpServer>?

MCP servers attached to the assistant. Create MCP servers with ‘/ai/mcp_servers`, then reference them by `id` here.

Returns:



146
 
# File 'lib/telnyx/models/ai/inference_embedding.rb', line 146

optional :mcp_servers, -> { Telnyx::Internal::Type::ArrayOf[Telnyx::AI::InferenceEmbedding::McpServer] }

#messaging_settings ⇒ Telnyx::Models::AI::MessagingSettings?

Returns:



151
 
# File 'lib/telnyx/models/ai/inference_embedding.rb', line 151

optional :messaging_settings, -> { Telnyx::AI::MessagingSettings }

#model ⇒ String

ID of the model to use when ‘external_llm` is not set. You can use the [Get models API](developers.telnyx.com/api-reference/chat/get-available-models) to see available models. If `external_llm` is provided, the assistant uses `external_llm` instead of this field. If neither `model` nor `external_llm` is provided, Telnyx applies the default model.

Returns:

  • (String) 


33
 
# File 'lib/telnyx/models/ai/inference_embedding.rb', line 33

required :model, String

#name ⇒ String

Returns:

  • (String) 


38
 
# File 'lib/telnyx/models/ai/inference_embedding.rb', line 38

required :name, String

#observability_settings ⇒ Telnyx::Models::AI::Observability?

Returns:



156
 
# File 'lib/telnyx/models/ai/inference_embedding.rb', line 156

optional :observability_settings, -> { Telnyx::AI::Observability }

#post_conversation_settings ⇒ Telnyx::Models::AI::InferenceEmbedding::PostConversationSettings?

Configuration for post-conversation processing. When enabled, the assistant receives one additional LLM turn after the conversation ends, allowing it to execute tool calls such as logging to a CRM or sending a summary. The assistant can execute multiple parallel or sequential tools during this phase. Telephony-control tools (e.g. hangup, transfer) are unavailable post-conversation. Beta feature.

Returns:



167
 
# File 'lib/telnyx/models/ai/inference_embedding.rb', line 167

optional :post_conversation_settings, -> { Telnyx::AI::InferenceEmbedding::PostConversationSettings }

#privacy_settings ⇒ Telnyx::Models::AI::PrivacySettings?

Returns:



172
 
# File 'lib/telnyx/models/ai/inference_embedding.rb', line 172

optional :privacy_settings, -> { Telnyx::AI::PrivacySettings }

#related_mission_ids ⇒ Array<String>?

IDs of missions related to this assistant.

Returns:

  • (Array<String>, nil) 


178
 
# File 'lib/telnyx/models/ai/inference_embedding.rb', line 178

optional :related_mission_ids, Telnyx::Internal::Type::ArrayOf[String]

#tags ⇒ Array<String>?

Tags associated with the assistant. Tags can also be managed with the assistant tag endpoints.

Returns:

  • (Array<String>, nil) 


185
 
# File 'lib/telnyx/models/ai/inference_embedding.rb', line 185

optional :tags, Telnyx::Internal::Type::ArrayOf[String]

#telephony_settings ⇒ Telnyx::Models::AI::TelephonySettings?

Returns:



190
 
# File 'lib/telnyx/models/ai/inference_embedding.rb', line 190

optional :telephony_settings, -> { Telnyx::AI::TelephonySettings }

#tools ⇒ Array<Telnyx::Models::AI::InferenceEmbeddingWebhookToolParams, Telnyx::Models::AI::RetrievalTool, Telnyx::Models::AI::AssistantTool::Handoff, Telnyx::Models::AI::HangupTool, Telnyx::Models::AI::AssistantTool::Transfer, Telnyx::Models::AI::AssistantTool::Invite, Telnyx::Models::AI::AssistantTool::Refer, Telnyx::Models::AI::AssistantTool::SendDtmf, Telnyx::Models::AI::AssistantTool::SendMessage, Telnyx::Models::AI::AssistantTool::SkipTurn>?

Deprecated for new integrations. Inline tool definitions available to the assistant. Prefer ‘tool_ids` to attach shared tools created with the AI Tools endpoints.

Returns:



198
 
# File 'lib/telnyx/models/ai/inference_embedding.rb', line 198

optional :tools, -> { Telnyx::Internal::Type::ArrayOf[union: Telnyx::AI::AssistantTool] }

#transcription ⇒ Telnyx::Models::AI::TranscriptionSettings?

Returns:



203
 
# File 'lib/telnyx/models/ai/inference_embedding.rb', line 203

optional :transcription, -> { Telnyx::AI::TranscriptionSettings }

#version_created_at ⇒ Time?

Timestamp when this assistant version was created.

Returns:

  • (Time, nil) 


209
 
# File 'lib/telnyx/models/ai/inference_embedding.rb', line 209

optional :version_created_at, Time

#version_id ⇒ String?

Identifier for the assistant version returned by version-aware assistant endpoints.

Returns:

  • (String, nil) 


216
 
# File 'lib/telnyx/models/ai/inference_embedding.rb', line 216

optional :version_id, String

#version_name ⇒ String?

Human-readable name for the assistant version.

Returns:

  • (String, nil) 


222
 
# File 'lib/telnyx/models/ai/inference_embedding.rb', line 222

optional :version_name, String

#voice_settings ⇒ Telnyx::Models::AI::VoiceSettings?

Returns:



227
 
# File 'lib/telnyx/models/ai/inference_embedding.rb', line 227

optional :voice_settings, -> { Telnyx::AI::VoiceSettings }

#widget_settings ⇒ Telnyx::Models::AI::WidgetSettings?

Configuration settings for the assistant’s web widget.

Returns:



233
 
# File 'lib/telnyx/models/ai/inference_embedding.rb', line 233

optional :widget_settings, -> { Telnyx::AI::WidgetSettings }

Class Method Details

.values ⇒ Array<Symbol>

Returns:

  • (Array<Symbol>) 



# File 'lib/telnyx/models/ai/inference_embedding.rb', line 384