Class: Telnyx::Models::AI::Assistants::UpdateAssistant

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

Direct Known Subclasses

VersionUpdateParams

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/assistants/update_assistant.rb', line 210

Instance Attribute Details

#description ⇒ String?

Returns:

  • (String, nil) 


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

optional :description, String

#dynamic_variables ⇒ Hash{Symbol=>Object}?

Map of dynamic variables and their default values

Returns:

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


17
 
# File 'lib/telnyx/models/ai/assistants/update_assistant.rb', line 17

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) 


26
 
# File 'lib/telnyx/models/ai/assistants/update_assistant.rb', line 26

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) 


39
 
# File 'lib/telnyx/models/ai/assistants/update_assistant.rb', line 39

optional :dynamic_variables_webhook_url, String

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

Returns:



44
 
# File 'lib/telnyx/models/ai/assistants/update_assistant.rb', line 44

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

#external_llm ⇒ Telnyx::Models::AI::Assistants::UpdateAssistant::ExternalLlm?

Returns:



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

optional :external_llm, -> { Telnyx::AI::Assistants::UpdateAssistant::ExternalLlm }

#fallback_config ⇒ Telnyx::Models::AI::Assistants::UpdateAssistant::FallbackConfig?

Returns:



54
 
# File 'lib/telnyx/models/ai/assistants/update_assistant.rb', line 54

optional :fallback_config, -> { Telnyx::AI::Assistants::UpdateAssistant::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) 


65
 
# File 'lib/telnyx/models/ai/assistants/update_assistant.rb', line 65

optional :greeting, String

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

Returns:



70
 
# File 'lib/telnyx/models/ai/assistants/update_assistant.rb', line 70

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


77
 
# File 'lib/telnyx/models/ai/assistants/update_assistant.rb', line 77

optional :instructions, String

#integrations ⇒ Array<Telnyx::Models::AI::Assistants::UpdateAssistant::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:



86
87
 
# File 'lib/telnyx/models/ai/assistants/update_assistant.rb', line 86

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

#interruption_settings ⇒ Telnyx::Models::AI::Assistants::UpdateAssistant::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:



98
 
# File 'lib/telnyx/models/ai/assistants/update_assistant.rb', line 98

optional :interruption_settings, -> { Telnyx::AI::Assistants::UpdateAssistant::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) 


109
 
# File 'lib/telnyx/models/ai/assistants/update_assistant.rb', line 109

optional :llm_api_key_ref, String

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

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

Returns:



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

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

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

Returns:



122
 
# File 'lib/telnyx/models/ai/assistants/update_assistant.rb', line 122

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


132
 
# File 'lib/telnyx/models/ai/assistants/update_assistant.rb', line 132

optional :model, String

#name ⇒ String?

Returns:

  • (String, nil) 


137
 
# File 'lib/telnyx/models/ai/assistants/update_assistant.rb', line 137

optional :name, String

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

Returns:



142
 
# File 'lib/telnyx/models/ai/assistants/update_assistant.rb', line 142

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

#post_conversation_settings ⇒ Telnyx::Models::AI::Assistants::UpdateAssistant::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:



153
154
 
# File 'lib/telnyx/models/ai/assistants/update_assistant.rb', line 153

optional :post_conversation_settings,
-> { Telnyx::AI::Assistants::UpdateAssistant::PostConversationSettings }

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

Returns:



159
 
# File 'lib/telnyx/models/ai/assistants/update_assistant.rb', line 159

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

#tags ⇒ Array<String>?

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

Returns:

  • (Array<String>, nil) 


166
 
# File 'lib/telnyx/models/ai/assistants/update_assistant.rb', line 166

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

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

Returns:



171
 
# File 'lib/telnyx/models/ai/assistants/update_assistant.rb', line 171

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

#tool_ids ⇒ Array<String>?

IDs of shared tools to attach to the assistant. New integrations should prefer ‘tool_ids` over inline `tools`.

Returns:

  • (Array<String>, nil) 


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

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

#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:



186
 
# File 'lib/telnyx/models/ai/assistants/update_assistant.rb', line 186

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

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

Returns:



191
 
# File 'lib/telnyx/models/ai/assistants/update_assistant.rb', line 191

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

#version_name ⇒ String?

Human-readable name for the assistant version.

Returns:

  • (String, nil) 


197
 
# File 'lib/telnyx/models/ai/assistants/update_assistant.rb', line 197

optional :version_name, String

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

Returns:



202
 
# File 'lib/telnyx/models/ai/assistants/update_assistant.rb', line 202

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

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

Configuration settings for the assistant’s web widget.

Returns:



208
 
# File 'lib/telnyx/models/ai/assistants/update_assistant.rb', line 208

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

Class Method Details

.values ⇒ Array<Symbol>

Returns:

  • (Array<Symbol>) 



# File 'lib/telnyx/models/ai/assistants/update_assistant.rb', line 349