mirror of
https://github.com/microsoft/semantic-kernel.git
synced 2026-10-12 02:19:06 +00:00
Evan Mattson
4d29656780
### Motivation and Context The SK Python framework has been missing the ability to configure a chat history reducer of type `ChatHistoryTruncationReducer` and `ChatHistorySummarizationReducer` which have existed in the .Net SK Agent framework for some time. The goal of this PR is to introduce the chat history reducers and allow them for use for not only the agent framework, but also anything else that uses a chat history (chat completion, for example). The ChatHistoryReducer extends the ChatHistory class, and so it's simple to include a reducer and logic to reduce messages as one manages the chat history either in an agent framework setting or in a chat completion setting. <!-- Thank you for your contribution to the semantic-kernel repo! Please help reviewers and future users, providing the following information: 1. Why is this change required? 2. What problem does it solve? 3. What scenario does it contribute to? 4. If it fixes an open issue, please link to the issue here. --> ### Description This PR: - Introduces the chat history reducer functionality in Python -- both the `ChatHistoryTruncationReducer` and `ChatHistorySummarizationReducer`. - Add unit tests for code coverage. - Adds a sample `Chat Completion History Reducer` to show how to configure both reducers and what each parameter does. - Add chat completion samples showing how to manage a chat history reducer, including how to specify that function call content and function result content should be part of the summarization payload. - Updates the Agent SelectionStrategy, KernelFunctionSelectionStrategy and KernelFunctionTermination strategy to use the reducer. - Additionally updates the classes above to use a new `select_agent` abstract method so that one can define an initial agent to run in a particular scenario. - Removes the deprecated `FunctionCallBehavior` class, and removes some nasty circular dependencies that we had lurking in the code base for some time. This `FunctionCallBehavior` has been marked with a deprecation warning for 6+ months now. All samples and docs have moved over to use `FunctionChoiceBehavior` - developers using `FunctionCallBehavior` should have had enough time to switch. - Closes #7969 - Closes #10102 <!-- Describe your changes, the overall approach, the underlying design. These notes will help understanding how your code works. Thanks! --> ### Contribution Checklist <!-- Before submitting this PR, please make sure: --> - [X] The code builds clean without any errors or warnings - [X] The PR follows the [SK Contribution Guidelines](https://github.com/microsoft/semantic-kernel/blob/main/CONTRIBUTING.md) and the [pre-submission formatting script](https://github.com/microsoft/semantic-kernel/blob/main/CONTRIBUTING.md#development-scripts) raises no violations - [X] All unit tests pass, and I have added new tests where possible - [X] I didn't break anyone 😄
57 lines
1.2 KiB
Python
57 lines
1.2 KiB
Python
# Copyright (c) Microsoft. All rights reserved.
|
|
|
|
from semantic_kernel.exceptions.kernel_exceptions import KernelException
|
|
|
|
|
|
class ContentException(KernelException):
|
|
"""Base class for all content exceptions."""
|
|
|
|
pass
|
|
|
|
|
|
class ContentInitializationError(ContentException):
|
|
"""An error occurred while initializing the content."""
|
|
|
|
pass
|
|
|
|
|
|
class ContentSerializationError(ContentException):
|
|
"""An error occurred while serializing the content."""
|
|
|
|
pass
|
|
|
|
|
|
class ContentAdditionException(ContentException):
|
|
"""An error occurred while adding content."""
|
|
|
|
pass
|
|
|
|
|
|
class FunctionCallInvalidNameException(ContentException):
|
|
"""An error occurred while validating the function name."""
|
|
|
|
pass
|
|
|
|
|
|
class FunctionCallInvalidArgumentsException(ContentException):
|
|
"""An error occurred while validating the function arguments."""
|
|
|
|
pass
|
|
|
|
|
|
class ChatHistoryReducerException(ContentException):
|
|
"""An error occurred while reducing chat history."""
|
|
|
|
pass
|
|
|
|
|
|
__all__ = [
|
|
"ChatHistoryReducerException",
|
|
"ContentAdditionException",
|
|
"ContentException",
|
|
"ContentInitializationError",
|
|
"ContentSerializationError",
|
|
"FunctionCallInvalidArgumentsException",
|
|
"FunctionCallInvalidNameException",
|
|
]
|