Merge pull request #201 from MicrosoftDocs/main638745444416432359sync_temp

Repo sync for protected branch

Author: sophialagerkranspandey

semantic-kernel/Frameworks/agent/agent-architecture.md

@@ -8,10 +8,10 @@ ms.author: crickman
 ms.date: 09/13/2024
 ms.service: semantic-kernel
 ---
-# An Overview of the Agent Architecture (Experimental)
+# An Overview of the Agent Architecture
 
 > [!WARNING]
-> The _Semantic Kernel Agent Framework_ is experimental, still in development and is subject to change.
+> The *Semantic Kernel Agent Framework* is in preview and is subject to change.
 
 This article covers key concepts in the architecture of the Agent Framework, including foundational principles, design objectives, and strategic goals.
 

semantic-kernel/Frameworks/agent/agent-chat.md

@@ -8,10 +8,10 @@ ms.author: crickman
 ms.date: 09/13/2024
 ms.service: semantic-kernel
 ---
-# Exploring Agent Collaboration in _Agent Chat_ (Experimental)
+# Exploring Agent Collaboration in _Agent Chat_
 
 > [!WARNING]
-> The _Semantic Kernel Agent Framework_ is experimental, still in development and is subject to change.
+> The *Semantic Kernel Agent Framework* is in preview and is subject to change.
 
 Detailed API documentation related to this discussion is available at:
 

semantic-kernel/Frameworks/agent/agent-functions.md

@@ -8,10 +8,10 @@ ms.author: crickman
 ms.date: 09/13/2024
 ms.service: semantic-kernel
 ---
-# Configuring Agents with Semantic Kernel Plugins (Experimental)
+# Configuring Agents with Semantic Kernel Plugins
 
 > [!WARNING]
-> The _Semantic Kernel Agent Framework_ is experimental, still in development and is subject to change.
+> The *Semantic Kernel Agent Framework* is in preview and is subject to change.
 
 ## Functions and Plugins in Semantic Kernel
 
@@ -110,7 +110,7 @@ agent = ChatCompletionAgent(
     kernel=kernel, 
     name=<agent name>, 
     instructions=<agent instructions>, 
-    execution_settings=settings,
+    arguments=KernelArguments(settings=settings),
 )
 ```
 ::: zone-end
@@ -184,7 +184,7 @@ agent = ChatCompletionAgent(
     kernel=kernel, 
     name=<agent name>, 
     instructions=<agent instructions>, 
-    execution_settings=settings,
+    arguments=KernelArguments(settings=settings),
 )
 ```
 ::: zone-end

semantic-kernel/Frameworks/agent/agent-streaming.md

@@ -8,10 +8,10 @@ ms.author: crickman
 ms.date: 09/13/2024
 ms.service: semantic-kernel
 ---
-# How to Stream Agent Responses. (Experimental)
+# How to Stream Agent Responses
 
 > [!WARNING]
-> The _Semantic Kernel Agent Framework_ is experimental, still in development and is subject to change.
+> The *Semantic Kernel Agent Framework* is in preview and is subject to change.
 
 ## What is a Streamed Response?
 

semantic-kernel/Frameworks/agent/agent-templates.md

@@ -8,10 +8,10 @@ ms.author: crickman
 ms.date: 09/13/2024
 ms.service: semantic-kernel
 ---
-# Create an Agent from a Semantic Kernel Template (Experimental)
+# Create an Agent from a Semantic Kernel Template
 
 > [!WARNING]
-> The _Semantic Kernel Agent Framework_ is experimental, still in development and is subject to change.
+> The *Semantic Kernel Agent Framework* is in preview and is subject to change.
 
 ## Prompt Templates in Semantic Kernel
 
@@ -35,7 +35,10 @@ Additionally, an agent can be configured directly using a _Prompt Template Confi
 
 ::: zone pivot="programming-language-python"
 
-**Coming Soon**
+- [`prompt_template_config`](/python/api/semantic-kernel/semantic_kernel.prompt_template.prompt_template_config)
+- [`kernel_prompt_template`](/python/api/semantic-kernel/semantic_kernel.prompt_template.kernel_prompt_template)
+- [`jinja2_prompt_template`](/python/api/semantic-kernel/semantic_kernel.prompt_template.jinja2_prompt_template)
+- [`handlebars_prompt_teplate`](/python/api/semantic-kernel/semantic_kernel.prompt_template.handlebars_prompt_template)
 
 ::: zone-end
 
@@ -72,9 +75,16 @@ ChatCompletionAgent agent =
 ::: zone-end
 
 ::: zone pivot="programming-language-python"
-
-**Coming soon**
-
+```python
+kernel = Kernel()
+
+agent = ChatCompletionAgent(
+    kernel=kernel,
+    name="StoryTeller",
+    instructions="Tell a story about {{$topic}} that is {{$length}} sentences long.",
+    arguments=KernelArguments(topic="Dog", length="2"),
+)
+```
 ::: zone-end
 
 ::: zone pivot="programming-language-java"
@@ -104,9 +114,13 @@ OpenAIAssistantAgent agent =
 ::: zone-end
 
 ::: zone pivot="programming-language-python"
-
-**Coming Soon**
-
+```python
+agent = await OpenAIAssistantAgent.retrieve(
+    id=<assistant_id>,
+    kernel=Kernel(),
+    arguments=KernelArguments(topic="Dog", length="3"),
+)
+```
 ::: zone-end
 
 ::: zone pivot="programming-language-java"
@@ -162,9 +176,25 @@ ChatCompletionAgent agent =
 ::: zone-end
 
 ::: zone pivot="programming-language-python"
+```python
+import yaml
+
+# Read the YAML file
+with open("./GenerateStory.yaml", "r", encoding="utf-8") as file:
+    generate_story_yaml = file.read()
 
-**Coming Soon**
+# Parse the YAML content
+data = yaml.safe_load(generate_story_yaml)
 
+# Use the parsed data to create a PromptTemplateConfig object
+prompt_template_config = PromptTemplateConfig(**data)
+
+agent = ChatCompletionAgent(
+    kernel=_create_kernel_with_chat_completion(),
+    prompt_template_config=prompt_template_config,
+    arguments=KernelArguments(topic="Dog", length="3"),
+)
+```
 ::: zone-end
 
 ::: zone pivot="programming-language-java"
@@ -216,7 +246,24 @@ await foreach (ChatMessageContent response in agent.InvokeAsync(chat, overrideAr
 
 ::: zone pivot="programming-language-python"
 
-**Coming Soon**
+```python
+kernel = Kernel()
+
+agent = ChatCompletionAgent(
+    kernel=kernel,
+    name="StoryTeller",
+    instructions="Tell a story about {{$topic}} that is {{$length}} sentences long.",
+    arguments=KernelArguments(topic="Dog", length="2"),
+)
+
+# Create a chat history to maintain the conversation state
+chat = ChatHistory()
+
+override_arguments = KernelArguments(topic="Cat", length="3")
+
+async for response in agent.invoke(chat, arguments=override_arguments):
+    # process agent response(s)...
+```
 
 ::: zone-end
 

semantic-kernel/Frameworks/agent/assistant-agent.md

@@ -8,10 +8,10 @@ ms.author: crickman
 ms.date: 09/13/2024
 ms.service: semantic-kernel
 ---
-# Exploring the _Semantic Kernel_ _Open AI Assistant Agent_ (Experimental)
+# Exploring the _Semantic Kernel_ _Open AI Assistant Agent_
 
-> [!WARNING] 
-> The _Semantic Kernel Agent Framework_ is experimental, still in development and is subject to change.
+> [!WARNING]
+> The *Semantic Kernel Agent Framework* is in preview and is subject to change.
 
 Detailed API documentation related to this discussion is available at:
 

semantic-kernel/Frameworks/agent/chat-completion-agent.md

@@ -8,10 +8,10 @@ ms.author: crickman
 ms.date: 09/13/2024
 ms.service: semantic-kernel
 ---
-# Exploring the _Semantic Kernel_ Chat Completion Agent (Experimental)
+# Exploring the _Semantic Kernel_ Chat Completion Agent
 
-> [!WARNING] 
-> The _Semantic Kernel Agent Framework_ is experimental, still in development and is subject to change.
+> [!WARNING]
+> The *Semantic Kernel Agent Framework* is in preview and is subject to change.
 
 Detailed API documentation related to this discussion is available at:
 

semantic-kernel/Frameworks/agent/examples/example-agent-collaboration.md

@@ -8,10 +8,10 @@ ms.author: crickman
 ms.date: 09/13/2024
 ms.service: semantic-kernel
 ---
-# How-To: Coordinate Agent Collaboration using Agent Group Chat (Experimental)
+# How-To: Coordinate Agent Collaboration using Agent Group Chat
 
 > [!WARNING]
-> The _Semantic Kernel Agent Framework_ is experimental, still in development and is subject to change.
+> The *Semantic Kernel Agent Framework* is in preview and is subject to change.
 
 ## Overview
 
@@ -332,7 +332,7 @@ const string WriterName = "Writer";
 ::: zone pivot="programming-language-python"
 ```python
 REVIEWER_NAME = "Reviewer"
-WRITER_NAME = "Writer"
+COPYWRITER_NAME = "Writer"
 ```
 ::: zone-end
 
@@ -651,6 +651,7 @@ chat = AgentGroupChat(
         result_parser=lambda result: str(result.value[0]) if result.value is not None else COPYWRITER_NAME,
         agent_variable_name="agents",
         history_variable_name="history",
+        history_reducer=history_reducer,
     ),
     termination_strategy=KernelFunctionTerminationStrategy(
         agents=[agent_reviewer],
@@ -659,6 +660,7 @@ chat = AgentGroupChat(
         result_parser=lambda result: TERMINATION_KEYWORD in str(result.value[0]).lower(),
         history_variable_name="history",
         maximum_iterations=10,
+        history_reducer=history_reducer,
     ),
 )
 ```
@@ -1126,6 +1128,7 @@ from semantic_kernel.agents.strategies.termination.kernel_function_termination_s
     KernelFunctionTerminationStrategy,
 )
 from semantic_kernel.connectors.ai.open_ai.services.azure_chat_completion import AzureChatCompletion
+from semantic_kernel.contents import ChatHistoryTruncationReducer
 from semantic_kernel.contents.chat_message_content import ChatMessageContent
 from semantic_kernel.contents.utils.author_role import AuthorRole
 from semantic_kernel.functions.kernel_function_decorator import kernel_function
@@ -1229,6 +1232,8 @@ async def main():
             """,
     )
 
+    history_reducer = ChatHistoryTruncationReducer(target_count=1)
+
     chat = AgentGroupChat(
         agents=[agent_writer, agent_reviewer],
         selection_strategy=KernelFunctionSelectionStrategy(
@@ -1237,6 +1242,7 @@ async def main():
             result_parser=lambda result: str(result.value[0]) if result.value is not None else COPYWRITER_NAME,
             agent_variable_name="agents",
             history_variable_name="history",
+            history_reducer=history_reducer,
         ),
         termination_strategy=KernelFunctionTerminationStrategy(
             agents=[agent_reviewer],
@@ -1245,6 +1251,7 @@ async def main():
             result_parser=lambda result: TERMINATION_KEYWORD in str(result.value[0]).lower(),
             history_variable_name="history",
             maximum_iterations=10,
+            history_reducer=history_reducer,
         ),
     )
 

semantic-kernel/Frameworks/agent/examples/example-assistant-code.md

@@ -8,10 +8,10 @@ ms.author: crickman
 ms.date: 09/13/2024
 ms.service: semantic-kernel
 ---
-# How-To: _Open AI Assistant Agent_ Code Interpreter (Experimental)
+# How-To: _Open AI Assistant Agent_ Code Interpreter
 
 > [!WARNING]
-> The _Semantic Kernel Agent Framework_ is experimental, still in development and is subject to change.
+> The *Semantic Kernel Agent Framework* is in preview and is subject to change.
 
 ## Overview
 

semantic-kernel/Frameworks/agent/examples/example-assistant-search.md

@@ -8,10 +8,10 @@ ms.author: crickman
 ms.date: 09/13/2024
 ms.service: semantic-kernel
 ---
-# How-To: _Open AI Assistant Agent_ File Search (Experimental)
+# How-To: _Open AI Assistant Agent_ File Search 
 
 > [!WARNING]
-> The _Semantic Kernel Agent Framework_ is experimental, still in development and is subject to change.
+> The *Semantic Kernel Agent Framework* is in preview and is subject to change.
 
 ## Overview