fix: update decorators for openai extension #280

manvkaur · 2025-05-02T23:30:39Z

This pull request refactors and enhances the Azure Functions decorators for OpenAI integrations. The changes focus on improving parameter clarity, introducing additional configuration options, and replacing ambiguous parameter names. Key updates include a breaking change with the replacement of the model parameter with more specific alternatives (chat_model, embeddings_model), the addition of new parameters for fine-tuning model behavior, and updates to method signatures and documentation.

Refactoring and Parameter Updates:

Replaced the generic model parameter with chat_model or embeddings_model across methods for improved clarity and specificity. Default values for these parameters were updated to align with their respective APIs (e.g., "gpt-3.5-turbo" for chat_model and "text-embedding-ada-002" for embeddings_model). (F22bb082L3217R3217, F22bb082L3455R3510, azure/functions/decorators/function_app.pyL3479-R3527)
Renamed connection_name to search_connection_name or store_connection_name in relevant methods to better reflect their purpose in semantic search and embeddings storage. [1] [2]

New Parameters for Model Configuration:

Introduced temperature, top_p, max_tokens, and is_reasoning_model parameters in methods like text_completion_input, assistant_post_input, and semantic_search_input. These parameters enable finer control over model behavior, including sampling randomness and reasoning capabilities. (F22bb082L3217R3217, F22bb082L3376R3435, azure/functions/decorators/function_app.pyL3479-R3527)

Documentation and Type Enhancements:

Updated method docstrings to reflect the new parameter names and their purposes, providing clearer guidance for developers. [1] [2] [3]

Codebase Simplification:

Removed unused model parameters and their associated logic from method signatures and class initializations to streamline the codebase. [1] [2]

Import Adjustments:

Added Union to imports in azure/functions/decorators/openai.py to support the new parameter type definitions.

Related extension PR - Azure/azure-functions-openai-extension#150

azure/functions/decorators/function_app.py

azure/functions/decorators/openai.py

tests/decorators/test_openai.py

azure/functions/decorators/function_app.py

update decorators for openai extension

fa8caa3

manvkaur changed the title ~~Update decorators for openai extension~~ fix: update decorators for openai extension May 2, 2025

manvkaur marked this pull request as ready for review May 2, 2025 23:34

manvkaur requested review from gavin-aguiar, hallvictoria and vrdmr as code owners May 2, 2025 23:34

manvkaur added 5 commits May 5, 2025 14:23

add commas

603d3a7

update openai file

0794adb

update casing error

8a715e6

qa validations

f848161

fix flake8 validations

c33bd76

manvkaur mentioned this pull request May 6, 2025

Update Azure.AI.OpenAI to 2.1.0 and add tests Azure/azure-functions-openai-extension#150

Merged

3 tasks

use union for acceptable type

158a42f