Class: Telnyx::Resources::AI

Inherits:
Object
  • Object
show all
Defined in:
lib/telnyx/resources/ai.rb,
lib/telnyx/resources/ai/chat.rb,
lib/telnyx/resources/ai/audio.rb,
lib/telnyx/resources/ai/clusters.rb,
lib/telnyx/resources/ai/assistants.rb,
lib/telnyx/resources/ai/embeddings.rb,
lib/telnyx/resources/ai/fine_tuning.rb,
lib/telnyx/resources/ai/mcp_servers.rb,
lib/telnyx/resources/ai/integrations.rb,
lib/telnyx/resources/ai/conversations.rb,
lib/telnyx/resources/ai/assistants/tests.rb,
lib/telnyx/resources/ai/assistants/tools.rb,
lib/telnyx/resources/ai/fine_tuning/jobs.rb,
lib/telnyx/resources/ai/embeddings/buckets.rb,
lib/telnyx/resources/ai/assistants/versions.rb,
lib/telnyx/resources/ai/assistants/tests/runs.rb,
lib/telnyx/resources/ai/conversations/insights.rb,
lib/telnyx/resources/ai/conversations/messages.rb,
lib/telnyx/resources/ai/integrations/connections.rb,
lib/telnyx/resources/ai/assistants/canary_deploys.rb,
lib/telnyx/resources/ai/assistants/scheduled_events.rb,
lib/telnyx/resources/ai/assistants/tests/test_suites.rb,
lib/telnyx/resources/ai/conversations/insight_groups.rb,
lib/telnyx/resources/ai/assistants/tests/test_suites/runs.rb,
lib/telnyx/resources/ai/conversations/insight_groups/insights.rb

Defined Under Namespace

Classes: Assistants, Audio, Chat, Clusters, Conversations, Embeddings, FineTuning, Integrations, McpServers

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(client:) ⇒ AI

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.

Returns a new instance of AI.

Parameters:



94
95
96
97
98
99
100
101
102
103
104
105
 
# File 'lib/telnyx/resources/ai.rb', line 94

def initialize(client:)
  @client = client
  @assistants = Telnyx::Resources::AI::Assistants.new(client: client)
  @audio = Telnyx::Resources::AI::Audio.new(client: client)
  @chat = Telnyx::Resources::AI::Chat.new(client: client)
  @clusters = Telnyx::Resources::AI::Clusters.new(client: client)
  @conversations = Telnyx::Resources::AI::Conversations.new(client: client)
  @embeddings = Telnyx::Resources::AI::Embeddings.new(client: client)
  @fine_tuning = Telnyx::Resources::AI::FineTuning.new(client: client)
  @integrations = Telnyx::Resources::AI::Integrations.new(client: client)
  @mcp_servers = Telnyx::Resources::AI::McpServers.new(client: client)
end

Instance Attribute Details

#assistants ⇒ Telnyx::Resources::AI::Assistants (readonly)

Returns:



7
8
9
 
# File 'lib/telnyx/resources/ai.rb', line 7

def assistants
  @assistants
end

#audio ⇒ Telnyx::Resources::AI::Audio (readonly)

Returns:



10
11
12
 
# File 'lib/telnyx/resources/ai.rb', line 10

def audio
  @audio
end

#chat ⇒ Telnyx::Resources::AI::Chat (readonly)

Returns:



13
14
15
 
# File 'lib/telnyx/resources/ai.rb', line 13

def chat
  @chat
end

#clusters ⇒ Telnyx::Resources::AI::Clusters (readonly)

Returns:



16
17
18
 
# File 'lib/telnyx/resources/ai.rb', line 16

def clusters
  @clusters
end

#conversations ⇒ Telnyx::Resources::AI::Conversations (readonly)

Returns:



19
20
21
 
# File 'lib/telnyx/resources/ai.rb', line 19

def conversations
  @conversations
end

#embeddings ⇒ Telnyx::Resources::AI::Embeddings (readonly)

Returns:



22
23
24
 
# File 'lib/telnyx/resources/ai.rb', line 22

def embeddings
  @embeddings
end

#fine_tuning ⇒ Telnyx::Resources::AI::FineTuning (readonly)

Returns:



25
26
27
 
# File 'lib/telnyx/resources/ai.rb', line 25

def fine_tuning
  @fine_tuning
end

#integrations ⇒ Telnyx::Resources::AI::Integrations (readonly)

Returns:



28
29
30
 
# File 'lib/telnyx/resources/ai.rb', line 28

def integrations
  @integrations
end

#mcp_servers ⇒ Telnyx::Resources::AI::McpServers (readonly)

Returns:



31
32
33
 
# File 'lib/telnyx/resources/ai.rb', line 31

def mcp_servers
  @mcp_servers
end

Instance Method Details

#retrieve_models(request_options: {}) ⇒ Telnyx::Models::AIRetrieveModelsResponse

This endpoint returns a list of Open Source and OpenAI models that are available for use. <br /><br /> Note: Model ‘id`’s will be in the form ‘source/model_name`. For example `openai/gpt-4` or `mistralai/Mistral-7B-Instruct-v0.1` consistent with HuggingFace naming conventions.

Parameters:

Returns:

See Also:



46
47
48
49
50
51
52
53
 
# File 'lib/telnyx/resources/ai.rb', line 46

def retrieve_models(params = {})
  @client.request(
    method: :get,
    path: "ai/models",
    model: Telnyx::Models::AIRetrieveModelsResponse,
    options: params[:request_options]
  )
end

#summarize(bucket:, filename:, system_prompt: nil, request_options: {}) ⇒ Telnyx::Models::AISummarizeResponse

Generate a summary of a file’s contents.

Supports the following text formats:

  • PDF, HTML, txt, json, csv

Supports the following media formats (billed for both the transcription and summary):

  • flac, mp3, mp4, mpeg, mpga, m4a, ogg, wav, or webm

  • Up to 100 MB

Parameters:

  • bucket (String) —

    The name of the bucket that contains the file to be summarized.

  • filename (String) —

    The name of the file to be summarized.

  • system_prompt (String) —

    A system prompt to guide the summary generation.

  • request_options (Telnyx::RequestOptions, Hash{Symbol=>Object}, nil)

Returns:

See Also:



80
81
82
83
84
85
86
87
88
89
 
# File 'lib/telnyx/resources/ai.rb', line 80

def summarize(params)
  parsed, options = Telnyx::AISummarizeParams.dump_request(params)
  @client.request(
    method: :post,
    path: "ai/summarize",
    body: parsed,
    model: Telnyx::Models::AISummarizeResponse,
    options: options
  )
end