Class: Ace::LLM::Organisms::GroqClient

Inherits:
BaseClient
  • Object
show all
Defined in:
lib/ace/llm/organisms/groq_client.rb

Overview

GroqClient handles interactions with Groq’s API

Constant Summary collapse

API_BASE_URL = 
"https://api.groq.com/openai/v1"
DEFAULT_MODEL = 
"openai/gpt-oss-120b"
GENERATION_KEYS =

Generation parameters to include in API request

%i[temperature max_tokens top_p frequency_penalty presence_penalty stop].freeze
DEFAULT_GENERATION_CONFIG = 
{
  temperature: 0.7,
  max_tokens: 4096,
  top_p: nil,
  frequency_penalty: nil,
  presence_penalty: nil
}.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 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



26
27
28
 
# File 'lib/ace/llm/organisms/groq_client.rb', line 26

def self.provider_name
  "groq"
end

Instance Method Details

#generate(messages, **options) ⇒ Hash

Generate a response from Groq

Parameters:

  • messages (Array<Hash>, String) —

    Messages or prompt

  • options (Hash) —

    Generation options

Returns:

  • (Hash) —

    Response with text and metadata



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

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 Ace::LLM::ProviderError
  raise
rescue => e
  handle_api_error(e)
end