No project description provided
Project description
OpenAI functions
The openai-functions
Python project simplifies the usage of OpenAI's function calling feature. It abstracts away the complexity of parsing function signatures and docstrings by providing developers with a clean and intuitive interface.
Installation
You can install openai-functions
from PyPI using pip:
pip install openai-functions
Usage
- Import the necessary modules:
import enum
import openai
from openai_functions import Conversation
- Create a
Conversation
instance:
conversation = Conversation()
- Define your functions using the
@conversation.add_function
decorator:
class Unit(enum.Enum):
FAHRENHEIT = "fahrenheit"
CELSIUS = "celsius"
@conversation.add_function()
def get_current_weather(location: str, unit: Unit = Unit.FAHRENHEIT) -> dict:
"""
Get the current weather in a given location.
Args:
location (str): The city and state, e.g., San Francisco, CA
unit (Unit): The unit to use, e.g. fahrenheit or celsius
Returns:
dict: A dictionary containing the current weather
"""
weather_info = {
"location": location,
"temperature": "72",
"unit": unit.value,
"forecast": ["sunny", "windy"],
}
return weather_info
- Ask the AI a question:
conversation.ask("What's the weather in San Francisco?")
Another usecase: data extraction
- Import the necessary modules:
from dataclasses import dataclass
import openai
from openai_functions import nlp
- Define your data container using the
@nlp
decorator:
@nlp
@dataclass
class Person:
"""Extract personal info"""
name: str
age: int
- Ask the AI for a summary of the data:
Person.nlp("I'm Jack and I'm 20 years old.", "Person")
How it Works
openai-functions
takes care of the following tasks:
- Parsing the function signatures and docstrings.
- Sending the conversation and function descriptions to the OpenAI model.
- Deciding whether to call a function based on the model's response.
- Calling the appropriate function with the provided arguments.
- Updating the conversation with the function response.
- Repeating the process until the model generates a user-facing message.
This abstraction allows developers to focus on defining their functions and adding user messages without worrying about the details of function calling.
Note
Please note that openai-functions
is an unofficial project not maintained by OpenAI. Use it at your discretion.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for openai_functions-0.5.3-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 59a422e1116622969da957b9239f7753577bc08491e8734740d9a378fd853bff |
|
MD5 | 29d7db0d19e2b1a77c2509a0201628e5 |
|
BLAKE2b-256 | 47a3c0e10342d02d0310488c89bcd13cd70a4fcc880e715ba043cba35ae27106 |