chore: import upstream snapshot with attribution

python/samples/concepts/functions/agent_framework_tools.py

@@ -0,0 +1,72 @@
+# Copyright (c) Microsoft. All rights reserved.
+
+import asyncio
+
+from agent_framework.openai import OpenAIResponsesClient
+
+from semantic_kernel import Kernel
+from semantic_kernel.connectors.ai.open_ai import OpenAIChatCompletion, OpenAIChatPromptExecutionSettings
+from semantic_kernel.core_plugins import TimePlugin
+from semantic_kernel.functions import KernelFunctionFromPrompt
+from semantic_kernel.prompt_template import KernelPromptTemplate, PromptTemplateConfig
+
+"""
+This example demonstrates how to create an agent framework tool from a kernel function
+that uses a prompt template with plugin functions. The tool is then used by an Agent
+Framework Agent to answer a question about the current time and date.
+
+
+This sample requires manually installing the `agent-framework-core` package.
+
+```bash
+pip install agent-framework-core --pre
+```
+or with uv:
+```bash
+uv pip install agent-framework-core --prerelease=allow
+```
+"""
+
+
+async def main():
+    kernel = Kernel()
+
+    service_id = "template_language"
+    kernel.add_service(
+        OpenAIChatCompletion(service_id=service_id),
+    )
+
+    kernel.add_plugin(TimePlugin(), "time")
+
+    function_definition = """
+    Today is: {{time.date}}
+    Current time is: {{time.time}}
+
+    Answer to the following questions using JSON syntax, including the data used.
+    Is it morning, afternoon, evening, or night (morning/afternoon/evening/night)?
+    Is it weekend time (weekend/not weekend)?
+    """
+
+    print("--- Rendered Prompt ---")
+    prompt_template_config = PromptTemplateConfig(template=function_definition)
+    prompt_template = KernelPromptTemplate(prompt_template_config=prompt_template_config)
+    rendered_prompt = await prompt_template.render(kernel, arguments=None)
+    print(rendered_prompt)
+
+    function = KernelFunctionFromPrompt(
+        description="Determine the kind of day based on the current time and date.",
+        plugin_name="TimePlugin",
+        prompt_execution_settings=OpenAIChatPromptExecutionSettings(service_id=service_id, max_tokens=100),
+        function_name="kind_of_day",
+        prompt_template=prompt_template,
+    ).as_agent_framework_tool(kernel=kernel)
+
+    print("--- Prompt Function Result ---")
+    response = await (
+        OpenAIResponsesClient(model_id="gpt-5-nano").create_agent(tools=function).run("What kind of day is it?")
+    )
+    print(response.text)
+
+
+if __name__ == "__main__":
+    asyncio.run(main())

python/samples/concepts/functions/kernel_arguments.py

@@ -0,0 +1,71 @@
+# Copyright (c) Microsoft. All rights reserved.
+
+
+import asyncio
+import datetime
+import locale
+from typing import Annotated
+
+from semantic_kernel.functions.kernel_arguments import KernelArguments
+from semantic_kernel.functions.kernel_function_decorator import kernel_function
+from semantic_kernel.kernel import Kernel
+
+# This example shows how to use kernel arguments when invoking functions.
+
+
+class StaticTextPlugin:
+    """A plugin for generating static text."""
+
+    @kernel_function(name="uppercase", description="Convert text to uppercase")
+    def uppercase(
+        self, text: Annotated[str, "The input text"]
+    ) -> Annotated[str, "The output is the text in uppercase"]:
+        """Convert text to uppercase.
+
+        Args:
+            text (str): The text to convert to uppercase.
+
+        Returns:
+            str: The text in uppercase.
+        """
+        return text.upper()
+
+    @kernel_function(name="append_day", description="Append the day variable")
+    def append_day(
+        self, input: Annotated[str, "The input text"], day: Annotated[str, "The day to append"]
+    ) -> Annotated[str, "The output is the text with the day appended"]:
+        """Append the day variable.
+
+        Args:
+            input (str): The input text to append the day to.
+            day (str): The day to append.
+
+        Returns:
+            str: The text with the day appended.
+        """
+        return f"{input} {day}"
+
+
+def get_day_of_week_for_locale():
+    """Get the day of the week for the current locale."""
+    locale.setlocale(locale.LC_TIME, "")
+    return datetime.datetime.now().strftime("%A")
+
+
+async def main():
+    kernel = Kernel()
+
+    text_plugin = kernel.add_plugin(StaticTextPlugin(), "TextPlugin")
+    arguments = KernelArguments(input="Today is:", day=get_day_of_week_for_locale())
+
+    result = await kernel.invoke(text_plugin["append_day"], arguments)
+
+    # The result returned is of type FunctionResult. Printing the result calls the __str__ method.
+    print(result)
+
+    # Note: if you need access to the result metadata, you can do the following
+    # metadata = result.metadata
+
+
+if __name__ == "__main__":
+    asyncio.run(main())