Files
semantic-kernel/python/samples/kernel-syntax-examples/google_palm_chat_with_memory.py
T
5817c2b927 Python: major features for the Kernel Arguments, Function Result and new Prompt Templating (#5077)
### Motivation and Context

<!-- 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. -->
Major work to replace the context with Kernel Arguments on the front-end
and Function Results on the back.

Updated the function decorator to a new approach, in line with dotnet.

Revamps the way function are called, allowing native functions to be
completely ignorant of SK, other then the decorator.

This also moves things into the new folder structure in sync with
dotnet.

### Description

<!-- Describe your changes, the overall approach, the underlying design.
These notes will help understanding how your code works. Thanks! -->
Adds:
- KernelArguments, a dict-like class that replaces the variables in
KernelContext. Closes #4565
- FunctionResult, a class to hold the results of function executions,
includes the function, the value and metadata, as well as two convenient
function to get the value out of it (str and get_inner_content) the
first is generic, the second specifically for KernelContent responses
(from AI services).
- AI Service Selector class, has a default, which is based on the order
in the arguments followed by the order in the functions, can be
overridden to implement your own strategy. Closes #4631
- Introduces ChatHistory and refactors the PromptTemplateConfig. Closes
#4856, #4630
- Improves parsing of templates, will now all validate during creation
and throw an error then, instead of some that do not check for validaty
until used.
- Introduces named_args block and thereby the ability to have multiple
arguments for a function call in a template. Closes #5003

Updates:
- kernel_function decorators, the parameter decorator was removed and
instead we now use Annotated to add a description of a field and we get
the type and required from the function definition.
- core plugins, use the new approach to kernel_function decorators.
- planners, template engines have all been updated to use the kernel and
kernelarguments instead of Context.
- Events have been updated, now use kernelarguments and function_result
- Tokenizers support for named_args and improvements on parsing and
checking.
- Kernel examples and notebooks to use the latest code.
- All unit and integration tests. There is more code coverage now than
before.

Removed:
- kernelContext
- kernel_function_parameter_decorator
- delegate handling code for native functions
- file_io_plugin and tests
- SemanticFunctionConfig
- ChatPromptTemplate

### 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
- [ ] I didn't break anyone 😄

---------

Co-authored-by: Evan Mattson <[email protected]>
Co-authored-by: Evan Mattson <[email protected]>
Co-authored-by: Evan Mattson <[email protected]>
2024-02-24 20:05:40 +00:00

145 lines
5.2 KiB
Python

# Copyright (c) Microsoft. All rights reserved.
import asyncio
from typing import Tuple
import semantic_kernel as sk
import semantic_kernel.connectors.ai.google_palm as sk_gp
from semantic_kernel.contents.chat_history import ChatHistory
from semantic_kernel.prompt_template.input_variable import InputVariable
kernel = sk.Kernel()
apikey = sk.google_palm_settings_from_dot_env()
palm_text_embed = sk_gp.GooglePalmTextEmbedding("models/embedding-gecko-001", apikey)
kernel.add_service(palm_text_embed)
chat_service_id = "models/chat-bison-001"
palm_chat_completion = sk_gp.GooglePalmChatCompletion(chat_service_id, apikey)
kernel.add_service(palm_chat_completion)
kernel.use_memory(storage=sk.memory.VolatileMemoryStore(), embeddings_generator=palm_text_embed)
kernel.import_plugin(sk.core_plugins.TextMemoryPlugin(), "TextMemoryPlugin")
async def populate_memory(kernel: sk.Kernel) -> None:
# Add some documents to the semantic memory
await kernel.memory.save_information("aboutMe", id="info1", text="My name is Andrea")
await kernel.memory.save_information("aboutMe", id="info2", text="I currently work as a tour guide")
await kernel.memory.save_information("aboutMe", id="info3", text="My favorite hobby is hiking")
await kernel.memory.save_information("aboutMe", id="info4", text="I visitied Iceland last year.")
await kernel.memory.save_information("aboutMe", id="info5", text="My family is from New York")
async def search_memory_examples(kernel: sk.Kernel) -> None:
questions = [
"what's my name",
"what is my favorite hobby?",
"where's my family from?",
"where did I travel last year?",
"what do I do for work",
]
for question in questions:
print(f"Question: {question}")
result = await kernel.memory.search("aboutMe", question)
print(f"Answer: {result}\n")
async def setup_chat_with_memory(
kernel: sk.Kernel,
) -> Tuple[sk.KernelFunction, sk.KernelArguments]:
"""
When using Google PaLM to chat with memories, a chat prompt template is
essential; otherwise, the kernel will send text prompts to the Google PaLM
chat service. Unfortunately, when a text prompt includes memory, chat
history, and the user's current message, PaLM often struggles to comprehend
the user's message. To address this issue, the prompt containing memory is
incorporated into the chat prompt template as a system message.
Note that this is only an issue for the chat service; the text service
does not require a chat prompt template.
"""
prompt = """
ChatBot can have a conversation with you about any topic.
It can give explicit instructions or say 'I don't know' if
it does not have an answer.
Information about me, from previous conversations:
- {{$fact1}} {{recall $fact1}}
- {{$fact2}} {{recall $fact2}}
- {{$fact3}} {{recall $fact3}}
- {{$fact4}} {{recall $fact4}}
- {{$fact5}} {{recall $fact5}}
""".strip()
req_settings = kernel.get_service(chat_service_id).get_prompt_execution_settings_class()(service_id=chat_service_id)
req_settings.max_tokens = 2000
req_settings.temperature = 0.7
req_settings.top_p = 0.8
prompt_template_config = sk.PromptTemplateConfig(
template="{{$user_input}}",
name="chat",
template_format="semantic-kernel",
input_variables=[
InputVariable(name="user_input", description="The user input", is_required=True),
InputVariable(name="chat_history", description="The history of the conversation", is_required=True),
],
execution_settings=req_settings,
)
chat_func = kernel.create_function_from_prompt(
plugin_name="chat_memory", function_name="ChatWithMemory", prompt_template_config=prompt_template_config
)
chat_history = ChatHistory()
chat_history.add_system_message(prompt)
arguments = sk.KernelArguments(
fact1="what is my name?",
fact2="what is my favorite hobby?",
fact3="where's my family from?",
fact4="where did I travel last year?",
fact5="what do I do for work?",
collection="aboutMe",
relevance=0.6,
chat_history=chat_history,
)
return chat_func, arguments
async def chat(kernel: sk.Kernel, chat_func: sk.KernelFunction, arguments: sk.KernelArguments) -> bool:
try:
user_input = input("User:> ")
except KeyboardInterrupt:
print("\n\nExiting chat...")
return False
except EOFError:
print("\n\nExiting chat...")
return False
if user_input == "exit":
print("\n\nExiting chat...")
return False
arguments["user_input"] = user_input
answer = await kernel.invoke(chat_func, arguments)
arguments["chat_history"].add_user_message(user_input)
arguments["chat_history"].add_assistant_message(str(answer))
print(f"ChatBot:> {answer}")
return True
async def main() -> None:
await populate_memory(kernel)
await search_memory_examples(kernel)
chat_func, arguments = await setup_chat_with_memory(kernel)
print("Begin chatting (type 'exit' to exit):\n")
chatting = True
while chatting:
chatting = await chat(kernel, chat_func, arguments)
if __name__ == "__main__":
asyncio.run(main())