mirror of
https://github.com/trustgraph-ai/trustgraph.git
synced 2026-04-25 00:16:23 +02:00
* Tidy up duplicate tech specs in doc directory * Streaming LLM text-completion service tech spec. * text-completion and prompt interfaces * streaming change applied to all LLMs, so far tested with VertexAI * Skip Pinecone unit tests, upstream module issue is affecting things, tests are passing again * Added agent streaming, not working and has broken tests
229 lines
7 KiB
Python
Executable file
229 lines
7 KiB
Python
Executable file
|
|
"""
|
|
Simple LLM service, performs text prompt completion using OpenAI.
|
|
Input is prompt, output is response.
|
|
"""
|
|
|
|
from openai import OpenAI, RateLimitError
|
|
import os
|
|
import logging
|
|
|
|
from .... exceptions import TooManyRequests
|
|
from .... base import LlmService, LlmResult, LlmChunk
|
|
|
|
# Module logger
|
|
logger = logging.getLogger(__name__)
|
|
|
|
default_ident = "text-completion"
|
|
|
|
default_model = 'gpt-3.5-turbo'
|
|
default_temperature = 0.0
|
|
default_max_output = 4096
|
|
default_api_key = os.getenv("OPENAI_TOKEN")
|
|
default_base_url = os.getenv("OPENAI_BASE_URL")
|
|
|
|
if default_base_url is None or default_base_url == "":
|
|
default_base_url = "https://api.openai.com/v1"
|
|
|
|
class Processor(LlmService):
|
|
|
|
def __init__(self, **params):
|
|
|
|
model = params.get("model", default_model)
|
|
api_key = params.get("api_key", default_api_key)
|
|
base_url = params.get("url", default_base_url)
|
|
temperature = params.get("temperature", default_temperature)
|
|
max_output = params.get("max_output", default_max_output)
|
|
|
|
if api_key is None:
|
|
raise RuntimeError("OpenAI API key not specified")
|
|
|
|
super(Processor, self).__init__(
|
|
**params | {
|
|
"model": model,
|
|
"temperature": temperature,
|
|
"max_output": max_output,
|
|
"base_url": base_url,
|
|
}
|
|
)
|
|
|
|
self.default_model = model
|
|
self.temperature = temperature
|
|
self.max_output = max_output
|
|
|
|
if base_url:
|
|
self.openai = OpenAI(base_url=base_url, api_key=api_key)
|
|
else:
|
|
self.openai = OpenAI(api_key=api_key)
|
|
|
|
logger.info("OpenAI LLM service initialized")
|
|
|
|
async def generate_content(self, system, prompt, model=None, temperature=None):
|
|
|
|
# Use provided model or fall back to default
|
|
model_name = model or self.default_model
|
|
# Use provided temperature or fall back to default
|
|
effective_temperature = temperature if temperature is not None else self.temperature
|
|
|
|
logger.debug(f"Using model: {model_name}")
|
|
logger.debug(f"Using temperature: {effective_temperature}")
|
|
|
|
prompt = system + "\n\n" + prompt
|
|
|
|
try:
|
|
|
|
resp = self.openai.chat.completions.create(
|
|
model=model_name,
|
|
messages=[
|
|
{
|
|
"role": "user",
|
|
"content": [
|
|
{
|
|
"type": "text",
|
|
"text": prompt
|
|
}
|
|
]
|
|
}
|
|
],
|
|
temperature=effective_temperature,
|
|
max_tokens=self.max_output,
|
|
)
|
|
|
|
inputtokens = resp.usage.prompt_tokens
|
|
outputtokens = resp.usage.completion_tokens
|
|
logger.debug(f"LLM response: {resp.choices[0].message.content}")
|
|
logger.info(f"Input Tokens: {inputtokens}")
|
|
logger.info(f"Output Tokens: {outputtokens}")
|
|
|
|
resp = LlmResult(
|
|
text = resp.choices[0].message.content,
|
|
in_token = inputtokens,
|
|
out_token = outputtokens,
|
|
model = model_name
|
|
)
|
|
|
|
return resp
|
|
|
|
# FIXME: Wrong exception, don't know what this LLM throws
|
|
# for a rate limit
|
|
except RateLimitError:
|
|
|
|
# Leave rate limit retries to the base handler
|
|
raise TooManyRequests()
|
|
|
|
except Exception as e:
|
|
|
|
# Apart from rate limits, treat all exceptions as unrecoverable
|
|
|
|
logger.error(f"OpenAI LLM exception ({type(e).__name__}): {e}", exc_info=True)
|
|
raise e
|
|
|
|
def supports_streaming(self):
|
|
"""OpenAI supports streaming"""
|
|
return True
|
|
|
|
async def generate_content_stream(self, system, prompt, model=None, temperature=None):
|
|
"""
|
|
Stream content generation from OpenAI.
|
|
Yields LlmChunk objects with is_final=True on the last chunk.
|
|
"""
|
|
# Use provided model or fall back to default
|
|
model_name = model or self.default_model
|
|
# Use provided temperature or fall back to default
|
|
effective_temperature = temperature if temperature is not None else self.temperature
|
|
|
|
logger.debug(f"Using model (streaming): {model_name}")
|
|
logger.debug(f"Using temperature: {effective_temperature}")
|
|
|
|
prompt = system + "\n\n" + prompt
|
|
|
|
try:
|
|
response = self.openai.chat.completions.create(
|
|
model=model_name,
|
|
messages=[
|
|
{
|
|
"role": "user",
|
|
"content": [
|
|
{
|
|
"type": "text",
|
|
"text": prompt
|
|
}
|
|
]
|
|
}
|
|
],
|
|
temperature=effective_temperature,
|
|
max_tokens=self.max_output,
|
|
stream=True # Enable streaming
|
|
)
|
|
|
|
# Stream chunks
|
|
for chunk in response:
|
|
if chunk.choices and chunk.choices[0].delta.content:
|
|
yield LlmChunk(
|
|
text=chunk.choices[0].delta.content,
|
|
in_token=None,
|
|
out_token=None,
|
|
model=model_name,
|
|
is_final=False
|
|
)
|
|
|
|
# Note: OpenAI doesn't provide token counts in streaming mode
|
|
# Send final chunk without token counts
|
|
yield LlmChunk(
|
|
text="",
|
|
in_token=None,
|
|
out_token=None,
|
|
model=model_name,
|
|
is_final=True
|
|
)
|
|
|
|
logger.debug("Streaming complete")
|
|
|
|
except RateLimitError:
|
|
logger.warning("Hit rate limit during streaming")
|
|
raise TooManyRequests()
|
|
|
|
except Exception as e:
|
|
logger.error(f"OpenAI streaming exception ({type(e).__name__}): {e}", exc_info=True)
|
|
raise e
|
|
|
|
@staticmethod
|
|
def add_args(parser):
|
|
|
|
LlmService.add_args(parser)
|
|
|
|
parser.add_argument(
|
|
'-m', '--model',
|
|
default="gpt-3.5-turbo",
|
|
help=f'LLM model (default: GPT-3.5-Turbo)'
|
|
)
|
|
|
|
parser.add_argument(
|
|
'-k', '--api-key',
|
|
default=default_api_key,
|
|
help=f'OpenAI API key'
|
|
)
|
|
|
|
parser.add_argument(
|
|
'-u', '--url',
|
|
default=default_base_url,
|
|
help=f'OpenAI service base URL'
|
|
)
|
|
|
|
parser.add_argument(
|
|
'-t', '--temperature',
|
|
type=float,
|
|
default=default_temperature,
|
|
help=f'LLM temperature parameter (default: {default_temperature})'
|
|
)
|
|
|
|
parser.add_argument(
|
|
'-x', '--max-output',
|
|
type=int,
|
|
default=default_max_output,
|
|
help=f'LLM max output tokens (default: {default_max_output})'
|
|
)
|
|
|
|
def run():
|
|
|
|
Processor.launch(default_ident, __doc__)
|