Class: Ace::LLM::Organisms::XAIClient

Inherits:
BaseClient
  • Object
show all
Includes:
Molecules::OpenAICompatibleParams
Defined in:
lib/ace/llm/organisms/xai_client.rb

Overview

XAIClient handles interactions with x.ai’s API

Constant Summary collapse

API_BASE_URL = 
"https://api.x.ai"
DEFAULT_MODEL = 
"grok-4"
DEFAULT_GENERATION_CONFIG = 
{
  temperature: 0.7,
  max_tokens: 4096,
  top_p: nil,
  frequency_penalty: nil,
  presence_penalty: nil
}.freeze
GENERATION_KEYS =

Generation parameters to include in API request

%i[temperature max_tokens top_p frequency_penalty presence_penalty].freeze

Constants inherited from BaseClient

BaseClient::DEFAULT_SYSTEM_PROMPT_SEPARATOR

Instance Attribute Summary

Attributes inherited from BaseClient

#api_key, #base_url, #generation_config, #http_client, #model

Class Method Summary collapse

Instance Method Summary collapse

Methods included from Molecules::OpenAICompatibleParams

#extract_openai_compatible_options

Methods inherited from BaseClient

#initialize, #needs_credentials?, #provider_name

Constructor Details

This class inherits a constructor from Ace::LLM::Organisms::BaseClient

Class Method Details

.provider_name ⇒ String

Get the provider name

Returns:

  • (String) —

    Provider name



28
29
30
 
# File 'lib/ace/llm/organisms/xai_client.rb', line 28

def self.provider_name
  "xai"
end

Instance Method Details

#generate(messages, **options) ⇒ Hash

Generate a response from x.ai

Parameters:

  • messages (Array<Hash>, String) —

    Messages or prompt

  • options (Hash) —

    Generation options

Returns:

  • (Hash) —

    Response with text and metadata



36
37
38
39
40
41
42
43
44
45
46
 
# File 'lib/ace/llm/organisms/xai_client.rb', line 36

def generate(messages, **options)
  messages_array = build_messages(messages)
  generation_params = extract_generation_options(options)

  request_body = build_request_body(messages_array, generation_params)
  response = make_api_request(request_body)

  parse_response(response)
rescue => e
  handle_api_error(e)
end