|
|
|
"""Wrapper around OpenAI APIs."""
|
|
|
|
import logging
|
|
|
|
import sys
|
|
|
|
from typing import Any, Dict, Generator, List, Mapping, Optional, Tuple, Union
|
|
|
|
|
|
|
|
from pydantic import BaseModel, Extra, Field, root_validator
|
|
|
|
|
|
|
|
from langchain.llms.base import BaseLLM
|
|
|
|
from langchain.schema import Generation, LLMResult
|
|
|
|
from langchain.utils import get_from_dict_or_env
|
|
|
|
|
|
|
|
logger = logging.getLogger(__name__)
|
|
|
|
|
|
|
|
|
|
|
|
class BaseOpenAI(BaseLLM, BaseModel):
|
|
|
|
"""Wrapper around OpenAI large language models.
|
|
|
|
|
|
|
|
To use, you should have the ``openai`` python package installed, and the
|
|
|
|
environment variable ``OPENAI_API_KEY`` set with your API key.
|
|
|
|
|
|
|
|
Any parameters that are valid to be passed to the openai.create call can be passed
|
|
|
|
in, even if not explicitly saved on this class.
|
|
|
|
|
|
|
|
Example:
|
|
|
|
.. code-block:: python
|
|
|
|
|
|
|
|
from langchain import OpenAI
|
|
|
|
openai = OpenAI(model_name="text-davinci-003")
|
|
|
|
"""
|
|
|
|
|
|
|
|
client: Any #: :meta private:
|
|
|
|
model_name: str = "text-davinci-003"
|
|
|
|
"""Model name to use."""
|
|
|
|
temperature: float = 0.7
|
|
|
|
"""What sampling temperature to use."""
|
|
|
|
max_tokens: int = 256
|
|
|
|
"""The maximum number of tokens to generate in the completion.
|
|
|
|
-1 returns as many tokens as possible given the prompt and
|
|
|
|
the models maximal context size."""
|
|
|
|
top_p: float = 1
|
|
|
|
"""Total probability mass of tokens to consider at each step."""
|
|
|
|
frequency_penalty: float = 0
|
|
|
|
"""Penalizes repeated tokens according to frequency."""
|
|
|
|
presence_penalty: float = 0
|
|
|
|
"""Penalizes repeated tokens."""
|
|
|
|
n: int = 1
|
|
|
|
"""How many completions to generate for each prompt."""
|
|
|
|
best_of: int = 1
|
|
|
|
"""Generates best_of completions server-side and returns the "best"."""
|
|
|
|
model_kwargs: Dict[str, Any] = Field(default_factory=dict)
|
|
|
|
"""Holds any model parameters valid for `create` call not explicitly specified."""
|
|
|
|
openai_api_key: Optional[str] = None
|
|
|
|
batch_size: int = 20
|
|
|
|
"""Batch size to use when passing multiple documents to generate."""
|
|
|
|
request_timeout: Optional[Union[float, Tuple[float, float]]] = None
|
|
|
|
"""Timeout for requests to OpenAI completion API. Default is 600 seconds."""
|
|
|
|
logit_bias: Optional[Dict[str, float]] = Field(default_factory=dict)
|
|
|
|
"""Adjust the probability of specific tokens being generated."""
|
|
|
|
|
|
|
|
class Config:
|
|
|
|
"""Configuration for this pydantic object."""
|
|
|
|
|
|
|
|
extra = Extra.ignore
|
|
|
|
|
|
|
|
@root_validator(pre=True)
|
|
|
|
def build_extra(cls, values: Dict[str, Any]) -> Dict[str, Any]:
|
|
|
|
"""Build extra kwargs from additional params that were passed in."""
|
|
|
|
all_required_field_names = {field.alias for field in cls.__fields__.values()}
|
|
|
|
|
|
|
|
extra = values.get("model_kwargs", {})
|
|
|
|
for field_name in list(values):
|
|
|
|
if field_name not in all_required_field_names:
|
|
|
|
if field_name in extra:
|
|
|
|
raise ValueError(f"Found {field_name} supplied twice.")
|
|
|
|
logger.warning(
|
|
|
|
f"""WARNING! {field_name} is not default parameter.
|
|
|
|
{field_name} was transfered to model_kwargs.
|
|
|
|
Please confirm that {field_name} is what you intended."""
|
|
|
|
)
|
|
|
|
extra[field_name] = values.pop(field_name)
|
|
|
|
values["model_kwargs"] = extra
|
|
|
|
return values
|
|
|
|
|
|
|
|
@root_validator()
|
|
|
|
def validate_environment(cls, values: Dict) -> Dict:
|
|
|
|
"""Validate that api key and python package exists in environment."""
|
|
|
|
openai_api_key = get_from_dict_or_env(
|
|
|
|
values, "openai_api_key", "OPENAI_API_KEY"
|
|
|
|
)
|
|
|
|
try:
|
|
|
|
import openai
|
|
|
|
|
|
|
|
openai.api_key = openai_api_key
|
|
|
|
values["client"] = openai.Completion
|
|
|
|
except ImportError:
|
|
|
|
raise ValueError(
|
|
|
|
"Could not import openai python package. "
|
|
|
|
"Please it install it with `pip install openai`."
|
|
|
|
)
|
|
|
|
return values
|
|
|
|
|
|
|
|
@property
|
|
|
|
def _default_params(self) -> Dict[str, Any]:
|
|
|
|
"""Get the default parameters for calling OpenAI API."""
|
|
|
|
normal_params = {
|
|
|
|
"temperature": self.temperature,
|
|
|
|
"max_tokens": self.max_tokens,
|
|
|
|
"top_p": self.top_p,
|
|
|
|
"frequency_penalty": self.frequency_penalty,
|
|
|
|
"presence_penalty": self.presence_penalty,
|
|
|
|
"n": self.n,
|
|
|
|
"best_of": self.best_of,
|
|
|
|
"request_timeout": self.request_timeout,
|
|
|
|
"logit_bias": self.logit_bias,
|
|
|
|
}
|
|
|
|
return {**normal_params, **self.model_kwargs}
|
|
|
|
|
|
|
|
def _generate(
|
|
|
|
self, prompts: List[str], stop: Optional[List[str]] = None
|
|
|
|
) -> LLMResult:
|
|
|
|
"""Call out to OpenAI's endpoint with k unique prompts.
|
|
|
|
|
|
|
|
Args:
|
|
|
|
prompts: The prompts to pass into the model.
|
|
|
|
stop: Optional list of stop words to use when generating.
|
|
|
|
|
|
|
|
Returns:
|
|
|
|
The full LLM output.
|
|
|
|
|
|
|
|
Example:
|
|
|
|
.. code-block:: python
|
|
|
|
|
|
|
|
response = openai.generate(["Tell me a joke."])
|
|
|
|
"""
|
|
|
|
# TODO: write a unit test for this
|
|
|
|
params = self._invocation_params
|
|
|
|
if stop is not None:
|
|
|
|
if "stop" in params:
|
|
|
|
raise ValueError("`stop` found in both the input and default params.")
|
|
|
|
params["stop"] = stop
|
|
|
|
|
|
|
|
if params["max_tokens"] == -1:
|
|
|
|
if len(prompts) != 1:
|
|
|
|
raise ValueError(
|
|
|
|
"max_tokens set to -1 not supported for multiple inputs."
|
|
|
|
)
|
|
|
|
params["max_tokens"] = self.max_tokens_for_prompt(prompts[0])
|
|
|
|
sub_prompts = [
|
|
|
|
prompts[i : i + self.batch_size]
|
|
|
|
for i in range(0, len(prompts), self.batch_size)
|
|
|
|
]
|
|
|
|
choices = []
|
|
|
|
token_usage = {}
|
|
|
|
# Get the token usage from the response.
|
|
|
|
# Includes prompt, completion, and total tokens used.
|
|
|
|
_keys = {"completion_tokens", "prompt_tokens", "total_tokens"}
|
|
|
|
for _prompts in sub_prompts:
|
|
|
|
response = self.client.create(prompt=_prompts, **params)
|
|
|
|
choices.extend(response["choices"])
|
|
|
|
_keys_to_use = _keys.intersection(response["usage"])
|
|
|
|
for _key in _keys_to_use:
|
|
|
|
if _key not in token_usage:
|
|
|
|
token_usage[_key] = response["usage"][_key]
|
|
|
|
else:
|
|
|
|
token_usage[_key] += response["usage"][_key]
|
|
|
|
generations = []
|
|
|
|
for i, prompt in enumerate(prompts):
|
|
|
|
sub_choices = choices[i * self.n : (i + 1) * self.n]
|
|
|
|
generations.append(
|
|
|
|
[
|
|
|
|
Generation(
|
|
|
|
text=choice["text"],
|
|
|
|
generation_info=dict(
|
|
|
|
finish_reason=choice.get("finish_reason"),
|
|
|
|
logprobs=choice.get("logprobs"),
|
|
|
|
),
|
|
|
|
)
|
|
|
|
for choice in sub_choices
|
|
|
|
]
|
|
|
|
)
|
|
|
|
return LLMResult(
|
|
|
|
generations=generations, llm_output={"token_usage": token_usage}
|
|
|
|
)
|
|
|
|
|
|
|
|
def stream(self, prompt: str) -> Generator:
|
|
|
|
"""Call OpenAI with streaming flag and return the resulting generator.
|
|
|
|
|
|
|
|
BETA: this is a beta feature while we figure out the right abstraction.
|
|
|
|
Once that happens, this interface could change.
|
|
|
|
|
|
|
|
Args:
|
|
|
|
prompt: The prompts to pass into the model.
|
|
|
|
|
|
|
|
Returns:
|
|
|
|
A generator representing the stream of tokens from OpenAI.
|
|
|
|
|
|
|
|
Example:
|
|
|
|
.. code-block:: python
|
|
|
|
|
|
|
|
generator = openai.stream("Tell me a joke.")
|
|
|
|
for token in generator:
|
|
|
|
yield token
|
|
|
|
"""
|
|
|
|
params = self._invocation_params
|
|
|
|
if params["best_of"] != 1:
|
|
|
|
raise ValueError("OpenAI only supports best_of == 1 for streaming")
|
|
|
|
params["stream"] = True
|
|
|
|
generator = self.client.create(prompt=prompt, **params)
|
|
|
|
|
|
|
|
return generator
|
|
|
|
|
|
|
|
@property
|
|
|
|
def _invocation_params(self) -> Dict[str, Any]:
|
|
|
|
"""Get the parameters used to invoke the model."""
|
|
|
|
return self._default_params
|
|
|
|
|
|
|
|
@property
|
|
|
|
def _identifying_params(self) -> Mapping[str, Any]:
|
|
|
|
"""Get the identifying parameters."""
|
|
|
|
return {**{"model_name": self.model_name}, **self._default_params}
|
|
|
|
|
|
|
|
@property
|
|
|
|
def _llm_type(self) -> str:
|
|
|
|
"""Return type of llm."""
|
|
|
|
return "openai"
|
|
|
|
|
|
|
|
def get_num_tokens(self, text: str) -> int:
|
|
|
|
"""Calculate num tokens with tiktoken package."""
|
|
|
|
# tiktoken NOT supported for Python 3.8 or below
|
|
|
|
if sys.version_info[1] <= 8:
|
|
|
|
return super().get_num_tokens(text)
|
|
|
|
try:
|
|
|
|
import tiktoken
|
|
|
|
except ImportError:
|
|
|
|
raise ValueError(
|
|
|
|
"Could not import tiktoken python package. "
|
|
|
|
"This is needed in order to calculate get_num_tokens. "
|
|
|
|
"Please it install it with `pip install tiktoken`."
|
|
|
|
)
|
|
|
|
# create a GPT-3 encoder instance
|
|
|
|
enc = tiktoken.get_encoding("gpt2")
|
|
|
|
|
|
|
|
# encode the text using the GPT-3 encoder
|
|
|
|
tokenized_text = enc.encode(text)
|
|
|
|
|
|
|
|
# calculate the number of tokens in the encoded text
|
|
|
|
return len(tokenized_text)
|
|
|
|
|
|
|
|
def modelname_to_contextsize(self, modelname: str) -> int:
|
|
|
|
"""Calculate the maximum number of tokens possible to generate for a model.
|
|
|
|
|
|
|
|
text-davinci-003: 4,000 tokens
|
|
|
|
text-curie-001: 2,048 tokens
|
|
|
|
text-babbage-001: 2,048 tokens
|
|
|
|
text-ada-001: 2,048 tokens
|
|
|
|
code-davinci-002: 8,000 tokens
|
|
|
|
code-cushman-001: 2,048 tokens
|
|
|
|
|
|
|
|
Args:
|
|
|
|
modelname: The modelname we want to know the context size for.
|
|
|
|
|
|
|
|
Returns:
|
|
|
|
The maximum context size
|
|
|
|
|
|
|
|
Example:
|
|
|
|
.. code-block:: python
|
|
|
|
|
|
|
|
max_tokens = openai.modelname_to_contextsize("text-davinci-003")
|
|
|
|
"""
|
|
|
|
if modelname == "text-davinci-003":
|
|
|
|
return 4000
|
|
|
|
elif modelname == "text-curie-001":
|
|
|
|
return 2048
|
|
|
|
elif modelname == "text-babbage-001":
|
|
|
|
return 2048
|
|
|
|
elif modelname == "text-ada-001":
|
|
|
|
return 2048
|
|
|
|
elif modelname == "code-davinci-002":
|
|
|
|
return 8000
|
|
|
|
elif modelname == "code-cushman-001":
|
|
|
|
return 2048
|
|
|
|
else:
|
|
|
|
return 4000
|
|
|
|
|
|
|
|
def max_tokens_for_prompt(self, prompt: str) -> int:
|
|
|
|
"""Calculate the maximum number of tokens possible to generate for a prompt.
|
|
|
|
|
|
|
|
Args:
|
|
|
|
prompt: The prompt to pass into the model.
|
|
|
|
|
|
|
|
Returns:
|
|
|
|
The maximum number of tokens to generate for a prompt.
|
|
|
|
|
|
|
|
Example:
|
|
|
|
.. code-block:: python
|
|
|
|
|
|
|
|
max_tokens = openai.max_token_for_prompt("Tell me a joke.")
|
|
|
|
"""
|
|
|
|
num_tokens = self.get_num_tokens(prompt)
|
|
|
|
|
|
|
|
# get max context size for model by name
|
|
|
|
max_size = self.modelname_to_contextsize(self.model_name)
|
|
|
|
return max_size - num_tokens
|
|
|
|
|
|
|
|
|
|
|
|
class OpenAI(BaseOpenAI):
|
|
|
|
"""Generic OpenAI class that uses model name."""
|
|
|
|
|
|
|
|
@property
|
|
|
|
def _invocation_params(self) -> Dict[str, Any]:
|
|
|
|
return {**{"model": self.model_name}, **super()._invocation_params}
|
|
|
|
|
|
|
|
|
|
|
|
class AzureOpenAI(BaseOpenAI):
|
|
|
|
"""Azure specific OpenAI class that uses deployment name."""
|
|
|
|
|
|
|
|
deployment_name: str = ""
|
|
|
|
"""Deployment name to use."""
|
|
|
|
|
|
|
|
@property
|
|
|
|
def _identifying_params(self) -> Mapping[str, Any]:
|
|
|
|
return {
|
|
|
|
**{"deployment_name": self.deployment_name},
|
|
|
|
**super()._identifying_params,
|
|
|
|
}
|
|
|
|
|
|
|
|
@property
|
|
|
|
def _invocation_params(self) -> Dict[str, Any]:
|
|
|
|
return {**{"engine": self.deployment_name}, **super()._invocation_params}
|